Utilisation de synonymes

Un synonyme est un autre nom pour un objet d’étendue de schéma. Dans SMO, les synonymes sont représentés par l’objet Synonym . L’objet Synonym est un enfant de l’objet Database . Cela signifie que les synonymes sont valides uniquement dans la portée de la base de données dans laquelle elles sont définies. Toutefois, le synonyme peut faire référence à des objets sur une autre base de données ou sur une instance distante de SQL Server.

L’objet qui reçoit un autre nom est appelé objet de base. La propriété name de l’objet Synonym est le nom de remplacement donné à l’objet de base.

Exemple :

Pour l’exemple de code suivant, vous devez sélectionner l’environnement de programmation, le modèle de programmation et le langage de programmation pour créer votre application. Pour plus d’informations, consultez Créer un projet SMO Visual Basic dans Visual Studio .NET et créer un projet SMO Visual C# dans Visual Studio .NET.

Création d’un synonyme en Visual Basic

L’exemple de code montre comment créer un synonyme ou un autre nom pour un objet délimité par un schéma. Les applications clientes peuvent utiliser une référence unique pour l’objet de base via un synonyme au lieu d’utiliser un nom de plusieurs parties pour référencer l’objet de base.

Création d’un synonyme dans Visual C#

L’exemple de code montre comment créer un synonyme ou un autre nom pour un objet délimité par un schéma. Les applications clientes peuvent utiliser une référence unique pour l’objet de base via un synonyme au lieu d’utiliser un nom de plusieurs parties pour référencer l’objet de base.

{  
            //Connect to the local, default instance of SQL Server.   
            Server srv = new Server();  
  
            //Reference the AdventureWorks2012 database.   
            Database db = srv.Databases["AdventureWorks2012"];  
  
            //Define a Synonym object variable by supplying the   
            //parent database, name, and schema arguments in the constructor.   
            //The name is also a synonym of the name of the base object.   
            Synonym syn = new Synonym(db, "Shop", "Sales");  
  
            //Specify the base object, which is the object on which   
            //the synonym is based.   
            syn.BaseDatabase = "AdventureWorks2012";  
            syn.BaseSchema = "Sales";  
            syn.BaseObject = "Store";  
            syn.BaseServer = srv.Name;  
  
            //Create the synonym on the instance of SQL Server.   
            syn.Create();  
        }  

Création d’un synonyme dans PowerShell

L’exemple de code montre comment créer un synonyme ou un autre nom pour un objet délimité par un schéma. Les applications clientes peuvent utiliser une référence unique pour l’objet de base via un synonyme au lieu d’utiliser un nom de plusieurs parties pour référencer l’objet de base.

#Get a server object which corresponds to the default instance  
$srv = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Server  
  
#And the database object corresponding to Adventureworks  
$db = $srv.Databases["AdventureWorks2012"]  
  
$syn = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Synonym -ArgumentList $db, "Shop", "Sales"  
  
#Specify the base object, which is the object on which the synonym is based.  
$syn.BaseDatabase = "AdventureWorks2012"  
$syn.BaseSchema = "Sales"  
$syn.BaseObject = "Store"  
$syn.BaseServer = $srv.Name  
  
#Create the synonym on the instance of SQL Server.  
$syn.Create()  

Voir aussi

CREATE SYNONYM (Transact-SQL)