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.
Utilize esta tarefa para implementar uma base de dados SQL Server com o DACPAC.
Esta tarefa foi preterida.
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.
# SQL Server database deploy (Deprecated) v1
# Deploy 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:systemroot
e $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 |