Validar um pacote de DAC
Esta é uma prática recomendada para revisar o conteúdo de um pacote de DAC antes de implantá-lo em produção e também para validar as ações de atualização antes de atualizar um DAC existente. Isso é especialmente válido durante a implantação de pacotes que não foram desenvolvidos em sua organização.
Antes de começar: Pré-requisitos
Para atualizar um DAC, usando: Exibir o Conteúdo de um DAC, Exibir Alterações no Banco de Dados, Exibir Ações de Atualização, Comparar DACs
Pré-requisitos
Recomendamos não implantar um pacote de DAC de origens desconhecidas ou não confiáveis. Como os DACs podem conter código mal-intencionado que pode executar código Transact-SQL sem finalidade ou provocar erros modificando o esquema. Antes de usar um DAC de uma origem desconhecida ou não confiável, implante-o em uma instância de teste isolada do Mecanismo de Banco de Dados, execute DBCC CHECKDB (Transact-SQL) no banco de dados e, além disso, examine o código, como procedimentos armazenados ou outro código definido pelo usuário, no banco de dados.
[Início]
Exibir o conteúdo de um DAC
Existem dois mecanismos para exibição do conteúdo de um pacote de DAC (aplicativo da camada de dados). Você pode importar o pacote de DAC para um projeto de DAC no SQL Server Developer Tools. É possível desempacotar o conteúdo do pacote em uma pasta.
Exiba um DAC no SQL Server Developer Tools
Abra o menu Arquivo, selecione Novo e, em seguida, selecione Projeto….
Selecione o modelo de projeto SQL Server e especifique um Nome, um Local e um Nome de solução.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó e selecione Propriedades….
Na guia Configurações de Projeto, na seção Tipos de Saída, marque a caixa de seleção Aplicativo de Camada de Dados (arquivo .dacpac) e, depois, feche a caixa de diálogo de propriedades.
No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Importar Aplicativo da Camada de Dados….
Use o Gerenciador de Soluções para abrir todos os arquivos no DAC, como a política de seleção de servidor e os scripts de pré e pós-implantação.
Use a Exibição de Esquema para examinar todos os objetos no esquema, especialmente o código em objetos, como funções ou procedimentos armazenados.
[Início]
Exibir um DAC em uma pasta
Desempacote o pacote de DAC em uma pasta seguindo as instruções em Desempacotar um pacote de DAC.
Exiba os conteúdo dos scripts Transact-SQL abrindo-os no Editor de Consulta Mecanismo de Banco de Dados no Management Studio.
Exiba o conteúdo dos arquivos de texto em ferramentas como o bloco de notas.
[Início]
Exibir alterações do banco de dados
Depois que a versão atual de um DAC for implantada para produção, alterações poderão ter sido feitas diretamente no banco de dados associado que podem estar em conflito com o esquema definido em uma nova versão do DAC. Antes de atualizar para uma nova versão do DAC, verifique se foram feitas alterações no banco de dados.
Exibir alterações do banco de dados usando um assistente
Execute o assistente para Atualizar Aplicativo da Camada de Dados, especificando o DAC implantada no momento e o pacote de DAC que contém a nova versão do DAC.
Na página Detectar Alteração, examine o relatório das alterações que foram feitas no banco de dados.
Selecione Cancelar se não desejar continuar com a atualização.
Para obter mais informações sobre como usar o assistente, consulte Atualizar um aplicativo da camada de dados.
Exibir alterações do banco de dados usando o PowerShell
Crie um objeto de servidor SMO e defina-o como a instância que contém o DAC a ser exibido.
Abra um objeto ServerConnection e conecte-se à mesma instância.
Especifique o nome de DAC em uma variável.
Use o método GetDatabaseChanges() para recuperar um objeto ChangeResults e redirecione o objeto para um arquivo de texto para gerar um relatório simples de objetos novos, excluídos e alterados.
[Início]
Exibir exemplo de alterações do banco de dados (PowerShell)
Exibir exemplo de alterações do banco de dados (PowerShell)
O exemplo a seguir relata alterações de banco de dados realizadas em um DAC implantado denominado MyApplicaiton.
## Set a SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$srv = get-item .
## Open a Common.ServerConnection to the same instance.
$serverconnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($srv.ConnectionContext.SqlConnectionObject)
$serverconnection.Connect()
$dacstore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverconnection)
## Specify the DAC instance name.
$dacName = "MyApplication"
## Generate the change list and save to file.
$dacChanges = $dacstore.GetDatabaseChanges($dacName) | Out-File -Filepath C:\DACScripts\MyApplicationChanges.txt
[Início]
Exibir ações de atualização
Antes de usar uma nova versão de um pacote de DAC para atualizar um DAC que foi implantado de um pacote de DAC anterior, você pode gerar um relatório que contém as instruções Transact-SQL a serem executadas durante a atualização e, depois, examinar as instruções.
Relate ações de atualização usando um assistente
Execute o assistente para Atualizar Aplicativo da Camada de Dados, especificando o DAC implantada no momento e o pacote de DAC que contém a nova versão do DAC.
Na página Resumo, examine o relatório das ações de atualização.
Selecione Cancelar se não desejar continuar com a atualização.
Para obter mais informações sobre como usar o assistente, consulte Atualizar um aplicativo da camada de dados.
[Início]
Relate ações de atualização usando o PowerShell
Crie um objeto de servidor SMO e defina-o como a instância que contém o DAC implantado.
Abra um objeto ServerConnection e conecte-se à mesma instância.
Use System.IO.File para carregar o arquivo de pacote de DAC.
Especifique o nome de DAC em uma variável.
Use o método GetIncrementalUpgradeScript() para obter uma lista das instruções Transact-SQL que uma atualização executaria e redirecione a lista para um arquivo de texto.
Feche o fluxo de arquivos usado para ler o arquivo de pacote de DAC.
[Início]
Exibir o exemplo de ações de atualização (PowerShell)
Exibir o exemplo de ações de atualização (PowerShell)
O exemplo a seguir relata as instruções Transact-SQL que seriam executadas para atualizar um DAC denominado MyApplicaiton para o esquema definido em um arquivo MyApplicationVNext.dacpac.
## Set a SMO Server object to the default instance on the local computer.
CD SQLSERVER:\SQL\localhost\DEFAULT
$srv = get-item .
## Open a Common.ServerConnection to the same instance.
$serverconnection = New-Object Microsoft.SqlServer.Management.Common.ServerConnection($srv.ConnectionContext.SqlConnectionObject)
$serverconnection.Connect()
$dacstore = New-Object Microsoft.SqlServer.Management.Dac.DacStore($serverconnection)
## Load the DAC package file.
$dacpacPath = "C:\MyDACs\MyApplicationVNext.dacpac"
$fileStream = [System.IO.File]::Open($dacpacPath,[System.IO.FileMode]::OpenOrCreate)
$dacType = [Microsoft.SqlServer.Management.Dac.DacType]::Load($fileStream)
## Specify the DAC instance name.
$dacName = "MyApplication"
## Generate the upgrade script and save to file.
$dacstore.GetIncrementalUpgradeScript($dacName, $dacType) | Out-File -Filepath C:\DACScripts\MyApplicationUpgrade.sql
## Close the filestream to the new DAC package.
$fileStream.Close()
[Início]
Comparar DACs
Antes de atualizar um DAC, é recomendável revisar as diferenças nos objetos em nível de banco de dados e instância entre o DAC atual e o novo. Se você não tiver uma cópia do pacote para o DAC atual, poderá extrair um pacote do banco de dados atual.
Se você importar os pacotes de DAC para projetos de DAC no SQL Server Developer Tools, poderá usar a ferramenta de comparação de esquemas para analisar as diferenças entre o dois DACs.
Outra alternativa é desempacotar os DACs em pastas separadas. Você pode usar uma ferramenta de diferenças, como o utilitário WinDiff, para analisar as diferenças.
[Início]
Consulte também
Conceitos
Aplicativos da camada de dados