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

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

Sintaxis

# 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 - de suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

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

azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Obligatorio 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 (autenticación de SQL Server), 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 la base de datos. Puede ser una instancia de SQL Server, Active Directory (integrada), 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 el contexto actual de su cuenta de Active Directory.

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, la cadena de conexión de SQL Server, la autenticación de AD (contraseña o integrada) o usar una entidad de servicio. Para la autenticación de SQL Server, use las credenciales de usuario de SQL Server. Para la autenticación de AD, use las credenciales del usuario de AD configurado en SQL Server.

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

Especifica el nombre de Azure SQL Server, como Fabrikam.database.windows.net.placeholder,1433 o Fabrikam.database.windows.net.placeholder.

DatabaseName - Database
string. Obligatorio cuando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

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

SqlUsername - inicio de sesión
string. Obligatorio cuando AuthenticationType = server.

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

de contraseña de SqlPassword -
string. Obligatorio 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 como $(passwordVariable) se aceptan. Puede marcar el tipo de variable como secret para protegerlo.

aadSqlUsername - inicio de sesión
string. Obligatorio cuando AuthenticationType = aadAuthenticationPassword.

Especifica el nombre de usuario de Active Directory.

de contraseña de aadSqlPassword -
string. Obligatorio cuando AuthenticationType = aadAuthenticationPassword.

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

ConnectionString - cadena de conexión
string. Obligatorio cuando AuthenticationType = connectionString.

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

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

DeploymentAction - acción
string. Obligatorio cuando TaskNameSelector = DacpacTask. Valores permitidos: Publish, Extract, Export, Import, Script, DriftReport (informe de desfase), DeployReport (implementar informe). Valor predeterminado: Publish.

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

de archivos DACPAC de DacpacFile -
string. Obligatorio 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 accesible para el agente de automatización, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. También se pueden usar variables del sistema predefinidas, como $(agent.releaseDirectory).

de archivos BACPAC de BacpacFile -
string. Obligatorio cuando DeploymentAction = Import.

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

de script SQL de SqlFile -
string. Obligatorio 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 accesible para el agente de automatización, como \\BudgetIT\Web\Deploy\FabrikamDB.sql. También se pueden usar variables del sistema predefinidas, como $(agent.releaseDirectory).

SqlInline - script SQL insertado
string. Obligatorio cuando TaskNameSelector = InlineSqlTask.

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

PublishProfile - de perfil de publicación
string. Opcional. Use cuando TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Proporciona un control específico sobre la creación o actualización de bases de datos de Azure SQL.
Especifica la ruta de acceso al archivo XML de 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 el archivos seguros biblioteca 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 del 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 de SqlPackage.exe adicionales 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 en el 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 dada 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 determinada en Azure SQL Database, como -ConnectionTimeout 100 -OutputSqlErrors.

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

Para que se ejecute la tarea, se debe agregar la dirección IP del agente de automatización al Direcciones IP permitidas en el firewall de Azure SQL Server. 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 - inicio de la dirección IP
string. Obligatorio 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. Obligatorio 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 de Azure SQL Server.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte 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
La ruta de acceso del archivo de salida generada cuando la acción del paquete de implementación es Extract, Export, Script, DriftReporto DeployReport.

Observaciones

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 intenta usar la autenticación integrada de Azure Active Directory (Azure AD), debe crear un agente privado. No se admite la autenticación integrada de Azure AD para agentes hospedados.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente
demandas	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes exigen ejecutar trabajos que usen esta tarea: sqlpackage
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	1.103.0 o superior
Categoría de tarea	Desplegar