Sinônimos (Mecanismo de Banco de Dados)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

Um sinônimo é um objeto de banco de dados que atende aos seguintes propósitos:

• Fornece um nome alternativo para outro objeto do banco de dados referido como o objeto base que pode existir em um servidor local ou remoto.

• Fornece uma camada de abstração que protege um aplicativo cliente de alterações feitas no nome ou local do objeto base.

Por exemplo, considere a tabela Employee de Adventure Works, localizada em um servidor chamado Server1. Para fazer referência a esta tabela em outro servidor, Server2, um aplicativo precisa usar o nome de quatro partes Server1.AdventureWorks.Person.Employee. Além disso, se o local da tabela for alterado, por exemplo, para outro servidor, o aplicativo cliente precisará ser modificado para refletir essa alteração.

Para resolver esses dois problemas, é possível criar um sinônimo, EmpTable, em um esquema dedicado ou existente, RemoteObjects, em Server2 para a tabela Employee em Server1. Agora, o aplicativo cliente só precisa usar o nome de duas partes, RemoteObjects.EmpTable, para fazer referência à tabela Employee em Server1. Além disso, se o local da tabela Employee for alterado, você precisará modificar o sinônimo, EmpTable, para apontar para o novo local da tabela Employee . Como não há instrução ALTER SYNONYM, primeiro é preciso eliminar o sinônimo, RemoteObjects.EmpTable, e depois recriar esse sinônimo com o mesmo nome, mas agora apontando o sinônimo para o novo local da tabela Employee.

Um sinônimo pertence a um esquema e, como outros objetos de um esquema, seu nome precisa ser exclusivo. É possível criar sinônimos para os seguintes objetos de banco de dados:

*Inclui tabelas temporárias locais e globais

Um sinônimo não pode ser o objeto base de outro sinônimo e um sinônimo não pode fazer referência a uma função de agregação definida pelo usuário.

A associação entre um sinônimo e seu objeto base é feita apenas pelo nome. Toda verificação de existência, tipo e permissões no objeto base é adiada até o tempo de execução. Portanto o objeto base pode ser modificado, descartado ou descartado e substituído por outro objeto que tenha o mesmo nome que o objeto base original. Por exemplo, considere um sinônimo, dbo.MyContacts, que faz referência à tabela Person.Contact em Adventure Works. Se a tabela Contact for removida e substituída por uma exibição nomeada Person.Contact, MyContacts agora fará referência à exibição Person.Contact .

Referências a sinônimos não são associadas a esquemas. Portanto, um sinônimo pode ser descartado a qualquer momento. No entanto, ao descartar um sinônimo, você corre o risco de deixar referências pendentes ao sinônimo descartado. Essas referências serão localizadas apenas em tempo de execução.

Sinônimos e esquemas

Se você tiver um esquema padrão do qual você não é o proprietário e desejar criar um sinônimo, deverá qualificar o nome do sinônimo com o nome de um esquema que seja de sua propriedade. Por exemplo, se você possui um esquema S1, mas S2 é seu esquema padrão e vocêr usa a instrução CREATE SYNONYM, deverá prefixar o nome do sinônimo com o esquema S1, em vez de nomear o sinônimo usando um nome de parte única. Para obter mais informações sobre como criar sinônimos, veja CREATE SYNONYM (Transact-SQL).

Concedendo permissões em um sinônimo

Apenas os proprietários de sinônimos, membros de db_owner, ou membros de db_ddladmin podem conceder permissão em um sinônimo.

Você pode GRANT, DENY e REVOKE todas ou qualquer uma das seguintes permissões em um sinônimo:

Usando sinônimos

É possível usar sinônimos em lugar do objeto base referenciado em várias instruções SQL e contextos de expressão. As seguintes colunas contêm uma lista dessas instruções e contextos de expressão:

Quando você está trabalhando com sinônimos nos contextos declarados anteriormente, o objeto base é afetado. Por exemplo, se um sinônimo fizer referência a um objeto base que está em uma tabela e você inserir uma linha no sinônimo, na verdade você estará inserindo uma linha na tabela referida.

É possível usar um sinônimo como o parâmetro da função OBJECT_ID. No entanto, a função retorna a ID do objeto do sinônimo, não o objeto base.

Não é possível fazer referência a um sinônimo em uma instrução DDL. Por exemplo, as instruções a seguir que fazem referência a um sinônimo denominado dbo.MyProductgeram erros:

ALTER TABLE dbo.MyProduct  
   ADD NewFlag int null;  
EXEC ('ALTER TABLE dbo.MyProduct  
   ADD NewFlag int null');  

As instruções de permissão a seguir são associadas apenas ao sinônimo e não ao objeto base:

Sinônimos não são associados a esquemas e, portanto, não podem ser referidos pelos seguintes contextos de expressão associados a esquemas:

Para obter mais informações sobre funções vinculadas a esquemas, consulte Criar funções definidas pelo usuário (Mecanismo de Banco de Dados).

Obtendo informações sobre sinônimos

A exibição do catálogo sys.synonyms contém uma entrada para cada sinônimo em determinado banco de dados. Essa exibição do catálogo expõe metadados de sinônimos, como o nome do sinônimo e o nome do objeto base. Para obter mais informações, confira sinônimos (Transact-SQL).

Usando propriedades estendidas é possível adicionar texto descritivo ou instrucional, máscaras de entrada e regras de formatação como propriedades de um sinônimo. Como a propriedade é armazenada em um banco de dados, todos os aplicativos que leem a propriedade podem avaliar o objeto da mesma maneira. Para obter mais informações, veja sp_addextendedproperty (Transact-SQL).

Para localizar o tipo base do objeto base de um sinônimo, use a função OBJECTPROPERTYEX. Para obter mais informações, confira OBJECTPROPERTYEX (Transact-SQL).

Exemplos

O exemplo a seguir retorna o tipo básico do objeto base de um sinônimo que é um objeto local.

USE tempdb;  
GO
CREATE SCHEMA SynSchema
GO  
CREATE SYNONYM SynSchema.MyEmployee   
FOR AdventureWorks2022.HumanResources.Employee;  
GO  
SELECT OBJECTPROPERTYEX(OBJECT_ID('SynSchema.MyEmployee'), 'BaseType') AS BaseType;  

O exemplo a seguir retorna o tipo básico do objeto base de um sinônimo que é um objeto remoto localizado em um servidor denominado Server1.

EXECUTE sp_addlinkedserver Server1;  
GO  
CREATE SYNONYM SynSchema.MyRemoteEmployee  
FOR Server1.AdventureWorks2022.HumanResources.Employee;  
GO  
SELECT OBJECTPROPERTYEX(OBJECT_ID('MyRemoteEmployee'), 'BaseType') AS BaseType;  
GO  

Conteúdo relacionado

Criar sinônimos
CREATE SYNONYM (Transact-SQL)
DROP SYNONYM (Transact-SQL)