Using Synonyms

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL-databas i Förhandsversion av Microsoft Fabric

En synonym är ett alternativt namn för ett schemaomfattande objekt. I SMO representeras synonymer av Synonym objektet. Objektet Synonym är underordnat objektet Database . Det innebär att synonymer endast är giltiga inom omfånget för databasen där de definieras. Synonymen kan dock referera till objekt i en annan databas eller på en fjärrinstans av SQL Server.

Objektet som får ett alternativt namn kallas för basobjektet. Namnegenskapen för Synonym objektet är det alternativa namn som ges till basobjektet.

Example

För följande kodexempel måste du välja programmeringsmiljö, programmeringsmall och programmeringsspråket för att skapa ditt program. Mer information finns i Skapa ett Visual C# SMO-projekt i Visual Studio .NET.

Skapa en synonym i Visual C#

Kodexemplet visar hur du skapar en synonym eller ett alternativt namn för ett schemaomfångsobjekt. Klientprogram kan använda en enda referens för basobjektet via en synonym i stället för att använda ett namn med flera delar för att referera till basobjektet.

{  
            //Connect to the local, default instance of SQL Server.   
            Server srv = new Server();  
  
            //Reference the AdventureWorks2022 database.   
            Database db = srv.Databases["AdventureWorks2022"];  
  
            //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 = "AdventureWorks2022";  
            syn.BaseSchema = "Sales";  
            syn.BaseObject = "Store";  
            syn.BaseServer = srv.Name;  
  
            //Create the synonym on the instance of SQL Server.   
            syn.Create();  
        }  

Skapa en synonym i PowerShell

Kodexemplet visar hur du skapar en synonym eller ett alternativt namn för ett schemaomfångsobjekt. Klientprogram kan använda en enda referens för basobjektet via en synonym i stället för att använda ett namn med flera delar för att referera till basobjektet.

#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["AdventureWorks2022"]  
  
$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 = "AdventureWorks2022"  
$syn.BaseSchema = "Sales"  
$syn.BaseObject = "Store"  
$syn.BaseServer = $srv.Name  
  
#Create the synonym on the instance of SQL Server.  
$syn.Create()  

See Also

SKAPA SYNONYM (Transact-SQL)