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

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

Sintaxe

# 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 (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valor padrão: ConnectedServiceNameARM.

azureClassicSubscription - de Assinatura Clássica do Azure
Alias de entrada: ConnectedServiceName. string. Necessá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. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

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

AuthenticationType - Tipo de autenticação
string. Obrigatório Valores permitidos: server (Autenticação do 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 do banco de dados. Pode ser um SQL Server, Active Directory (integrado), Active Directory (senha), cadeia de conexão ou autenticação de entidade de serviço. Autenticação integrada significa que o agente acessará o banco de dados usando seu atual contexto de conta do Active Directory.

Especifique a opção para se conectar ao banco de dados do SQL Server do Azure. Você pode fornecer os detalhes do banco de dados do SQL Server do Azure, a cadeia de conexão do SQL Server, a Autenticação do AD (senha ou integrada) ou usar uma entidade de serviço. Para autenticação do SQL Server, 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 - do SQL Server do Azure
string. Necessário quando AuthenticationType = server || AuthenticationType = aadAuthenticationPassword || AuthenticationType = aadAuthenticationIntegrated || AuthenticationType = servicePrincipal.

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

banco de dados DatabaseName -
string. Necessá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.

de logon do SqlUsername -
string. Necessário quando AuthenticationType = server.

Especifica o logon do administrador do SQL Server do Azure.

SqlPassword - de senha
string. Necessário quando AuthenticationType = server.

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

de logon do aadSqlUsername -
string. Necessário quando AuthenticationType = aadAuthenticationPassword.

Especifica o nome de usuário do Active Directory.

aadSqlPassword - de senha
string. Necessário quando AuthenticationType = aadAuthenticationPassword.

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

de cadeia de conexão ConnectionString -
string. Necessário quando AuthenticationType = connectionString.

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

deployType - Implantar tipo
Alias de entrada: TaskNameSelector. string. Obrigatório Valores permitidos: DacpacTask (arquivo SQL DACPAC), SqlTask (arquivo de script SQL), InlineSqlTask (script SQL embutido). Valor padrão: DacpacTask.

de Ação DeploymentAction -
string. Necessá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 SQL da lista. Saiba mais sobre a lista de ações do SQL.

DacpacFile - de arquivo DACPAC
string. Necessá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 predefinidas do sistema, como $(agent.releaseDirectory), também podem ser usadas.

BacpacFile - de arquivo BACPAC
string. Necessá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 predefinidas do sistema, como $(agent.releaseDirectory), também podem ser usadas.

SqlFile - script SQL
string. Necessá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 predefinidas do sistema, como $(agent.releaseDirectory), também podem ser usadas.

SqlInline - script SQL embutido
string. Necessário quando TaskNameSelector = InlineSqlTask.

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

de Perfil de Publicação PublishProfile -
string. Opcional. Use quando TaskNameSelector = DacpacTask || DeploymentAction = Script || DeploymentAction = DeployReport.

Fornece controle refinado sobre a criação ou atualizações do banco de dados SQL do Azure.
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 no arquivos seguros biblioteca em que ele é armazenado com segurança com criptografia. Em seguida, use o arquivo seguro Baixar tarefa 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 predefinidas do sistema, 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 de SqlPackage.exe adicionais 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ório Valores permitidos: AutoDetect, IPAddressRange. Valor padrão: AutoDetect.

Para que a tarefa seja executada, o endereço IP do agente de automação deve ser adicionado ao endereços IP permitidos no firewall do SQL Server do Azure. 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 o endereço IP
string. Necessário quando IpDetectionMethod = IPAddressRange.

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

EndIpAddress - endereço IP final
string. Necessá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 selecionado, 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 SQL Server do Azure.

Opções de controle de tarefa

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

Variáveis de saída

Essa tarefa define as seguintes variáveis de saída , 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.

Observações

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 AD (Azure Active Directory), deverá criar um agente privado. Não há suporte para autenticação integrada do Azure AD para agentes hospedados.

Requisitos

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