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:
Procedimento armazenado de assembly (CLR)
Função escalar de assembly (CLR)
Procedimento de filtro de replicação
Função SQL escalar
Função SQL com valor de tabela embutida
Exibir
Função com valor de tabela de assembly (CLR)
Funções de agregação de assembly (CLR)
Função SQL com valor de tabela
Procedimento armazenado SQL
Tabela* (definida pelo usuário)
*Inclui tabelas temporárias locais e globais
Observação
Não há suporte para nomes de quatro partes para objetos base de função.
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:
CONTROL
EXECUTE
SELECT
UPDATE
DELETE
INSERT
TAKE OWNERSHIP
VIEW DEFINITION
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:
SELECT
UPDATE
Execute
INSERT
DELETE
Subseleções
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.
Observação
Não é possível fazer referência a um sinônimo localizado em um servidor vinculado.
É 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.MyProduct
geram 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:
GRANT
REVOKE
NEGAR
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:
Restrições CHECK
Expressões padrão
Exibições associadas a esquema
Colunas computadas
Expressões de regra
Funções associadas a esquema
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)