Utilização de Sinónimos

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do AzureBanco de Dados SQL do Azure Synapse Analyticsno Microsoft Fabric

Um sinônimo é um nome alternativo para um objeto com escopo de esquema. No SMO, os Synonym sinônimos são representados pelo objeto. O Synonym objeto é filho do Database objeto. Isto significa que os sinónimos só são válidos no âmbito da base de dados em que estão definidos. No entanto, o sinônimo pode se referir a objetos em outro banco de dados ou em uma instância remota do SQL Server.

O objeto que recebe um nome alternativo é conhecido como o objeto base. A propriedade name do Synonym objeto é o nome alternativo dado ao objeto base.

Example

Para os exemplos de código a seguir, você terá que selecionar o ambiente de programação, o modelo de programação e a linguagem de programação para criar seu aplicativo. Para obter mais informações, consulte Criar um projeto SMO do Visual C# no Visual Studio .NET.

Criando um sinônimo no Visual C#

O exemplo de código mostra como criar um sinônimo ou um nome alternativo para um objeto com escopo de esquema. Os aplicativos cliente podem usar uma única referência para o objeto base por meio de um sinônimo em vez de usar um nome de várias partes para fazer referência ao objeto base.

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

Criando um sinônimo no PowerShell

O exemplo de código mostra como criar um sinônimo ou um nome alternativo para um objeto com escopo de esquema. Os aplicativos cliente podem usar uma única referência para o objeto base por meio de um sinônimo em vez de usar um nome de várias partes para fazer referência ao objeto 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["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()  

Ver também

CRIAR SINÓNIMO (Transact-SQL)