Używanie synonimów

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL database w usłudze Microsoft Fabric

Synonim jest alternatywną nazwą obiektu o zakresie schematu. W programie SMO synonimy są reprezentowane przez Synonym obiekt . Obiekt Synonym jest elementem podrzędnym Database obiektu. Oznacza to, że synonimy są prawidłowe tylko w zakresie bazy danych, w której są zdefiniowane. Jednak synonim może odwoływać się do obiektów w innej bazie danych lub w zdalnym wystąpieniu programu SQL Server.

Obiekt, który otrzymuje alternatywną nazwę, jest znany jako obiekt podstawowy. Właściwość Synonym name obiektu jest alternatywną nazwą nadaną obiektowi podstawowemu.

Example

W poniższych przykładach kodu należy wybrać środowisko programowania, szablon programowania i język programowania, aby utworzyć aplikację. Aby uzyskać więcej informacji, zobacz Create a Visual C# SMO Project in Visual Studio .NET(Tworzenie projektu SMO w programie Visual Studio .NET).

Tworzenie synonimu w programie Visual C#

W przykładzie kodu pokazano, jak utworzyć synonim lub alternatywną nazwę obiektu o zakresie schematu. Aplikacje klienckie mogą używać pojedynczego odwołania dla obiektu podstawowego za pośrednictwem synonimu zamiast używać wielu nazw części do odwołowania się do obiektu podstawowego.

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

Tworzenie synonimu w programie PowerShell

W przykładzie kodu pokazano, jak utworzyć synonim lub alternatywną nazwę obiektu o zakresie schematu. Aplikacje klienckie mogą używać pojedynczego odwołania dla obiektu podstawowego za pośrednictwem synonimu zamiast używać wielu nazw części do odwołowania się do obiektu podstawowego.

#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()  

Zobacz też

CREATE SYNONIM (Transact-SQL)