Caixa de diálogo Adicionar Referência de Banco de Dados

  • Artigo

Este artigo descreve os procedimentos que você pode executar na caixa de diálogo Adicionar Referência de Banco de Dados.

As referências de banco de dados permitem que você:

Acesse objetos em outros bancos de dados.
Um projeto pode fazer referência a outro banco de dados em qualquer servidor ao usar uma resolução de nomes de três ou de quatro partes. É possível usar variáveis ​​SQLCMD para permitir que as referências funcionem em vários servidores e bancos de dados ao usar um nome de três ou de quatro partes como referência.

Criar uma solução de composição para vários projetos de banco de dados.
Em um projeto de composição, as referências de banco de dados realizam a partição de um banco de dados de grande extensão em vários projetos separados. Você cria uma referência que não contém variáveis ou valores para o banco de dados ou para o servidor (usando somente nomes de uma e de duas partes).

As referências de bancos de dados podem ser feitas para um projeto de banco de dados na solução atual ou para um DACPAC. Adicionar uma referência de banco de dados a um projeto altera as dependências do projeto e a ordem de build.

Seleção do banco de dados para referência

É possível fazer referência a outro projeto de banco de dados ao usar a mesma solução, um banco de dados do sistema ou um DACPAC.

Se a solução contiver mais de um projeto de banco de dados, a opção Projetos de Banco de Dados na Solução Atual será habilitada. Você pode referenciar outro banco de dados na solução.

Selecione Banco de dados do sistema se você pretende selecionar um dos bancos de dados do sistema como uma referência de banco de dados.

Selecione Aplicativo da Camada de Dados (.dacpac) para referenciar um banco de dados em um DACPAC, e procure o diretório com o arquivo DACPAC.

Seleção da localização relativa do banco de dados

Depois de selecionar o banco de dados que deseja referenciar, você poderá especificar a localização esperada de um objeto de banco de dados relativo ao projeto de referência.

As referências podem ser resolvidas para objetos em um dos seguintes locais:

  • No banco de dados de referência.

  • Em um banco de dados diferente do banco de dados de referência, mas no mesmo servidor.

  • Em um banco de dados diferente do banco de dados de referência, em um servidor diferente.

Especifique um nome de banco de dados. Se você escolher Banco de Dados do Sistema, não deverá modificar literalmente o banco de dados do sistema. Se você escolher Projetos de banco de dados na solução atual, o nome padrão do banco de dados terá como base o nome do banco de dados no projeto.

Se você selecionou Banco de dados diferente, servidor diferente, especifique um nome de servidor.

Você pode usar uma variável de banco de dados (SQLCMD). Se desejar fazer referência ao banco de dados com uma variável (em vez do nome literal), aceite ou modifique a variável de banco de dados padrão. Uma variável de banco de dados será útil se você publicar o projeto de banco de dados usando vários servidores e bancos de dados. Nesse caso, um desenvolvedor pode ir para Variáveis SQLCMD nas páginas de propriedades do projeto e especificar o nome local do banco de dados. Se você deixar Variável de banco de dados em branco, só poderá fazer referência ao banco de dados pelo seu nome literal. Se você especificar um nome de variável de banco de dados, não poderá fazer referência ao banco de dados por seu nome literal.

Se você selecionou a opção Banco de dados diferente, servidor diferente uma variável de servidor (SQLCMD) será necessária. Uma variável de servidor ajuda a publicar o projeto de banco de dados usando vários servidores e bancos de dados. Nesse caso, um desenvolvedor pode ir para Variáveis SQLCMD nas páginas de propriedades do projeto e especificar o nome local do servidor. Você pode fazer referência ao servidor somente com a variável, em vez de usar o nome do servidor.

Importante

Em algumas situações, é possível criar uma referência de banco de dados com o mesmo nome de uma referência existente. Duas referências de banco de dados com o mesmo nome podem resultar em comportamento inesperado. Nesse caso, exclua ambas as referências dos bancos de dados.

Procedimentos comuns

Veja a seguir os procedimentos comuns:

Para criar uma referência a um banco de dados no mesmo servidor

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência de Banco de Dados.

  2. Na caixa de diálogo Adicionar Referência de Banco de Dados, especifique o Local do Banco de Dados como Outro banco de dados, mesmo servidor.

  3. Especifique o nome do banco de dados.

  4. Decida se você quer usar uma variável de banco de dados.

  5. Copie o uso de exemplo e cole-o em seu arquivo .sql. No exemplo de uso, altere Schema1 para o nome do seu esquema (por exemplo, [dbo]). Além disso, modifique o nome do objeto do banco de dados de acordo com o seu projeto.

  6. Compile a solução.

Para criar uma referência a um banco de dados em outro servidor

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência de Banco de Dados.

  2. Na caixa de diálogo Adicionar Referência de Banco de Dados, especifique o Local do Banco de Dados como Banco de dados diferente, servidor diferente.

  3. Verifique se o nome do banco de dados está correto.

  4. Decida se você quer usar uma variável de banco de dados.

  5. Especifique o nome do servidor e a variável de servidor.

  6. Copie o uso de exemplo e cole-o em seu arquivo .sql. No exemplo de uso, altere Schema1 para o nome do seu esquema (por exemplo, [dbo]). Além disso, modifique o nome do objeto do banco de dados de acordo com o seu projeto.

  7. Compile a solução.

Para criar um projeto composto

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e selecione Adicionar Referência de Banco de Dados.

  2. Selecione a origem do banco de dados a qual você está fazendo referência (um projeto na solução ou um DACPAC).

  3. Na caixa de diálogo Adicionar Referência de Banco de Dados, especifique o Local do Banco de Dados como Mesmo banco de dados.

  4. Copie o uso de exemplo e cole-o em seu arquivo .sql. No exemplo de uso, altere Schema1 para o nome do seu esquema. Além disso, modifique o nome do objeto do banco de dados de acordo com o seu projeto.

  5. Compile a solução.

Ao publicar esse projeto, você pode implantar projetos compostos na mesma solução em um único destino:

  1. Clique com o botão direito do mouse no nome do projeto no Gerenciador de Soluções e selecione Publicar para exibir a caixa de diálogo Publicar Banco de Dados.

  2. Na caixa de diálogo Publicar Banco de Dados, selecione Avançado.

  3. Na caixa de diálogo Configurações de Publicação Avançadas, verifique se a opção Incluir objetos compostos está selecionada na lista Opções de Implantação Avançadas.

Conteúdo relacionado