SqlAzureDacpacDeployment@1 – tarefa de implementação da Base de Dados do SQL do Azure v1

Utilize esta tarefa para implementar uma Base de Dados SQL do Azure com DACPAC ou executar scripts com o 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 Ligação de Serviço do Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valor predefinido: ConnectedServiceNameARM.

azureClassicSubscription - Subscrição Clássica do Azure
Alias de entrada: ConnectedServiceName. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Especifica a subscrição clássica do Azure de destino para implementar ficheiros SQL.

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceNameARM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifica a subscrição do Azure Resource Manager de destino para implementar ficheiros SQL.

AuthenticationType - Tipo de Autenticação
string. Obrigatório. Valores permitidos: server (SQL Server Autenticação), aadAuthenticationPassword (Active Directory - Palavra-passe), aadAuthenticationIntegrated (Active Directory - Integrado), connectionString (Cadeia de Ligação) servicePrincipal (Principal de Serviço). Valor predefinido: server.

Especifica o tipo de autenticação de base de dados. Pode ser uma autenticação SQL Server, Active Directory (integrada), Active Directory (palavra-passe), cadeia de ligação ou principal de serviço. A autenticação integrada significa que o agente acede à base de dados com o contexto atual da conta do Active Directory.

Especifique a opção para ligar à base de dados do SQL do Azure Server. Pode fornecer os detalhes da base de dados do SQL do Azure Server, a SQL Server cadeia de ligação, a Autenticação do AD (palavra-passe ou integrada) ou utilizar um principal de serviço. Para SQL Server autenticação, utilize as credenciais de utilizador do SQL Server. Para autenticação do AD, utilize as credenciais para o utilizador do AD configurado para o SQL Server.

ServerName - SQL do Azure Server
string. Necessário quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Especifica o SQL do Azure Nome do servidor, como Fabrikam.database.windows.net,1433 ou Fabrikam.database.windows.net.

DatabaseName - Base de dados
string. Necessário quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Especifica o nome da base de dados SQL do Azure onde os ficheiros são implementados.

SqlUsername - Iniciar sessão
string. Necessário quando AuthenticationType = server.

Especifica o início de sessão de administrador do SQL do Azure Server.

SqlPassword - Palavra-passe
string. Necessário quando AuthenticationType = server.

Especifica a palavra-passe do administrador do SQL do Azure Server. Variáveis definidas nos pipelines de compilação ou versão conforme $(passwordVariable) são aceites. Pode marcar o tipo de variável como secret para protegê-lo.

aadSqlUsername - Iniciar sessão
string. Necessário quando AuthenticationType = aadAuthenticationPassword.

Especifica o nome de utilizador do Active Directory.

aadSqlPassword - Palavra-passe
string. Necessário quando AuthenticationType = aadAuthenticationPassword.

Especifica a palavra-passe do utilizador do Active Directory. Variáveis definidas nos pipelines de compilação ou versão conforme $(passwordVariable) são aceites. Pode marcar o tipo de variável como secret para protegê-lo.

ConnectionString - Cadeia de Ligação
string. Necessário quando AuthenticationType = connectionString.

Especifica o cadeia de ligação SQL do Azure Server, como Server=testServer.database.windows.net;Database=testdb;User ID=AccountPlaceholder;Password=$(securePassword);.

deployType - Tipo de implementação
Alias de entrada: TaskNameSelector. string. Obrigatório. Valores permitidos: DacpacTask (Ficheiro DACPAC do SQL), SqlTask (Ficheiro de Script SQL), InlineSqlTask (Script SQL Inline). Valor predefinido: DacpacTask.

DeploymentAction - Ação
string. Necessário quando TaskNameSelector = DacpacTask. Valores permitidos: Publish, Extract, Export, Import, DriftReportScript(Relatório de Desvio), DeployReport (Implementar Relatório). Valor predefinido: Publish.

Especifica uma das ações SQL da lista. Saiba mais sobre a lista de ações do SQL.

DacpacFile - Ficheiro DACPAC
string. Necessário quando DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Especifica a localização do ficheiro DACPAC no agente de automatização ou num caminho UNC acessível ao agente de automatização, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. As variáveis de sistema predefinidas, como $(agent.releaseDirectory), também podem ser utilizadas.

BacpacFile - Ficheiro BACPAC
string. Necessário quando DeploymentAction = Import.

Especifica a localização do ficheiro BACPAC no agente de automatização ou num caminho UNC acessível ao agente de automatização, como \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. As variáveis de sistema predefinidas, como $(agent.releaseDirectory), também podem ser utilizadas.

