SqlDacpacDeploymentOnMachineGroup@0 – tarefa de implantação do banco de dados SQL Server v0
Use essa tarefa para implantar um banco de dados SQL Server usando scripts DACPAC ou SQL.
Sintaxe
# This task is supported on classic release pipelines only.
# Use the classic designer to add and configure this task in a classic release pipeline.
# See the following Inputs section for details on the inputs that this task supports.
Entradas
TaskType
- Implantar o SQL usando
string
. Obrigatórios. Valores permitidos: dacpac
(Sql Dacpac), sqlQuery
(Arquivo de Consulta Sql) sqlInline
(Sql Inline). Valor padrão: dacpac
.
Especifica a maneira como você deseja implantar o banco de dados: usando Dacpac ou Scripts SQL.
DacpacFile
- Arquivo DACPAC
string
. Obrigatório quando TaskType = dacpac
.
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 ser acessível para a conta de administrador do computador. Também há suporte para variáveis de ambiente, como $env:windir
, $env:systemroot
ou $env:windir\FabrikamFibre\DB
. Caracteres curinga podem ser usados. Por exemplo, **/*.dacpac
para o arquivo DACPAC que está presente em todas as subpastas.
SqlFile
- Arquivo Sql
string
. Obrigatório quando TaskType = sqlQuery
.
Especifica o local do arquivo SQL no destino. Forneça uma lista separada por ponto e vírgula de arquivos de script SQL para executar vários arquivos. Os scripts SQL são executados na ordem fornecida. O local também pode ser um caminho UNC, como \\BudgetIT\Web\Deploy\FabrikamDB.sql
. O caminho UNC deve ser acessível para a conta de administrador do computador. Também há suporte para variáveis de ambiente, como $env:windir
, $env:systemroot
ou $env:windir\FabrikamFibre\DB
. Caracteres curinga podem ser usados. Por exemplo, **/*.sql
para o arquivo SQL presente em todas as subpastas.
ExecuteInTransaction
- Executar dentro de uma transação
boolean
. Opcional. Use quando TaskType = sqlQuery
. Valor padrão: false
.
Executa os scripts SQL em uma transação.
ExclusiveLock
- Adquirir um bloqueio de aplicativo exclusivo durante a execução de scripts
boolean
. Opcional. Use quando ExecuteInTransaction = true
. Valor padrão: false
.
Adquire um bloqueio de aplicativo exclusivo durante a execução de scripts.
AppLockName
- Nome do bloqueio do aplicativo
string
. Obrigatório quando ExclusiveLock = true
.
Especifica o nome do bloqueio do aplicativo.
InlineSql
- Sql embutido
string
. Obrigatório quando TaskType = sqlInline
.
Especifica as consultas SQL embutidas.
TargetMethod
- Especificar SQL usando
string
. Obrigatório quando TaskType = dacpac
. Valores permitidos: server
, connectionString
(Cadeia de Conexão) publishProfile
(Perfil de Publicação). Valor padrão: server
.
Especifica a opção de se conectar ao banco de dados de SQL Server de destino. Você pode fornecer os detalhes do banco de dados SQL Server, a cadeia de conexão SQL Server ou o arquivo XML do perfil de publicação.
ServerName
- Nome do Servidor
string
. Obrigatório quando TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Valor padrão: localhost
.
Especifica o nome SQL Server, como machinename\FabriakmSQL,1433
, localhost
ou .\SQL2012R2
. A especificação localhost
se conectará à instância de SQL Server padrão no computador.
DatabaseName
- Nome do banco de dados
string
. Obrigatório quando TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
.
Especifica o nome do banco de dados SQL Server.
AuthScheme
- Autenticação
string
. Obrigatório quando TargetMethod = server || TaskType = sqlQuery || TaskType = sqlInline
. Valores permitidos: windowsAuthentication
(Autenticação do Windows) sqlServerAuthentication
(Autenticação SQL Server). Valor padrão: windowsAuthentication
.
Especifica o modo de autenticação para se conectar ao SQL Server. No modo autenticação do Windows, a conta usada para configurar o agente de implantação é usada para se conectar ao SQL Server. No modo de autenticação SQL Server, o logon e a senha do SQL devem ser fornecidos nos parâmetros abaixo.
SqlUsername
- Nome de usuário do SQL
string
. Obrigatório quando AuthScheme = sqlServerAuthentication
.
Especifica o logon do SQL para se conectar ao SQL Server. Essa opção só estará disponível se SQL Server modo de autenticação tiver sido selecionado.
SqlPassword
- Senha do SQL
string
. Obrigatório quando AuthScheme = sqlServerAuthentication
.
Especifica a senha do logon do SQL. Essa opção só estará disponível se SQL Server modo de autenticação tiver sido selecionado.
ConnectionString
- Cadeia de conexão
string
. Obrigatório quando TargetMethod = connectionString
.
Especifica a cadeia de conexão SQL Server, como Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;
.
PublishProfile
- Publicar Perfil
string
. Opcional. Use quando TaskType = dacpac
.
Fornece controle refinado sobre implantações de banco de dados 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
. Opcional. Use quando TaskType = dacpac
.
Especifica argumentos adicionais SqlPackage.exe
que serão aplicados ao implantar o banco de dados 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).
AdditionalArgumentsSql
- Argumentos adicionais
string
. Opcional. Use quando TaskType = sqlQuery || TaskType = sqlInline
.
Especifica argumentos adicionais Invoke-Sqlcmd
que são aplicados ao implantar o banco de dados SQL Server.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | Versão clássica |
É executado em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | 1.102.0 ou superior |
Categoria da tarefa | Implantar |
Requisito | Descrição |
---|---|
Tipos de pipeline | Versão clássica |
É executado em | Deploymentgroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | 1.102.0 ou superior |
Categoria da tarefa | Implantar |