Visão geral da comparação de esquemas

1. No menu Ferramentas no Visual Studio, selecione SQL Server e selecione Nova Comparação de Esquemas.

   Como alternativa, clique com o botão direito do mouse no projeto TradeDev, no Gerenciador de Soluções, e selecione Comparação de Esquemas.

   A janela Comparação de Esquemas é aberta e o Visual Studio automaticamente atribui a ela um nome, como SqlSchemaCompare1.

   Duas listas suspensas com uma seta verde entre elas aparecem logo abaixo da barra de ferramentas da janela Comparação de Esquemas. Esses menus permitem que você selecione definições de banco de dados para a origem e o destino da comparação.

2. Na lista suspensa Selecionar Origem, escolha Selecionar Origem para abrir a caixa de diálogo Selecionar Esquema de Origem.

   Se você abriu a janela Comparação de Esquemas clicando com o botão direito do mouse no nome do projeto, o esquema de origem já estará preenchido e você poderá passar para a etapa 4.

   

3. Conclua as seleções para uma fonte de comparação de esquemas escolhendo um Projeto, uma conexão de Banco de dados ou um arquivo .dacpac. A origem é a definição de banco de dados que você deseja usar como base para alterações no destino.

4. Na lista suspensa Selecionar Destino, na Janela de Comparação de Esquemas, escolha Selecionar Destino para abrir a caixa de diálogo Selecionar Esquema de Destino. Conclua as seleções para um destino de comparação de esquemas escolhendo um Projeto, uma conexão de Banco de dados ou um arquivo .dacpac. O destino é a definição de banco de dados que você deseja avaliar e potencialmente aplicar alterações.

5. Você também pode selecionar o botão Opções na barra de ferramentas da Janela de Comparação de Esquemas para especificar quais objetos são comparados, que tipos de diferenças são ignorados e outras configurações.

6. Selecione o botão Comparar na barra de ferramentas da Janela de Comparação de Esquemas para iniciar o processo de comparação.

   Quando a comparação estiver concluída, as diferenças estruturais entre o projeto e o banco de dados aparecerão no painel Resultados, na parte superior da janela. Por padrão, os resultados da comparação agrupam todas as diferenças por ação (como Excluir, Alterar ou Adicionar). O painel Resultados exibe uma linha para cada objeto de banco de dados que difere entre as definições de banco de dados. Cada linha identifica o objeto no esquema de origem ou destino (ou ambos), bem como a ação que seria executada no esquema de destino para tornar o objeto de destino igual ao objeto de origem. Se um objeto tiver sido refatorado e renomeado ou movido para um novo esquema, os nomes da origem e do destino serão diferentes, e o nome da origem aparecerá em negrito para realçar a diferença.

   

   Por padrão, a lista de resultados oculta os objetos iguais em ambos os esquemas ou que não têm suporte para atualização (por exemplo, objetos internos). Você poderá selecionar os botões de filtro apropriados na barra de ferramentas para mostrar esses objetos.

   Para alterar a preferência de agrupamento, selecione a lista suspensa Agrupar Resultados na barra de ferramentas. Selecione Tipo para agrupar os resultados por tipo de objeto (por exemplo, por tabelas, exibições ou procedimentos armazenados).

7. Por padrão, todas as diferenças são incluídas no escopo da ação Atualizar Destino. Você pode excluir as diferenças que não deseja sincronizar. Para isso, desmarque a coluna Ação no centro de cada linha. Como alternativa, clique com o botão direito do mouse em uma linha no painel Esquema e selecione Excluir. A linha fica acinzentada imediatamente. Quando a comparação de esquemas for usada para atualizar o banco de dados de destino, essa linha não será considerada para nenhuma alteração pendente.

   Você também poderá clicar com o botão direito do mouse em uma linha de grupo e selecionar Excluir Tudo ou Incluir Tudo, o que é equivalente a desmarcar ou marcar todas as diferenças nesse grupo. Quando você agrupa resultados por esquema, isso é útil para incluir ou excluir todas as alterações de um esquema específico.

   Se a linha que está sendo excluída tiver objetos dependentes (por exemplo, uma linha Tabela que seja referenciada por uma linha Exibição), a linha excluída será desabilitada, mas sua caixa de seleção não será desmarcada. Quando todas as linhas que dependem dela forem desmarcadas, uma linha desabilitada é desmarcada. Além disso, se uma linha for refatorada (renomeada ou movida para outro esquema), a caixa de seleção será desabilitada para essa linha e qualquer uma de suas linhas filho dependentes.

   Se você atualizar a comparação, essas diferenças que você escolheu ignorar serão ignoradas.

