OBJECTPROPERTY (Transact-SQL)OBJECTPROPERTY (Transact-SQL)

• 03/15/2017
• • j
  • o
  • O

適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse適用対象:Applies to: SQL ServerSQL Server (サポートされているすべてのバージョン) SQL ServerSQL Server (all supported versions) Azure SQL データベースAzure SQL DatabaseAzure SQL データベースAzure SQL Database Azure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed InstanceAzure SQL Managed Instance Azure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse AnalyticsAzure Synapse Analytics Parallel Data WarehouseParallel Data WarehouseParallel Data WarehouseParallel Data Warehouse

現在のデータベース内のスキーマ スコープ オブジェクトに関する情報を返します。Returns information about schema-scoped objects in the current database. スキーマ スコープ オブジェクトの一覧については、「sys.objects (Transact-SQL)」をご覧ください。For a list of schema-scoped objects, see sys.objects (Transact-SQL). データ定義言語 (DDL) トリガーやイベント通知など、スキーマ スコープ オブジェクト以外のオブジェクトについては、この関数を使用できません。This function cannot be used for objects that are not schema-scoped, such as data definition language (DDL) triggers and event notifications.

Transact-SQL 構文表記規則 Transact-SQL Syntax Conventions

構文Syntax

OBJECTPROPERTY ( id , property )   

引数Arguments

idid
現在のデータベース内のオブジェクトの ID を表す式を指定します。Is an expression that represents the ID of the object in the current database. id のデータ型は int で、現在のデータベース コンテキストでのスキーマ スコープ オブジェクトであることが前提となっています。id is int and is assumed to be a schema-scoped object in the current database context.

propertyproperty
id で指定されるオブジェクトに対して返される情報を表す式です。property は次のいずれかを指定することができます。Is an expression that represents the information to be returned for the object specified by id. property can be one of the following values.

戻り値の型Return Types

intint

例外Exceptions

エラーが発生した場合、または呼び出し元にオブジェクトの表示権限がない場合は、NULL が返されます。Returns NULL on error or if a caller does not have permission to view the object.

ユーザーが所有しているか、または権限を与えられている、セキュリティ保護可能なリソースのメタデータのみを表示できます。A user can only view the metadata of securables that the user owns or on which the user has been granted permission. つまり、オブジェクトに対する権限がユーザーに与えられていない場合、メタデータを生成する組み込み関数 (OBJECTPROPERTY など) が NULL を返す可能性があります。This means that metadata-emitting, built-in functions such as OBJECTPROPERTY may return NULL if the user does not have any permission on the object. 詳細については、「 Metadata Visibility Configuration」を参照してください。For more information, see Metadata Visibility Configuration.

注釈Remarks

データベース エンジンDatabase Engine を前提としています object_id が現在のデータベース コンテキストでします。The データベース エンジンDatabase Engine assumes that object_id is in the current database context. 別のデータベースの object_id を参照するクエリは、NULL または正しくない値を返します。A query that references an object_id in another database will return NULL or incorrect results. たとえば、次のクエリでは、現在のデータベース コンテキストは master データベースです。For example, in the following query the current database context is the master database. データベース エンジンDatabase Engineは、クエリ内で指定されたデータベースではなく、このデータベースの指定された object_id のプロパティ値を返します。The データベース エンジンDatabase Engine will try to return the property value for the specified object_id in that database instead of the database specified in the query. ビュー vEmployee は master データベース内にないため、このクエリでは正しくない結果が返されます。The query returns incorrect results because the view vEmployee is not in the master database.

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

OBJECTPROPERTY(view_id, 'IsIndexable') は、多くのコンピューター リソースを使用する可能性があります。これは、IsIndexable プロパティを評価するために、ビュー定義、正規化、および部分最適化の解析が必要なためです。OBJECTPROPERTY(view_id, 'IsIndexable') may consume significant computer resources because evaluation of IsIndexable property requires the parsing of view definition, normalization, and partial optimization. IsIndexable プロパティではインデックスを作成できるテーブルまたはビューを指定しますが、特定のインデックス キーの要件が満たされない場合、インデックスの実際の作成は失敗します。Although the IsIndexable property identifies tables or views that can be indexed, the actual creation of the index still might fail if certain index key requirements are not met. 詳細については、「CREATE INDEX (Transact-SQL)」を参照してください。For more information, see CREATE INDEX (Transact-SQL).

OBJECTPROPERTY(table_id, 'TableHasActiveFulltextIndex') は、テーブルの少なくとも 1 つの列にインデックスが作成されている場合は、1 (TRUE) を返します。OBJECTPROPERTY(table_id, 'TableHasActiveFulltextIndex') will return a value of 1 (true) when at least one column of a table is added for indexing. インデックス作成で先頭の列が追加されるとすぐ、フルテキスト インデックス作成が自動的にアクティブになります。Full-text indexing becomes active for population as soon as the first column is added for indexing.

テーブルを作成するときに QUOTED IDENTIFIER オプションが OFF に設定されている場合でも、作成されるテーブルのメタデータでは、このオプションは常に ON として格納されます。When a table is created, the QUOTED IDENTIFIER option is always stored as ON in the metadata of the table, even if the option is set to OFF when the table is created. したがって、OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') は常に 1 (TRUE) を返します。Therefore, OBJECTPROPERTY(table_id, 'IsQuotedIdentOn') will always return a value of 1 (true).

例Examples

A.A. オブジェクトがテーブルかどうかを確認するVerifying that an object is a table

次の例では、UnitMeasure が AdventureWorks2012AdventureWorks2012 データベースのテーブルかどうかをテストします。The following example tests whether UnitMeasure is a table in the AdventureWorks2012AdventureWorks2012 database.

USE AdventureWorks2012;  
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.B. スカラー値ユーザー定義関数の決定性を確認するVerifying that a scalar-valued user-defined function is deterministic

次の例では、money 値を返すユーザー定義のスカラー値関数である ufnGetProductDealerPrice が決定的であるかどうかをテストします。The following example tests whether the user-defined scalar-valued function ufnGetProductDealerPrice, which returns a money value, is deterministic.

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

結果セットは、ufnGetProductDealerPrice が決定論的関数でないことを示しています。The result set shows that ufnGetProductDealerPrice is not a deterministic function.

-----  
0

C: 特定のスキーマに属するテーブルを見つけるC: Finding the tables that belong to a specific schema

次の例は、dbo スキーマのすべてのテーブルを返します。The following example returns all the tables in the dbo schema.

-- 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 AnalyticsAzure Synapse Analytics、Parallel Data WarehouseParallel Data WarehouseExamples: Azure Synapse AnalyticsAzure Synapse Analytics and Parallel Data WarehouseParallel Data Warehouse

D: オブジェクトがテーブルかどうかを確認するD: Verifying that an object is a table

次の例では、dbo.DimReseller が AdventureWorksPDW2012AdventureWorksPDW2012 データベースのテーブルかどうかをテストします。The following example tests whether dbo.DimReseller is a table in the AdventureWorksPDW2012AdventureWorksPDW2012 database.

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

関連項目See Also

COLUMNPROPERTY (Transact-SQL) COLUMNPROPERTY (Transact-SQL)
メタデータ関数 (Transact-SQL) Metadata Functions (Transact-SQL)
OBJECTPROPERTYEX (Transact-SQL) OBJECTPROPERTYEX (Transact-SQL)
ALTER AUTHORIZATION (Transact-SQL) ALTER AUTHORIZATION (Transact-SQL)
TYPEPROPERTY (Transact-SQL) TYPEPROPERTY (Transact-SQL)
sys.objects (Transact-SQL)sys.objects (Transact-SQL)