SqlFile - SQL Script
string. Necessário quando TaskNameSelector = SqlTask.

Especifica a localização do ficheiro de script do SQL no agente de automatização ou num caminho UNC acessível ao agente de automatização, como \\BudgetIT\Web\Deploy\FabrikamDB.sql. As variáveis de sistema predefinidas, como $(agent.releaseDirectory), também podem ser utilizadas.

SqlInline - Inline SQL Script
string. Necessário quando TaskNameSelector = InlineSqlTask.

Especifica o script SQL a executar na base de dados selecionada anteriormente.

PublishProfile - Publicar Perfil
string. Opcional. Utilize quando TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Fornece controlo detalhado sobre SQL do Azure criação ou atualizações de bases de dados.
Especifica o caminho para o ficheiro XML do perfil de publicação no computador do agente de automatização ou numa partilha UNC. Se o perfil de publicação contiver segredos, como credenciais, carregue-o para a biblioteca de ficheiros seguros onde é armazenado com encriptação em segurança. Em seguida, utilize a tarefa Transferir ficheiro seguro no início do pipeline para transferi-lo para o computador do agente quando o pipeline for executado. Elimine-o quando o pipeline estiver concluído. As variáveis de sistema predefinidas, como $(agent.buildDirectory) ou $(agent.releaseDirectory), também podem ser utilizadas.

AdditionalArguments - Argumentos SqlPackage.exe Adicionais
string. Opcional. Utilize quando TaskNameSelector = DacpacTask || DeploymentAction = Extract || DeploymentAction = Export || DeploymentAction = Import || DeploymentAction = Script || DeploymentAction = DeployReport || DeploymentAction = DriftReport.

Especifica os argumentos adicionais SqlPackage.exe que serão aplicados ao implementar a base de dados SQL do Azure se a opção DACPAC estiver selecionada, como /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Estes argumentos substituirão as definições no ficheiro XML de perfil de publicação (se for fornecido).

SqlAdditionalArguments - Argumentos Invoke-Sqlcmd Adicionais
string. Opcional. Utilize quando TaskNameSelector = SqlTask.

Especifica os argumentos de Invoke-Sqlcmd adicionais que são aplicados ao executar a consulta SQL especificada na base de dados SQL do Azure, como -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Argumentos Invoke-Sqlcmd Adicionais
string. Opcional. Utilize quando TaskNameSelector = InlineSqlTask.

Especifica os argumentos de Invoke-Sqlcmd adicionais que são aplicados ao executar a consulta SQL especificada na Base de Dados SQL do Azure, como -ConnectionTimeout 100 -OutputSqlErrors.

IpDetectionMethod - Especificar Regras de Firewall com
string. Obrigatório. Valores permitidos: AutoDetect, IPAddressRange. Valor predefinido: AutoDetect.

Para que a tarefa seja executada, o endereço IP do agente de automatização tem de ser adicionado aos Endereços IP Permitidos na firewall do SQL do Azure Server. Selecione deteção automática para adicionar automaticamente a exceção de firewall para o intervalo do possível endereço IP do agente de automatização ou especifique explicitamente o intervalo.

StartIpAddress - Endereço IP Inicial
string. Necessário quando IpDetectionMethod = IPAddressRange.

Especifica o endereço IP inicial do conjunto de máquinas do agente de automatização, como 196.21.30.50.

EndIpAddress - Endereço IP Final
string. Necessário quando IpDetectionMethod = IPAddressRange.

Especifica o endereço IP final do conjunto de máquinas do agente de automatização, como 196.21.30.65.

DeleteFirewallRule - Eliminar Regra Após o Fim da Tarefa
boolean. Valor predefinido: true.

Se selecionada, após o fim da tarefa, os endereços IP especificados aqui são eliminados da lista Endereços IP Permitidos na firewall do SQL do Azure Server.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

SqlDeploymentOutputFile
O caminho do ficheiro de saída gerado quando a ação do pacote de implementação é Extract, Export, Script, DriftReportou DeployReport.

Observações

Utilize esta tarefa para implementar uma base de dados SQL do Azure com um DACPAC ou executar scripts com o SQLCMD.

Importante

Esta tarefa só é suportada num ambiente windows. Se estiver a tentar utilizar a autenticação integrada Azure Active Directory (AAD), terá de criar um agente privado. A autenticação integrada AAD não é suportada nos agentes alojados.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: sqlpackage
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.103.0 ou superior
Categoria da tarefa	Implementação