SqlAzureDacpacDeployment@1: tarea de implementación de Azure SQL Database v1

Use esta tarea para implementar una base de datos de Azure SQL mediante DACPAC o ejecutar scripts mediante SQLCMD.

Syntax

# Azure SQL Database deployment v1
# Deploy an Azure SQL Database using DACPAC or run scripts using SQLCMD.
- task: SqlAzureDacpacDeployment@1
  inputs:
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Service Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
  # SQL Database
    AuthenticationType: 'server' # 'server' | 'aadAuthenticationPassword' | 'aadAuthenticationIntegrated' | 'connectionString' | 'servicePrincipal'. Required. Authentication Type. Default: server.
    #ServerName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Azure SQL Server. 
    #DatabaseName: # string. Required when AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal. Database. 
    SqlUsername: # string. Required when AuthenticationType = server. Login. 
    SqlPassword: # string. Required when AuthenticationType = server. Password. 
    #aadSqlUsername: # string. Required when AuthenticationType = aadAuthenticationPassword. Login. 
    #aadSqlPassword: # string. Required when AuthenticationType = aadAuthenticationPassword. Password. 
    #ConnectionString: # string. Required when AuthenticationType = connectionString. Connection String. 
  # Deployment Package
    deployType: 'DacpacTask' # 'DacpacTask' | 'SqlTask' | 'InlineSqlTask'. Alias: TaskNameSelector. Required. Deploy type. Default: DacpacTask.
    DeploymentAction: 'Publish' # 'Publish' | 'Extract' | 'Export' | 'Import' | 'Script' | 'DriftReport' | 'DeployReport'. Required when TaskNameSelector = DacpacTask. Action. Default: Publish.
    #DacpacFile: # string. Required when DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport. DACPAC File. 
    #BacpacFile: # string. Required when DeploymentAction = Import. BACPAC File. 
    #SqlFile: # string. Required when TaskNameSelector = SqlTask. SQL Script. 
    #SqlInline: # string. Required when TaskNameSelector = InlineSqlTask. Inline SQL Script. 
    #PublishProfile: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport. Publish Profile. 
    #AdditionalArguments: # string. Optional. Use when TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport. Additional SqlPackage.exe Arguments. 
    #SqlAdditionalArguments: # string. Optional. Use when TaskNameSelector = SqlTask. Additional Invoke-Sqlcmd Arguments. 
    #InlineAdditionalArguments: # string. Optional. Use when TaskNameSelector = InlineSqlTask. Additional Invoke-Sqlcmd Arguments. 
  # Firewall
    IpDetectionMethod: 'AutoDetect' # 'AutoDetect' | 'IPAddressRange'. Required. Specify Firewall Rules Using. Default: AutoDetect.
    #StartIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. Start IP Address. 
    #EndIpAddress: # string. Required when IpDetectionMethod = IPAddressRange. End IP Address. 
    #DeleteFirewallRule: true # boolean. Delete Rule After Task Ends. Default: true.

Entradas

azureConnectionType - Tipo de conexión de servicio de Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure clásico), ConnectedServiceNameARM (Azure Resource Manager). Valor predeterminado: ConnectedServiceNameARM.

azureClassicSubscription - Suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName.

Especifica la suscripción de Azure clásica de destino para implementar archivos SQL.

azureSubscription - Suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifica la suscripción de Azure Resource Manager de destino para implementar archivos SQL.

AuthenticationType - Tipo de autenticación
string. Obligatorio. Valores permitidos: server (SQL Server Autenticación), aadAuthenticationPassword (Active Directory - Contraseña), aadAuthenticationIntegrated (Active Directory - Integrado), connectionString (Cadena de conexión), servicePrincipal (Entidad de servicio). Valor predeterminado: server.

Especifica el tipo de autenticación de base de datos. Puede ser un SQL Server, Active Directory (integrado), Active Directory (contraseña), cadena de conexión o autenticación de entidad de servicio. La autenticación integrada significa que el agente accede a la base de datos mediante su contexto de cuenta de Active Directory actual.

Especifique la opción para conectarse a la base de datos de Azure SQL Server. Puede proporcionar los detalles de la base de datos de Azure SQL Server, el SQL Server cadena de conexión, la autenticación de AD (contraseña o integrada) o usar una entidad de servicio. Para SQL Server autenticación, use las credenciales de usuario del SQL Server. Para la autenticación de AD, use las credenciales del usuario de AD configurado en el SQL Server.

ServerName - Azure SQL Server
string. Necesario cuando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Especifica el nombre del servidor de Azure SQL, como Fabrikam.database.windows.net,1433 o Fabrikam.database.windows.net.

DatabaseName - Base
string. Necesario cuando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Especifica el nombre de la base de datos Azure SQL donde se implementan los archivos.

SqlUsername - Iniciar sesión
string. Necesario cuando AuthenticationType = server.

Especifica el inicio de sesión de administrador de Azure SQL Server.

SqlPassword - Contraseña
string. Necesario cuando AuthenticationType = server.

Especifica la contraseña del administrador de Azure SQL Server. Las variables definidas en las canalizaciones de compilación o versión tal como $(passwordVariable) se aceptan. Puede marcar el tipo de variable como secret para protegerlo.

aadSqlUsername - Iniciar sesión
string. Necesario cuando AuthenticationType = aadAuthenticationPassword.

Especifica el nombre de usuario de Active Directory.

aadSqlPassword - Contraseña
string. Necesario cuando AuthenticationType = aadAuthenticationPassword.

Especifica la contraseña del usuario de Active Directory. Las variables definidas en las canalizaciones de compilación o versión tal como $(passwordVariable) se aceptan. Puede marcar el tipo de variable como secret para protegerlo.

