Using Synonyms

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL-database in Microsoft Fabric Preview

Een synoniem is een alternatieve naam voor een object met schemabereik. In SMO worden synoniemen weergegeven door het Synonym object. Het Synonym object is een onderliggend element van het Database object. Dit betekent dat synoniemen alleen geldig zijn binnen het bereik van de database waarin ze zijn gedefinieerd. Het synoniem kan echter verwijzen naar objecten in een andere database of op een extern exemplaar van SQL Server.

Het object dat een alternatieve naam krijgt, wordt het basisobject genoemd. De naameigenschap van het Synonym object is de alternatieve naam die aan het basisobject wordt gegeven.

Example

Voor de volgende codevoorbeelden moet u de programmeeromgeving, de programmeersjabloon en de programmeertaal selecteren om uw toepassing te maken. Zie Een Visual C# SMO-project maken in Visual Studio .NETvoor meer informatie.

Een synoniem maken in Visual C#

In het codevoorbeeld ziet u hoe u een synoniem of een alternatieve naam maakt voor een object met schemabereik. Clienttoepassingen kunnen één verwijzing voor het basisobject gebruiken via een synoniem in plaats van een naam van meerdere onderdelen te gebruiken om naar het basisobject te verwijzen.

{  
            //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();  
        }  

Een synoniem maken in PowerShell

In het codevoorbeeld ziet u hoe u een synoniem of een alternatieve naam maakt voor een object met schemabereik. Clienttoepassingen kunnen één verwijzing voor het basisobject gebruiken via een synoniem in plaats van een naam van meerdere onderdelen te gebruiken om naar het basisobject te verwijzen.

#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

SYNONIEM MAKEN (Transact-SQL)