CREATE SYNONYM (Transact-SQL)

Crée un nouveau synonyme.

Conventions de syntaxe de Transact-SQL

Syntaxe

CREATE SYNONYM [ schema_name_1. ] synonym_name FOR < object >

< object > :: =
{
    [ server_name.[ database_name ] . [ schema_name_2 ].| database_name . [ schema_name_2 ].| schema_name_2. ] object_name
}

Arguments

• schema_name_1
  Spécifie le schéma dans lequel est créé le synonyme. Si schema n'est pas spécifié, SQL Server 2005 utilise le schéma par défaut de l'utilisateur actif.

• synonym_name
  Nom du nouveau synonyme.

• server_name
  Nom du serveur contenant l'objet de base.

• database_name
  Nom de la base de données contenant l'objet de base. Si la valeur database_name n'est pas spécifiée, le nom de la base de données active est utilisé.

• schema_name_2
  Nom du schéma pour l'objet de base. Si schema_name n'est pas spécifié, le schéma par défaut de l'utilisateur actif est utilisé.

• object_name
  Nom de l'objet de base auquel fait référence le synonyme.

Notes

L'objet de base ne doit pas exister lors de la création du synonyme. SQL Server vérifie l'existence de l'objet de base au cours de l'exécution.

Vous pouvez créer des synonymes pour les types d'objets suivants :

1 Comprend des tables temporaires locales et globales

Les noms en quatre composantes ne sont pas pris en charge pour les objets de base de fonction.

Vous pouvez créer, supprimer et référencer des synonymes dans des instructions SQL dynamiques.

Autorisations

Pour créer un synonyme dans un schéma donné, un utilisateur doit disposer de l'autorisation CREATE SYNONYM, et il doit posséder le schéma ou bénéficier de l'autorisation ALTER SCHEMA.

L'autorisation CREATE SYNONYM est octroyable.

Remarque :
Vous n'avez pas besoin d'une autorisation sur un objet de base pour réussir une compilation de l'instruction CREATE SYNONYM, car toute vérification d'autorisation sur l'objet de base est reportée jusqu'à l'exécution.

A. Création d'un synonyme pour un objet local.

L'exemple suivant crée d'abord un synonyme pour l'objet de base, Product dans la base de données AdventureWorks, puis il interroge le synonyme.

USE tempdb;
GO
-- Create a synonym for the Product table in AdventureWorks.
CREATE SYNONYM MyProduct
FOR AdventureWorks.Production.Product;
GO

-- Query the Product table by using the synonym.
USE tempdb;
GO
SELECT ProductID, Name 
FROM MyProduct
WHERE ProductID < 5;
GO

Voici l'ensemble des résultats.

-----------------------
ProductID   Name                      
----------- --------------------------
1           Adjustable Race
2           Bearing Ball
3           BB Ball Bearing
4           Headset Ball Bearings
(4 row(s) affected)

B. Création d'un synonyme pour un objet distant.

Dans l'exemple suivant, l'objet de base Contact se trouve sur un serveur distant appelé Server_Remote.

EXEC sp_addlinkedserver Server_Remote;
GO
USE tempdb;
GO
CREATE SYNONYM MyEmployee FOR Server_Remote.AdventureWorks.HumanResources.Employee;
GO

Exemples

Voir aussi

Référence

DROP SYNONYM (Transact-SQL)
GRANT (Transact-SQL)
EVENTDATA (Transact-SQL)

Autres ressources

Utilisation des synonymes (moteur de base de données)

Aide et Informations

Assistance sur SQL Server 2005