SqlPackage.exe

SqlPackage.exe es una utilidad de línea de comandos que automatiza las siguientes tareas de desarrollo de base de datos:

• Versión: devuelve el número de compilación de la aplicación SqlPackage. Se agregó en la versión 18.6.

• Extract: crea un archivo de aplicación de capa de datos (.dacpac) que contiene el esquema o el esquema y los datos de usuario de una base de datos SQL conectada.

• Publicar: actualiza de forma incremental un esquema de la base de datos para coincidir con el esquema de un archivo .dacpac de origen. Si no existe la base de datos en el servidor, la operación de publicación la crea. De lo contrario, se actualiza una base de datos existente.

• Export: exporta una base de datos SQL conectada, incluidos el esquema de la base de datos y los datos de usuario, a un archivo BACPAC (.bacpac).

• Import: importa el esquema y los datos de tabla de un archivo BACPAC en una nueva base de datos de usuario.

• DeployReport: crea un informe XML de los cambios que realizaría una acción de publicación.

• DriftReport: crea un informe XML de los cambios que se han realizado en una base de datos registrada desde que se registró por última vez.

• Script: crea un script de actualización incremental de Transact-SQL que actualiza el esquema de un destino para que coincida con el esquema de un origen.

La herramienta de línea de comandos SqlPackage.exe permite especificar estas acciones junto con parámetros y propiedades específicos de cada acción.

Descargar la última versión . Para más información sobre la última versión, consulte las notas de la versión.

Sintaxis de línea de comandos

SqlPackage.exe inicia las acciones especificadas usando los parámetros, las propiedades y las variables de SQLCMD especificadas en la línea de comandos.

SqlPackage {parameters}{properties}{SQLCMD Variables}  

Ejemplos de uso

Generación de una comparación entre las bases de datos mediante archivos .dacpac con una salida de script SQL

Empiece por crear un archivo .dacpac de los cambios de la base de datos más recientes:

sqlpackage.exe /TargetFile:"C:\sqlpackageoutput\output_current_version.dacpac" /Action:Extract /SourceServerName:"." /SourceDatabaseName:"Contoso.Database"

Cree un archivo .dacpac del destino de la base de datos (sin cambios):

sqlpackage.exe /TargetFile:"C:\sqlpackageoutput\output_target.dacpac" /Action:Extract /SourceServerName:"." /SourceDatabaseName:"Contoso.Database"

Cree un script SQL que genere las diferencias de dos archivos .dacpac:

sqlpackage.exe /Action:Script /SourceFile:"C:\sqlpackageoutput\output_current_version.dacpac" /TargetFile:"C:\sqlpackageoutput\output_target.dacpac" /TargetDatabaseName:"Contoso.Database" /OutputPath:"C:\sqlpackageoutput\output.sql"

Versión

Muestra la versión de sqlpackage como un número de compilación. Se puede usar en solicitudes interactivas o en canalizaciones automatizadas.

sqlpackage.exe /Version

Ayuda

Puede mostrar la información de uso de sqlpackage mediante /? o /help:True.

sqlpackage.exe /?

Para obtener información acerca de propiedades y parámetros específicos de una acción determinada, use el parámetro de ayuda además del parámetro de esa acción.

sqlpackage.exe /Action:Publish /?

Códigos de salida

Comandos que devuelven los siguientes códigos de salida:

• 0 = success
• distinto de cero = error

Parámetros

Algunos parámetros se comparten entre las acciones de SqlPackage. A continuación se muestra una tabla que resume los parámetros. Para más información, haga clic en las páginas de acción específicas.

Propiedades

Algunas propiedades se comparten entre las acciones de SqlPackage. A continuación se muestra una tabla que resume las propiedades. Para más información, haga clic en las páginas de acción específicas.

Pasos siguientes

• Mas información sobre Extract de SqlPackage
• Mas información sobre Publish de SqlPackage
• Mas información sobre Export de SqlPackage
• Mas información sobre Import de SqlPackage