Para atualizar o esquema do destino, você tem duas opções. Você poderá atualizar o destino diretamente na janela Comparação de Esquemas, se o destino for um banco de dados ou um projeto, ou gerar um script de atualização, se o destino for um banco de dados ou um arquivo de banco de dados. Um script gerado é exibido no Editor Transact-SQL, no qual você pode inspecionar o script e executá-lo em um banco de dados.

A comparação de esquema gráfico ainda não está disponível na versão prévia de projetos SQL no estilo SDK no Visual Studio. Use o Azure Data Studio para comparar esquemas.

1. No Azure Data Studio, na paleta de comandos (ctrl/cmd+shift+P), pesquise e selecione Comparação de Esquemas.

   Como alternativa, clique com o botão direito do mouse em um projeto de banco de dados na exibição Projetos de Banco de Dados ou em um banco de dados no Pesquisador de Objetos e selecione Comparação de Esquemas.

   

   A janela Comparação de Esquemas é aberta e uma origem ou destino pode ser predefinida com base no ponto de inicialização.

   Dois botões de reticências com uma seta entre eles aparecem logo abaixo da barra de ferramentas da janela Comparação de Esquemas. Esses menus permitem que você selecione definições de banco de dados para a origem e o destino da comparação.

2. Selecionar o botão de reticências para a origem ou destino abre uma caixa de diálogo onde um ou ambos podem ser atualizados. Conclua as seleções para uma fonte de comparação de esquemas escolhendo um Projeto, uma conexão de Banco de dados ou um arquivo .dacpac. A origem é a definição de banco de dados que você deseja usar como base para alterações no destino. O destino é a definição de banco de dados que você deseja avaliar e potencialmente aplicar alterações.

   

   Depois que as seleções forem concluídas, selecione OK para fechar a caixa de diálogo e retornar à janela Comparação de Esquemas.

3. Você também pode selecionar o botão Opções na barra de ferramentas da Janela de Comparação de Esquemas para especificar quais objetos são comparados, que tipos de diferenças são ignorados e outras configurações.

4. Selecione o botão Comparar na barra de ferramentas da Janela de Comparação de Esquemas para iniciar o processo de comparação.

   Quando a comparação estiver concluída, as diferenças estruturais entre o projeto e o banco de dados aparecerão no painel Resultados, na parte superior da janela. Por padrão, os resultados da comparação agrupam todas as diferenças por ação (como Excluir, Alterar ou Adicionar). O painel Resultados exibe uma linha para cada objeto de banco de dados que difere entre as definições de banco de dados. Cada linha identifica o objeto no esquema de origem ou destino (ou ambos), bem como a ação que será executada no esquema de destino para tornar o objeto de destino igual ao objeto de origem. Se um objeto tiver sido refatorado e renomeado ou movido para um novo esquema, os nomes da origem e do destino serão diferentes, e o nome da origem aparecerá em negrito para realçar a diferença.

   

5. Por padrão, todas as diferenças são incluídas no escopo da ação Atualizar Destino. Você pode excluir as diferenças que não deseja sincronizar. Para isso, desmarque a coluna Ação no centro de cada linha. Como alternativa, clique com o botão direito do mouse em uma linha no painel Esquema e selecione Excluir. A linha fica acinzentada imediatamente. Quando a comparação de esquemas for usada para atualizar o banco de dados de destino, essa linha não será considerada para nenhuma alteração pendente.

   Você também poderá clicar com o botão direito do mouse em uma linha de grupo e selecionar Excluir Tudo ou Incluir Tudo, o que é equivalente a desmarcar ou marcar todas as diferenças nesse grupo. Quando você agrupa resultados por esquema, isso é útil para incluir ou excluir todas as alterações de um esquema específico.

   Se a linha que está sendo excluída tiver objetos dependentes (por exemplo, uma linha Tabela que seja referenciada por uma linha Exibição), a linha excluída será desabilitada, mas sua caixa de seleção não será desmarcada. Quando todas as linhas que dependem dela forem desmarcadas, uma linha desabilitada será desmarcada. Além disso, se uma linha for refatorada (renomeada ou movida para outro esquema), a caixa de seleção será desabilitada para essa linha e qualquer uma de suas linhas filho dependentes.

   Se você atualizar a comparação, essas diferenças que você escolheu ignorar serão ignoradas.

Para atualizar o esquema do destino, você tem duas opções. Você poderá atualizar o destino diretamente na janela Comparação de Esquemas com o botão Aplicar se o destino for um banco de dados ou um projeto, ou gerar um script de atualização se o destino for um banco de dados com o botão Gerar script. Um script gerado é exibido no Editor Transact-SQL, no qual você pode inspecionar o script e executá-lo em um banco de dados.

A comparação de esquemas requer uma ferramenta gráfica, como o Visual Studio ou o Azure Data Studio.