Compartilhar via


SqlServerDacpacDeployment@1 – Tarefa de implantação de banco de dados do SQL Server (preterida) v1

Use essa tarefa para implantar um banco de dados do SQL Server usando DACPAC.

Importante

Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use implantação de aplicativo Web do IIS usando o WinRM – Viual Studio Marketplace.

Use essa tarefa para implantar um banco de dados do SQL Server usando DACPAC.

Essa tarefa foi preterida.

Sintaxe

# SQL Server database deploy (Deprecated) v1
# Deploy a SQL Server database using DACPAC.
- task: SqlServerDacpacDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    DacpacFile: # string. Required. DACPAC File. 
  # Target
    TargetMethod: 'server' # 'server' | 'connectionString' | 'publishProfile'. Required. Specify SQL Using. Default: server.
    ServerName: 'localhost' # string. Required when TargetMethod = server. Server Name. Default: localhost.
    DatabaseName: # string. Required when TargetMethod = server. Database Name. 
    #SqlUsername: # string. Optional. Use when TargetMethod = server. SQL Username. 
    #SqlPassword: # string. Optional. Use when TargetMethod = server. SQL Password. 
    #ConnectionString: # string. Required when TargetMethod = connectionString. Connection String. 
    #PublishProfile: # string. Publish Profile. 
    #AdditionalArguments: # string. Additional Arguments. 
  # Advanced
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

Entradas

máquinas EnvironmentName -
string. Obrigatório

Especifica uma lista separada por vírgulas de endereços IP do computador ou FQDNs junto com portas. A porta padrão é baseada no protocolo selecionado. Por exemplo: variáveis de saída de dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 de outras tarefas também podem ser fornecidas, por exemplo, $(variableName).


de Logon do Administrador do AdminUserName -
string.

Especifica o logon do administrador para os computadores de destino.


AdminPassword - de senha
string.

Especifica a senha do administrador para os computadores de destino. Variáveis definidas em definições de build ou versão são aceitas como $(passwordVariable). Você pode marcar o tipo de variável como secret para protegê-lo.


de Protocolo Protocol -
string. Valores permitidos: Http, Https.

Especifica o protocolo a ser usado para a conexão WinRM com os computadores. O valor padrão é HTTPS.


TestCertificate - de certificado de teste
boolean. Opcional. Use quando Protocol = Https. Valor padrão: true.

Ignora a validação de autenticidade do certificado do computador por uma autoridade de certificação confiável. O parâmetro é necessário para o protocolo HTTPS do WinRM.


DacpacFile - de arquivo DACPAC
string. Obrigatório

Especifica o local do arquivo DACPAC nos computadores de destino ou em um caminho UNC, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. O caminho UNC deve estar acessível à conta de administrador do computador. Também há suporte para variáveis de ambiente, como $env:windir, $env:systemroote $env:windir\FabrikamFibre\Web.


TargetMethod - especificar SQL usando
string. Obrigatório Valores permitidos: server, connectionString (Cadeia de Conexão), publishProfile (Perfil de Publicação). Valor padrão: server.

Especifica a opção para se conectar ao banco de dados sql server de destino. Você pode fornecer detalhes do banco de dados do SQL Server, uma cadeia de conexão do SQL Server ou um arquivo XML de perfil de publicação.


ServerName - nome do servidor
string. Necessário quando TargetMethod = server. Valor padrão: localhost.

Especifica o nome do SQL Server, como machinename\FabriakmSQL,1433 ou localhost ou .\SQL2012R2. Especificar localhost se conecta à instância padrão do SQL Server no computador.


DatabaseName - nome do banco de dados
string. Necessário quando TargetMethod = server.

Especifica o nome do banco de dados do SQL Server.


SqlUsername - de nome de usuário do SQL
string. Opcional. Use quando TargetMethod = server.

Se o logon do SQL Server for especificado, ele será usado para se conectar ao SQL Server. A autenticação integrada padrão usa as credenciais do administrador do computador.


SqlPassword - de senha do SQL
string. Opcional. Use quando TargetMethod = server.

Se o nome de usuário de logon do SQL Server for especificado, forneça a senha do SQL Server. A autenticação integrada padrão usa as credenciais do administrador do computador.


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

Especifica a cadeia de conexão do SQL Server, como Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.


de Perfil de Publicação PublishProfile -
string.

Fornece controle refinado sobre a criação ou atualizações do banco de dados do SQL Server. Especifica o caminho para o arquivo XML de perfil de publicação no computador de destino ou em um compartilhamento UNC acessível pelas credenciais do administrador do computador.


AdditionalArguments - argumentos adicionais
string.

Especifica argumentos de SqlPackage.exe adicionais que são aplicados ao criar ou atualizar o banco de dados do SQL Server, como /p:IgnoreAnsiNulls=True ou /p:IgnoreComments=True. Esses argumentos substituirão as configurações no arquivo XML do perfil de publicação (se fornecido).


implantação DeployInParallel - em paralela
boolean. Valor padrão: true.

Quando definido como true, executa a tarefa de implantação de banco de dados em paralelo nos computadores de destino.


ResourceFilteringMethod - selecionar computadores
string. Valores permitidos: machineNames (Nomes de Máquina), tags. Valor padrão: machineNames.

Opcional. Especifica um subconjunto de computadores fornecendo nomes de computador ou marcas.


MachineFilter - implantar em computadores
string.

Essa entrada só é válida para grupos de computadores e ainda não tem suporte para uma lista simples de computadores ou variáveis de saída.
Especifica uma lista de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34ou marcas, como Role:DB; OS:Win8.1. Se várias marcas forem fornecidas, a tarefa será executada em todos os computadores com as marcas especificadas. Para grupos de recursos do Azure, forneça o nome da máquina virtual, como ffweb ou ffdb. O padrão executa a tarefa em todos os computadores.


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

Nenhum.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
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.96.2 ou superior
Categoria de tarefa Implantar