SqlAzureDacpacDeployment@1 – tarefa de implantação do Banco de Dados SQL do Azure v1

Use essa tarefa para implantar um Banco de Dados SQL do Azure usando DACPAC ou executar scripts usando 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 conexão de serviço do Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Clássico do Azure) ConnectedServiceNameARM (Azure Resource Manager). Valor padrão: ConnectedServiceNameARM.

azureClassicSubscription - Assinatura clássica do Azure
Alias de entrada: ConnectedServiceName. string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceName.

Especifica a assinatura clássica do Azure de destino para implantar arquivos SQL.

azureSubscription - Assinatura do Azure
Alias de entrada: ConnectedServiceNameARM. string. Obrigatório quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifica a assinatura de destino do Azure Resource Manager para implantar arquivos SQL.

AuthenticationType - Tipo de autenticação
string. Obrigatórios. Valores permitidos: server (Autenticação SQL Server), aadAuthenticationPassword (Active Directory – Senha), aadAuthenticationIntegrated (Active Directory – Integrado), connectionString (Cadeia de Conexão) servicePrincipal (Entidade de Serviço). Valor padrão: server.

Especifica o tipo de autenticação de banco de dados. Pode ser uma autenticação SQL Server, Active Directory (integrado), Active Directory (senha), cadeia de conexão ou entidade de serviço. A autenticação integrada significa que o agente acessa o banco de dados usando seu contexto de conta atual do Active Directory.

Especifique a opção para se conectar ao banco de dados do servidor SQL do Azure. Você pode fornecer os detalhes do banco de dados do SQL do Azure Server, o SQL Server cadeia de conexão, a Autenticação do AD (senha ou integrada) ou usar uma entidade de serviço. Para SQL Server autenticação, use as credenciais de usuário do SQL Server. Para autenticação do AD, use as credenciais para o usuário do AD configurado para o SQL Server.

ServerName - servidor SQL do Azure
string. Obrigatório quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

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

DatabaseName - Database
string. Obrigatório quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

Especifica o nome do banco de dados SQL do Azure em que os arquivos são implantados.

SqlUsername - Login
string. Obrigatório quando AuthenticationType = server.

Especifica o logon do administrador do SQL do Azure Server.

SqlPassword - Senha
string. Obrigatório quando AuthenticationType = server.

Especifica a senha para o administrador do servidor SQL do Azure. Variáveis definidas nos pipelines de build ou lançamento conforme $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-lo.

aadSqlUsername - Login
string. Obrigatório quando AuthenticationType = aadAuthenticationPassword.

Especifica o nome de usuário do Active Directory.

aadSqlPassword - Senha
string. Obrigatório quando AuthenticationType = aadAuthenticationPassword.

Especifica a senha para o usuário do Active Directory. Variáveis definidas nos pipelines de build ou lançamento conforme $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-lo.

ConnectionString - Cadeia de conexão
string. Obrigatório quando AuthenticationType = connectionString.

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

deployType - Tipo de implantação
Alias de entrada: TaskNameSelector. string. Obrigatórios. Valores permitidos: DacpacTask (Arquivo DACPAC do SQL), SqlTask (Arquivo de Script SQL) InlineSqlTask (Script SQL embutido). Valor padrão: DacpacTask.

DeploymentAction - Ação
string. Obrigatório quando TaskNameSelector = DacpacTask. Valores permitidos: Publish, Extract, , Export, Import, Script, DriftReport (Relatório de Descompasso) DeployReport (Implantar Relatório). Valor padrão: Publish.

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

DacpacFile - Arquivo DACPAC
string. Obrigatório quando DeploymentAction = Publish || DeploymentAction = Script || DeploymentAction = DeployReport.

Especifica o local do arquivo DACPAC no agente de automação ou em um caminho UNC acessível ao agente de automação, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Variáveis de sistema predefinidas, como $(agent.releaseDirectory), também podem ser usadas.

BacpacFile - Arquivo BACPAC
string. Obrigatório quando DeploymentAction = Import.

