OBJECT_SCHEMA_NAME (Transact-SQL)

發行項
03/07/2014

傳回結構描述範圍物件的資料庫結構描述名稱。如需以結構描述範圍物件的清單，請參閱＜sys.objects (Transact-SQL)＞。

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

語法

OBJECT_SCHEMA_NAME ( object_id [, database_id ] )

引數

object_id
這是所要使用的物件識別碼。 object_id 是 int，而且會假設為指定資料庫或目前資料庫內容中的結構描述範圍物件。
database_id
這是要在其中查閱物件之資料庫的識別碼。 database_id 是 int。

傳回類型

sysname

例外狀況

當發生錯誤，或呼叫端沒有檢視物件的權限時，便會傳回 NULL。如果目標資料庫將 AUTO_CLOSE 選項設為 ON，函數會開啟資料庫。

使用者只能檢視使用者擁有或被授與某些權限之安全性實體的中繼資料。這表示發出中繼資料的內建函數 (例如 OBJECT_SCHEMA_NAME) 會在使用者不具有該物件任何權限時傳回 NULL。如需詳細資訊，請參閱＜中繼資料可見性組態＞。

權限

需要物件的 ANY 權限。若要指定資料庫識別碼，也需要資料庫的 CONNECT 權限，或必須啟用 Guest 帳戶。

備註

系統函數可以用於選取清單、WHERE 子句以及任何可以使用運算式的位置。如需詳細資訊，請參閱＜運算式＞和＜WHERE＞。

這個系統函數傳回的結果集會使用目前資料庫的定序。

如果未指定 database_id，SQL Server Database Engine 會假設 object_id 在目前資料庫的內容中。參考另一資料庫中之 object_id 的查詢會傳回 NULL 或不正確的結果。例如，在下列查詢中，目前資料庫內容便是 AdventureWorks2012。 Database Engine 會嘗試傳回這個資料庫 (而不是查詢之 FROM 子句中所指定的資料庫) 中指定之物件識別碼的物件結構描述名稱。因此，會傳回不正確的資訊。

SELECT DISTINCT OBJECT_SCHEMA_NAME(object_id)
FROM master.sys.objects;

下列範例會在 OBJECT_SCHEMA_NAME 中指定 master 資料庫的資料庫識別碼，並傳回正確的結果。

SELECT DISTINCT OBJECT_SCHEMA_NAME(object_id, 1) AS schema_name
FROM master.sys.objects;

範例

A.傳回物件結構描述名稱和物件名稱

下列範例會針對不是特定或準備陳述式的所有快取查詢計劃，傳回物件結構描述名稱、物件名稱和 SQL 文字。

SELECT DB_NAME(st.dbid) AS database_name, 
    OBJECT_SCHEMA_NAME(st.objectid, st.dbid) AS schema_name,
    OBJECT_NAME(st.objectid, st.dbid) AS object_name, 
    st.text AS query_statement
FROM sys.dm_exec_query_stats AS qs
CROSS APPLY sys.dm_exec_sql_text(qs.sql_handle) AS st
WHERE st.objectid IS NOT NULL;
GO

B.傳回三部分物件名稱

下列範例會針對所有資料庫中的所有物件，傳回資料庫、結構描述和物件名稱，以及 sys.dm_db_index_operational_stats 動態管理檢視中的所有其他資料行。

SELECT QUOTENAME(DB_NAME(database_id)) 
    + N'.' 
    + QUOTENAME(OBJECT_SCHEMA_NAME(object_id, database_id)) 
    + N'.' 
    + QUOTENAME(OBJECT_NAME(object_id, database_id))
    , * 
FROM sys.dm_db_index_operational_stats(null, null, null, null);
GO