ConnectionString - Cadena de conexión
string. Necesario cuando AuthenticationType = connectionString.

Especifica el cadena de conexión de servidor de Azure SQL, como Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Tipo de implementación
Alias de entrada: TaskNameSelector. string. Obligatorio. Valores permitidos: DacpacTask (archivo SQL DACPAC), SqlTask (archivo de script de SQL), InlineSqlTask (script SQL insertado). Valor predeterminado: DacpacTask.

DeploymentAction - Acción
string. Necesario cuando TaskNameSelector = DacpacTask. Valores permitidos: , , , , , ScriptDriftReport (Informe de desfase), DeployReport (Implementar informe). ImportExportExtractPublish Valor predeterminado: Publish.

Especifica una de las acciones sql de la lista. Obtenga más información sobre la lista de acciones de SQL.

DacpacFile - Archivo DACPAC
string. Necesario cuando DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Especifica la ubicación del archivo DACPAC en el agente de automatización o en una ruta de acceso UNC a la que se puede acceder al agente de automatización, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. También se pueden usar variables de sistema predefinidas, como $(agent.releaseDirectory), .

BacpacFile - Archivo BACPAC
string. Necesario cuando DeploymentAction = Import.

Especifica la ubicación del archivo BACPAC en el agente de automatización o en una ruta de acceso UNC a la que se puede acceder al agente de automatización, como \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. También se pueden usar variables de sistema predefinidas, como $(agent.releaseDirectory), .

SqlFile - SQL Script
string. Necesario cuando TaskNameSelector = SqlTask.

Especifica la ubicación del archivo de script SQL en el agente de automatización o en una ruta de acceso UNC a la que se puede acceder al agente de automatización, como \\BudgetIT\Web\Deploy\FabrikamDB.sql. También se pueden usar variables de sistema predefinidas, como $(agent.releaseDirectory), .

SqlInline - Script SQL insertado
string. Necesario cuando TaskNameSelector = InlineSqlTask.

Especifica el script SQL que se va a ejecutar en la base de datos seleccionada anteriormente.

PublishProfile - Publicar perfil
string. Opcional. Use cuando TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Proporciona un control específico sobre Azure SQL creación o actualización de la base de datos.
Especifica la ruta de acceso al archivo XML del perfil de publicación en la máquina del agente de automatización o en un recurso compartido UNC. Si el perfil de publicación contiene secretos, como las credenciales, cárguelo en la biblioteca de archivos seguros donde se almacena de forma segura con cifrado. A continuación, use la tarea Descargar archivo seguro al principio de la canalización para descargarlo en el equipo del agente cuando se ejecuta la canalización. Elimínelo cuando se complete la canalización. También se pueden usar variables de sistema predefinidas, como $(agent.buildDirectory) o $(agent.releaseDirectory).

AdditionalArguments - Argumentos de SqlPackage.exe adicionales
string. Opcional. Use cuando TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Especifica los argumentos adicionales SqlPackage.exe que se aplicarán al implementar la base de datos de Azure SQL si se selecciona la opción DACPAC, como /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Estos argumentos invalidarán la configuración del archivo XML del perfil de publicación (si se proporciona).

SqlAdditionalArguments - Argumentos de Invoke-Sqlcmd adicionales
string. Opcional. Use cuando TaskNameSelector = SqlTask.

Especifica los argumentos de Invoke-Sqlcmd adicionales que se aplican al ejecutar la consulta SQL especificada en la base de datos de Azure SQL, como -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Argumentos de Invoke-Sqlcmd adicionales
string. Opcional. Use cuando TaskNameSelector = InlineSqlTask.

Especifica los argumentos de Invoke-Sqlcmd adicionales que se aplican al ejecutar la consulta SQL especificada en la base de datos de Azure SQL, como -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Especificación de reglas de firewall mediante
string. Obligatorio. Valores permitidos: AutoDetect, IPAddressRange. Valor predeterminado: AutoDetect.

Para que se ejecute la tarea, la dirección IP del agente de automatización debe agregarse a las direcciones IP permitidas en el firewall del servidor de Azure SQL. Seleccione Detección automática para agregar automáticamente la excepción de firewall para el intervalo de la posible dirección IP del agente de automatización o especificar el intervalo explícitamente.

StartIpAddress - Iniciar dirección IP
string. Necesario cuando IpDetectionMethod = IPAddressRange.

Especifica la dirección IP inicial del grupo de máquinas del agente de automatización, como 196.21.30.50.

EndIpAddress - Dirección IP final
string. Necesario cuando IpDetectionMethod = IPAddressRange.

Especifica la dirección IP final del grupo de máquinas del agente de automatización, como 196.21.30.65.

DeleteFirewallRule - Eliminar regla después de que finalice la tarea
boolean. Valor predeterminado: true.

Si se selecciona, una vez finalizada la tarea, las direcciones IP especificadas aquí se eliminan de la lista Direcciones IP permitidas en el firewall del servidor de Azure SQL.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Esta tarea define las siguientes variables de salida, que puede consumir en pasos, trabajos y fases de bajada.

SqlDeploymentOutputFile
Ruta de acceso del archivo de salida generada cuando la acción del paquete de implementación es Extract, ExportScript, DriftReport, o DeployReport.

Comentarios

Use esta tarea para implementar una base de datos de Azure SQL mediante un DACPAC o ejecutar scripts mediante SQLCMD.

Importante

Esta tarea solo se admite en un entorno de Windows. Si está intentando usar la autenticación integrada de Azure Active Directory (Azure AD), debe crear un agente privado. La autenticación integrada de Azure AD no se admite con agentes hospedados.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: sqlpackage
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.103.0 o superior
Categoría de la tarea:	Implementación