OBJECTPROPERTY (Transact-SQL)

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW) Microsoft Fabric 的 SQL 端點分析 Microsoft Fabric 的倉儲

傳回目前資料庫中結構描述範圍物件的相關資訊。 如需結構描述範圍物件的清單，請參閱 sys.objects (Transact-SQL) (部分機器翻譯)。 不是以結構描述為範圍的物件，如資料定義語言 (DDL) 觸發程序和事件通知，無法使用這項功能。

Transact-SQL 語法慣例 (部分機器翻譯)

語法

OBJECTPROPERTY ( id , property )   

引數

id
這是代表目前資料庫中之物件識別碼的運算式。 id 是 int，假設為目前資料庫內容中的結構描述範圍物件。

property
這個運算式代表 id 指定的物件要傳回的資訊。property 可以是下列值之一。

傳回型別

int

例外狀況

當發生錯誤，或呼叫端沒有檢視物件的權限時，便會傳回 NULL。

權限

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

備註

資料庫引擎假設 object_id 在目前的資料庫內容中。 參考另一資料庫中之 object_id 的查詢會傳回 NULL 或不正確的結果。 例如，在下列查詢中，目前資料庫內容是 master 資料庫。 資料庫引擎會嘗試傳回該資料庫中指定之 object_id 的屬性值，而不是查詢中所指定的資料庫。 查詢會傳回不正確的結果，因為 vEmployee 檢視表不在 master 資料庫中。

USE master;  
GO  
SELECT OBJECTPROPERTY(OBJECT_ID(N'AdventureWorks2022.HumanResources.vEmployee'), 'IsView');  
GO  

OBJECTPROPERTY(view_id, 'IsIndexable') 可能耗用大量電腦資源，因為評估 IsIndexable 屬性需要剖析檢視定義、正規化和部分最佳化。 雖然 IsIndexable 屬性會識別能夠建立索引的資料表或檢視表，但如果不符合特定索引鍵需求，實際建立索引的作業仍可能失敗。 如需詳細資訊，請參閱 CREATE FULLTEXT CATALOG (TRANSACT-SQL)。

當至少加入資料表的一個資料行來建立索引時，OBJECTPROPERTY(table_id, 'TableHasActiveFulltextIndex') 會傳回 1 (true) 這個值。 只要加入第一個用來建立索引的資料行，全文檢索索引作業就會成為使用中，以便擴展。

當建立資料表時，一律會在資料表的中繼資料中，將 QUOTED IDENTIFIER 選項儲存成 ON，即使建立資料表時將選項設成 OFF，也是如此。 因此，OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') 一律會傳回 1 (true) 這個值。

範例

A. 確認物件是資料表

下列範例會測試 UnitMeasure 是否為 AdventureWorks2022 資料庫中的資料表。

USE AdventureWorks2022;  
GO  
IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 1  
   PRINT 'UnitMeasure is a table.'  
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') = 0  
   PRINT 'UnitMeasure is not a table.'  
ELSE IF OBJECTPROPERTY (OBJECT_ID(N'Production.UnitMeasure'),'ISTABLE') IS NULL  
   PRINT 'ERROR: UnitMeasure is not a valid object.';  
GO  

B. 確認純量值使用者定義函數具決定性

下列範例會測試使用者定義的純量值函式 ufnGetProductDealerPrice (會傳回 money 值) 是否具確定性。

USE AdventureWorks2022;  
GO  
SELECT OBJECTPROPERTY(OBJECT_ID('dbo.ufnGetProductDealerPrice'), 'IsDeterministic');  
GO  

結果集會顯示 ufnGetProductDealerPrice 不是具決定性的函數。

-----  
0

C：尋找屬於特定結構描述的資料表

下列範例會傳回 dbo 結構描述中的所有資料表。

-- Uses AdventureWorks  
  
SELECT name, object_id, type_desc  
FROM sys.objects   
WHERE OBJECTPROPERTY(object_id, N'SchemaId') = SCHEMA_ID(N'dbo')  
ORDER BY type_desc, name;  
GO  

範例：Azure Synapse Analytics 與 Analytics Platform System (PDW)

D：驗證物件是資料表

下列範例會測試 dbo.DimReseller 是否為 AdventureWorksPDW2022 資料庫中的資料表。

-- Uses AdventureWorks  
  
IF OBJECTPROPERTY (OBJECT_ID(N'dbo.DimReseller'),'ISTABLE') = 1  
   SELECT 'DimReseller is a table.'  
ELSE   
   SELECT 'DimReseller is not a table.';  
GO  

另請參閱

COLUMNPROPERTY (Transact-SQL)
中繼資料函數 (Transact-SQL)
OBJECTPROPERTYEX (Transact-SQL)
ALTER AUTHORIZATION (Transact-SQL)
TYPEPROPERTY (Transact-SQL)
sys.objects (Transact-SQL)