SqlServerDacpacDeployment@1 - SQL Server tarefa de implementação da base de dados (Preterida) v1

Utilize esta tarefa para implementar uma base de dados SQL Server com o DACPAC.

Importante

Esta tarefa foi preterida e será descontinuada a 31 de janeiro de 2024. Utilize a Implementação de Aplicações Web do IIS com o WinRM – Viual Studio Marketplace.

Syntax

# 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

EnvironmentName - Computadores
string. Obrigatório.

Especifica uma lista separada por vírgulas de endereços IP ou FQDNs da máquina, juntamente com portas. A porta predefinida baseia-se no protocolo selecionado. Por exemplo: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 também podem ser fornecidas variáveis de saída de outras tarefas, por exemplo $(variableName).

AdminUserName - Início de Sessão do Administração
string.

Especifica o início de sessão do administrador para os computadores de destino.

AdminPassword - Palavra-passe
string.

Especifica a palavra-passe de administrador para os computadores de destino. As variáveis definidas nas definições de compilação ou versão são aceites como $(passwordVariable). Pode marcar o tipo de variável como secret para protegê-lo.

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

Especifica o protocolo a utilizar para a ligação WinRM com as máquinas virtuais. O valor predefinido é HTTPS.

TestCertificate - Testar Certificado
boolean. Opcional. Utilize quando Protocol = Https. Valor predefinido: true.

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

DacpacFile - Ficheiro DACPAC
string. Obrigatório.

Especifica a localização do ficheiro DACPAC nos computadores de destino ou num caminho UNC, como \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. O caminho UNC deve estar acessível para a conta de administrador do computador. As variáveis de ambiente também são suportadas, como $env:windir, $env:systemroote $env:windir\FabrikamFibre\Web.

TargetMethod - Especificar SQL Com
string. Obrigatório. Valores permitidos: server, connectionString (Cadeia de Ligação), publishProfile (Publicar Perfil). Valor predefinido: server.

Especifica a opção para ligar à base de dados SQL Server de destino. Pode fornecer detalhes SQL Server base de dados, um SQL Server cadeia de ligação ou um ficheiro XML de perfil de publicação.

ServerName - Nome do Servidor
string. Necessário quando TargetMethod = server. Valor predefinido: localhost.

Especifica o nome do SQL Server, como machinename\FabriakmSQL,1433 ou localhost ou .\SQL2012R2. Especificar localhost liga à instância de SQL Server predefinida no computador.

DatabaseName - Nome da Base de Dados
string. Necessário quando TargetMethod = server.

Especifica o nome da base de dados SQL Server.

SqlUsername - Nome de Utilizador do SQL
string. Opcional. Utilize quando TargetMethod = server.

Se o SQL Server início de sessão for especificado, é utilizado para ligar ao SQL Server. A predefinição Autenticação Integrada utiliza as credenciais do administrador do computador.

SqlPassword - Palavra-passe do SQL
string. Opcional. Utilize quando TargetMethod = server.

Se o SQL Server nome de utilizador de início de sessão for especificado, forneça a palavra-passe de SQL Server. A predefinição Autenticação Integrada utiliza as credenciais do administrador do computador.

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

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

PublishProfile - Publicar Perfil
string.

Fornece controlo detalhado sobre SQL Server criação ou atualizações de bases de dados. Especifica o caminho para o ficheiro XML de perfil de publicação no computador de destino ou numa partilha UNC acessível pelas credenciais do administrador do computador.

AdditionalArguments - Argumentos Adicionais
string.

Especifica argumentos adicionais SqlPackage.exe que são aplicados ao criar ou atualizar a base de dados SQL Server, como /p:IgnoreAnsiNulls=True ou /p:IgnoreComments=True. Estes argumentos substituirão as definições no ficheiro XML de perfil de publicação (se for fornecido).

DeployInParallel - Implementar em Paralelo
boolean. Valor predefinido: true.

Quando definida como true, executa a tarefa de implementação da base de dados em paralelo nos computadores de destino.

ResourceFilteringMethod - Selecionar Máquinas Por
string. Valores permitidos: machineNames (Nomes das Máquinas), tags. Valor predefinido: machineNames.

Opcional. Especifica um subconjunto de máquinas ao fornecer nomes de máquinas ou etiquetas.

MachineFilter - Implementar em Computadores
string.

Esta entrada só é válida para grupos de máquinas e ainda não é suportada para uma lista simples de máquinas ou variáveis de saída.
Especifica uma lista de computadores, como dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34, ou etiquetas, como Role:DB; OS:Win8.1. Se forem fornecidas várias etiquetas, a tarefa é executada em todos os computadores com as etiquetas especificadas. Para Grupos de Recursos do Azure, indique o nome da máquina virtual, como ffweb ou ffdb. A predefinição executa a tarefa em todos os computadores.

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

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Nenhuma
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.96.2 ou superior
Categoria da tarefa	Implementação