Visão geral de scripts pré e pós-implantação
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric
Os scripts de pré/pós-implantação são scripts SQL incluídos no projeto para serem executados durante a implantação. Eles estão incluídos em .dacpac
, mas não são compilados ou validados com o modelo de objeto de banco de dados. Um script pré-implantação é executado antes da execução do plano de implantação, mas o plano de implantação é calculado antes da execução do script. Um script pós-implantação é executado após a conclusão do plano de implantação.
Exemplo e sintaxe do arquivo de projeto SQL
Um arquivo de projeto SQL pode ter um único script pré-implantação e um único script pós-implantação especificado.
O exemplo a seguir de um arquivo de projeto SQL adiciona o arquivo prep-db.sql
como um script pré-implantação.
...
<ItemGroup>
<PreDeploy Include="prep-db.sql" />
</ItemGroup>
O exemplo a seguir de um arquivo de projeto SQL adiciona o arquivo populate-app-settings.sql
como um script de pós-implantação.
...
<ItemGroup>
<PostDeploy Include="populate-app-settings.sql" />
</ItemGroup>
</Project>
Vários arquivos podem ser executados como parte de um script pré ou pós-implantação usando um script SQLCMD que chama cada arquivo em ordem.
:r .\scripts\script1.sql
:r .\scripts\script2.sql
Esses arquivos devem ser excluídos da compilação do modelo de banco de dados definindo a propriedade Build Action
como None
nas propriedades do arquivo no Visual Studio ou adicionando uma entrada para o arquivo no arquivo .sqlproj
com o atributo Build
definido como None
.
...
<ItemGroup>
<Build Remove="scripts\script1.sql" />
<Build Remove="scripts\script2.sql" />
</ItemGroup>
</Project>
Adicionar scripts pré e pós-implantação
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Adicionar>Script. Selecione o Script pré-implantação ou Pós-implantação.
O arquivo de script é adicionado ao projeto e aberto no editor de consultas, onde você pode concluir o script. Esse script será executado antes ou depois que o plano de implantação for executado sempre que o projeto for implantado.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Adicionar, e depois em Novo Item. A caixa de diálogo Adicionar Novo Item aparece, selecione Mostrar Todos os Modelos. e, em seguida, Tabela. Selecione o Script pré-implantação ou Pós-implantação.
O arquivo de script é adicionado ao projeto e aberto no editor de consultas, onde você pode concluir o script. Esse script será executado antes ou depois que o plano de implantação for executado sempre que o projeto for implantado.
Na exibição Projetos de Banco de Dados do VS Code ou do Azure Data Studio, clique com o botão direito do mouse no projeto e selecione Adicionar Script Pré-Implantação ou Adicionar Script Pós-Implantação. Forneça um nome de script sem a extensão do arquivo.
O arquivo de script é adicionado ao projeto e aberto no editor de consultas, onde você pode concluir o script. Esse script será executado antes ou depois que o plano de implantação for executado sempre que o projeto for implantado.
Edite o arquivo .sqlproj
diretamente para adicionar scripts pré ou pós-implantação. Adicione um item <PreDeploy>
ou <PostDeploy>
à seção <ItemGroup>
do arquivo .sqlproj
.
Por exemplo, para adicionar o script scripts\before-script.sql
ao nosso projeto como um script pré-implantação:
...
<ItemGroup>
<PreDeploy Include="scripts\before-script.sql" />
</ItemGroup>
Esse script scripts\before-script.sql
é executado antes que o plano de implantação seja executado toda vez que o projeto é implantado.