OBJECT_SCHEMA_NAME (Transact-SQL)

發行項
10/16/2024

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics

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

注意

只有 Azure Synapse Analytics 中的專用 SQL 集區才支援 OBJECT_SCHEMA_NAME 函數。

語法

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。如需相關資訊，請參閱 Metadata Visibility Configuration。

權限

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

備註

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

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

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

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

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

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

範例

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

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體

下列範例會針對不是特定或準備陳述式的所有快取查詢計畫，傳回物件結構描述名稱、物件名稱和 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. 傳回三段式物件名稱

下列範例會傳回目前資料庫內容中所有物件的資料庫、結構描述和物件名稱。

SELECT QUOTENAME(DB_NAME(db_id()))   
    + N'.'   
    + QUOTENAME(OBJECT_SCHEMA_NAME(object_id, db_id()))   
    + N'.'   
    + QUOTENAME(OBJECT_NAME(object_id, db_id()))  
    , *   
FROM sys.objects;
GO

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