CREATE SYNONYM (Transact-SQL)

建立新的同義字。

適用於：SQL Server (SQL Server 2008 透過目前版本)、Windows Azure SQL 資料庫 (初始版本，透過目前版本)。

Transact-SQL 語法慣例

語法

-- SQL Server Syntax

CREATE SYNONYM [ schema_name_1. ] synonym_name FOR <object>

<object> :: =
{
    [ server_name.[ database_name ] . [ schema_name_2 ]. object_name 
  |  database_name . [ schema_name_2 ].| schema_name_2. ] object_name
}

-- Windows Azure SQL Database Syntax

CREATE SYNONYM [ schema_name_1. ] synonym_name FOR < object >

< object > :: =
{
    [database_name. [ schema_name_2 ].| schema_name_2. ] object_name
}

引數

• schema_name_1
  指定建立同義字的結構描述。 如果未指定 schema，SQL Server 會使用目前使用者的預設結構描述。

• synonym_name
  這是新同義字的名稱。

• server_name

  適用於：SQL Server 2008 至 SQL Server 2014。

  這是基底物件所在的伺服器名稱。

• database_name
  這是基底物件所在的資料庫名稱。 如果未指定 database_name，就會使用目前資料庫的名稱。

• schema_name_2
  這是基底物件的結構描述名稱。 如果未指定 schema_name，就會使用目前使用者的預設結構描述。

• object_name
  這是同義字參考的基底物件名稱。

  當 database_name 是目前的資料庫或 database_name 是 tempdb，而且 object_name 開頭為 # 時，Windows Azure SQL Database 支援三部分名稱格式 database_name.[schema_name].object_name。

備註

在建立同義字時，基底物件不需要存在。 SQL Server 會在執行階段檢查基底物件是否存在。

您可以建立下列物件類型的同義字：

組件 (CLR) 預存程序	組件 (CLR) 資料表值函式
組件 (CLR) 純量函數	組件彙總 (CLR) 彙總函式
複寫篩選程序	擴充預存程序
SQL 純量函數	SQL 資料表值函式
SQL 嵌入資料表值函式	SQL 預存程序
檢視表	資料表1 (使用者定義)

1 包括本機和全域暫存資料表

不支援函數基底物件的四部分名稱。

動態 SQL 中的同義字可以建立、卸除和參考。

權限

若要以給定結構描述建立同義字，使用者必須擁有 CREATE SYNONYM 權限，並擁有該結構描述或 ALTER SCHEMA 權限。

CREATE SYNONYM 權限是可授與的權限。

注意

您不需要基底物件的權限，便能夠成功編譯 CREATE SYNONYM 陳述式，因為基底物件的所有權限檢查都會延遲到執行階段。

範例

A.建立本機物件的同義字

下列範例會先建立 AdventureWorks2012 資料庫中之基底物件 Product 的同義字，再查詢這個同義字。

USE tempdb;
GO
-- Create a synonym for the Product table in AdventureWorks2012.
CREATE SYNONYM MyProduct
FOR AdventureWorks2012.Production.Product;
GO

-- Query the Product table by using the synonym.
USE tempdb;
GO
SELECT ProductID, Name 
FROM MyProduct
WHERE ProductID < 5;
GO

以下為結果集：

-----------------------

ProductID Name

----------- --------------------------

1 Adjustable Race

2 Bearing Ball

3 BB Ball Bearing

4 Headset Ball Bearings

(4 row(s) affected)

B.建立遠端物件的同義字

在下列範例中，基底物件 Contact 在名稱為 Server_Remote 的遠端伺服器中。

適用於：SQL Server 2008 至 SQL Server 2014。

EXEC sp_addlinkedserver Server_Remote;
GO
USE tempdb;
GO
CREATE SYNONYM MyEmployee FOR Server_Remote.AdventureWorks2012.HumanResources.Employee;
GO

C.建立使用者定義函數的同義字

下列範例會建立名為 dbo.OrderDozen 的函數，以便將訂單數量增加為平均一打的單位。 然後，此範例會建立 dbo.OrderDozen 函數的同義字 dbo.CorrectOrder。

-- Creating the dbo.OrderDozen function
CREATE FUNCTION dbo.OrderDozen (@OrderAmt int)
RETURNS int
WITH EXECUTE AS CALLER
AS
BEGIN
IF @OrderAmt % 12 <> 0
BEGIN
    SET @OrderAmt +=  12 - (@OrderAmt % 12)
END
RETURN(@OrderAmt);
END;
GO

-- Using the dbo.OrderDozen function
DECLARE @Amt int;
SET @Amt = 15;
SELECT @Amt AS OriginalOrder, dbo.OrderDozen(@Amt) AS ModifiedOrder;

-- Create a synonym dbo.CorrectOrder for the dbo.OrderDozen function.
CREATE SYNONYM dbo.CorrectOrder
FOR dbo.OrderDozen;
GO

-- Using the dbo.CorrectOrder synonym.
DECLARE @Amt int;
SET @Amt = 15;
SELECT @Amt AS OriginalOrder, dbo.CorrectOrder(@Amt) AS ModifiedOrder;

請參閱

參考

DROP SYNONYM (Transact-SQL)

GRANT (Transact-SQL)

EVENTDATA (Transact-SQL)