Especifica o local do arquivo BACPAC no agente de automação ou em um caminho UNC acessível ao agente de automação, como \\BudgetIT\Web\Deploy\FabrikamDB.bacpac. Variáveis de sistema predefinidas, como $(agent.releaseDirectory), também podem ser usadas.

SqlFile - SQL Script
string. Obrigatório quando TaskNameSelector = SqlTask.

Especifica o local do arquivo de script SQL no agente de automação ou em um caminho UNC acessível ao agente de automação, como \\BudgetIT\Web\Deploy\FabrikamDB.sql. Variáveis de sistema predefinidas, como $(agent.releaseDirectory), também podem ser usadas.

SqlInline - Script SQL embutido
string. Obrigatório quando TaskNameSelector = InlineSqlTask.

Especifica o script SQL a ser executado no banco de dados selecionado anteriormente.

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

Fornece controle refinado sobre SQL do Azure criação ou atualizações de banco de dados.
Especifica o caminho para o arquivo XML de perfil de publicação no computador do agente de automação ou em um compartilhamento UNC. Se o perfil de publicação contiver segredos, como credenciais, carregue-o na biblioteca de arquivos seguros em que ele é armazenado com segurança com criptografia. Em seguida, use a tarefa Baixar arquivo seguro no início do pipeline para baixá-lo no computador do agente quando o pipeline for executado. Exclua-o quando o pipeline for concluído. Variáveis de sistema predefinidas, como $(agent.buildDirectory) ou $(agent.releaseDirectory), também podem ser usadas.

AdditionalArguments - Argumentos de SqlPackage.exe adicionais
string. Opcional. Use 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 implantar o banco de dados SQL do Azure se a opção DACPAC estiver selecionada, como /p:IgnoreAnsiNulls=True /p:IgnoreComments=True. Esses argumentos substituirão as configurações no arquivo XML do perfil de publicação (se fornecido).

SqlAdditionalArguments - Argumentos de Invoke-Sqlcmd adicionais
string. Opcional. Use quando TaskNameSelector = SqlTask.

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

InlineAdditionalArguments - Argumentos de Invoke-Sqlcmd adicionais
string. Opcional. Use quando TaskNameSelector = InlineSqlTask.

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

IpDetectionMethod - Especificar regras de firewall usando
string. Obrigatórios. Valores Permitidos: AutoDetect e IPAddressRange. Valor padrão: AutoDetect.

Para que a tarefa seja executada, o endereço IP do agente de automação deve ser adicionado aos Endereços IP Permitidos no firewall do SQL do Azure Server. Selecione detectar automaticamente para adicionar automaticamente a exceção de firewall para o intervalo do possível endereço IP do agente de automação ou especifique o intervalo explicitamente.

StartIpAddress - Iniciar endereço IP
string. Obrigatório quando IpDetectionMethod = IPAddressRange.

Especifica o endereço IP inicial do pool de computadores do agente de automação, como 196.21.30.50.

EndIpAddress - Endereço IP final
string. Obrigatório quando IpDetectionMethod = IPAddressRange.

Especifica o endereço IP final do pool de computadores do agente de automação, como 196.21.30.65.

DeleteFirewallRule - Excluir regra após o término da tarefa
boolean. Valor padrão: true.

Se selecionada, após o término da tarefa, os endereços IP especificados aqui serão excluídos da lista Endereços IP Permitidos no firewall do servidor SQL do Azure.

Opções de controle da tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Essa tarefa define as variáveis de saída a seguir, que você pode consumir em etapas downstream, trabalhos e estágios.

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

Comentários

Use essa tarefa para implantar um banco de dados SQL do Azure usando um DACPAC ou executar scripts usando SQLCMD.

Importante

Essa tarefa só tem suporte em um ambiente do Windows. Se você estiver tentando usar a autenticação integrada do Azure Active Directory (Azure AD), deverá criar um agente privado. Não há suporte para a autenticação integrada do Azure AD para agentes hospedados.

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Executa em	Agente
Demandas	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam essa tarefa: sqlpackage
Funcionalidades	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis configuráveis	Qualquer
Versão do agente	1.103.0 ou superior
Categoria da tarefa	Implantar