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

Use esta 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.

Insumos

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 Subscrição 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 - Subscrição 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 (Ative Directory - Senha), aadAuthenticationIntegrated (Ative Directory - Integrado), connectionString (Cadeia de Conexão) servicePrincipal (Entidade de Serviço). Valor padrão: server.

Especifica o tipo de autenticação da base de dados. Pode ser um SQL Server, Ative Directory (integrado), Ative Directory (senha), cadeia de conexão ou autenticação de entidade de serviço. A autenticação integrada significa que o agente utilizará o atual contexto de conta do Active Directory para aceder à base de dados.

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 do usuário do AD configurado para o SQL Server.

ServerName - Azure SQL Server
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.

da Base 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 onde os arquivos são implantados.

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

Especifica o logon de administrador do SQL Server do Azure.

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

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

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

Especifica o nome de usuário do Ative Directory.

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

Especifica a senha para o usuário do Ative Directory. As variáveis definidas nos pipelines de compilação ou liberação como $(passwordVariable) são aceitas. Você pode marcar o tipo de variável como secret para protegê-la.

ConnectionString - Cadeia de conexão
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 (SQL DACPAC File), SqlTask (SQL Script File), InlineSqlTask (Inline SQL Script). Valor padrão: DacpacTask.

DeploymentAction - Ação
string. Necessário quando TaskNameSelector = DacpacTask. Valores permitidos: Publish, Extract, Export, Import, Script, DriftReport (Drift Report), DeployReport (Deploy Report). Valor padrão: Publish.

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

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

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

SqlFile - de 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 de sistema predefinidas, como $(agent.releaseDirectory), também podem ser usadas.

SqlInline - de script SQL embutido
string. Necessá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 a criação ou atualizações do banco de dados SQL do Azure.
Especifica o caminho para o arquivo XML do perfil de publicação na máquina do agente de automação ou em um compartilhamento UNC. Se o perfil de publicação contiver segredos, como credenciais, carregue-o para os arquivos biblioteca seguros onde é armazenado com segurança com criptografia. Em seguida, use a tarefa Download secure file no início do pipeline para baixá-lo para a máquina do agente quando o pipeline for executado. Exclua-o quando o pipeline estiver concluído. Variáveis de sistema predefinidas, como $(agent.buildDirectory) ou $(agent.releaseDirectory), também podem ser usadas.

AdditionalArguments - Argumentos 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 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 determinada no banco de dados SQL do Azure, como -ConnectionTimeout 100 -OutputSqlErrors.

InlineAdditionalArguments - Argumentos 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 determinada 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 a deteção automática 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 máquinas 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 SQL Server do Azure.

Opções de controlo de tarefas

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

Variáveis de saída

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

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 esta tarefa para implantar um banco de dados SQL do Azure usando um DACPAC ou executar scripts usando SQLCMD.

Importante

Esta tarefa só é suportada num ambiente Windows. Se você estiver tentando usar a autenticação integrada do Azure Ative Directory (Azure AD), deverá criar um agente privado. A autenticação integrada do Azure AD não é suportada para agentes hospedados.

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente
Exigências	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: sqlpackage
Capacidades	Esta tarefa não satisfaz quaisquer exigências 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 de tarefa	Desplegar