OBJECT_ID (Transact-SQL)
適用対象: 
SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
スキーマ スコープ オブジェクトのデータベース オブジェクト ID 番号を返します。
データ定義言語 (DDL) トリガーなど、スキーマ スコープではないオブジェクトは、 OBJECT_IDを使用してクエリを実行することはできません。 sys.objects カタログ ビューに見つからないオブジェクトの場合は、適切なカタログ ビューに対してクエリを実行して、オブジェクト識別番号を取得します。 たとえば、DDL トリガーのオブジェクト ID 番号を取得するには、SELECT OBJECT_ID FROM sys.triggers WHERE name = 'DatabaseTriggerLog' を使用します。
構文
OBJECT_ID ( ' [ database_name . [ schema_name ] . | schema_name . ]
object_name' [ , 'object_type' ] )
引数
N'object_name'
使用するオブジェクトです。 object_name は varchar または nvarchar です。 object_nameのvarchar値は暗黙的に nvarchar に変換されます。 データベース名とスキーマ名の指定は省略可能です。
N'object_type'
スキーマ スコープのオブジェクト型。 object_type は varchar または nvarchar です。 object_typeのvarchar値は暗黙的に nvarchar に変換されます。 オブジェクトの種類の一覧については、「sys.objects (Transact-SQL)」の type 列を参照してください。
戻り値の型
int
例外
空間インデックスの場合、 OBJECT_ID は NULLを返します。
エラー時に NULL を返します。
ユーザーは、ユーザーが所有しているセキュリティ保護可能なリソース、またはユーザーにアクセス許可が付与されているセキュリティ保護可能なリソースのメタデータのみを表示できます。 つまり、ユーザーがオブジェクトに対するアクセス許可を持っていない場合、 OBJECT_ID などのメタデータ出力の組み込み関数は NULL を返す可能性があります。 詳細については、「 Metadata Visibility Configuration」を参照してください。
解説
システム関数へのパラメーターが省略可能の場合は、現在のデータベース、ホスト コンピューター、サーバー ユーザー、またはデータベース ユーザーが推測されます。 組み込み関数は常にかっこで囲んで従う必要があります。
一時テーブル名を指定する場合、現在のデータベースが tempdbされていない限り、データベース名は一時テーブル名の前に付く必要があります。 次に例を示します。
SELECT OBJECT_ID('tempdb..#mytemptable');
システム関数は、選択リスト、 WHERE 句、および式が許可されている任意の場所で使用できます。 詳しくは、「式 (Transact-SQL)」および「WHERE (Transact-SQL)」をご覧ください。
例
この記事の Transact-SQL コード サンプルは AdventureWorks2022 または AdventureWorksDW2022 サンプル データベースを使用します。このサンプル データベースは、Microsoft SQL Server サンプルとコミュニティ プロジェクトのホーム ページからダウンロードできます。
A. 指定したオブジェクトのオブジェクト ID を返します
次の例では、AdventureWorks2022 データベース内の Production.WorkOrder テーブルのオブジェクト ID を返します。
USE master;
GO
SELECT OBJECT_ID(N'AdventureWorks2022.Production.WorkOrder') AS 'Object ID';
GO
B. オブジェクトが存在することを確認する
次の例では、指定したテーブルにオブジェクト ID があることを確認して、テーブルが存在するかどうかをチェックします。 テーブルが存在する場合は、削除されます。 テーブルが存在しない場合、 DROP TABLE ステートメントは実行されません。
USE AdventureWorks2022;
GO
IF OBJECT_ID (N'dbo.AWBuildVersion', N'U') IS NOT NULL
DROP TABLE dbo.AWBuildVersion;
GO
C: OBJECT_IDを使用してシステム関数パラメーターの値を指定する
次の例では、AdventureWorks2022 データベース内にある Person.Address テーブルのすべてのインデックスとパーティションについて、sys.dm_db_index_operational_stats 関数を使用して情報を返しています。
Note
この構文は、Azure Synapse Analytics のサーバーレス SQL プールでサポートされていません。
パラメーター値を返すために Transact-SQL 関数DB_IDOBJECT_IDを使用する場合は、常に有効な ID が返されることを確認してください。 データベース名またはオブジェクト名が見つからない場合 (存在しない場合やスペルが正しくない場合など)、両方の関数は NULLを返します。 sys.dm_db_index_operational_stats関数は、すべてのデータベースまたはすべてのオブジェクトを指定するワイルドカード値としてNULLを解釈します。 この操作は意図しない可能性があるため、このセクションの例では、データベース ID とオブジェクト ID を安全に判断する方法を示します。
DECLARE @db_id INT;
DECLARE @object_id INT;
SET @db_id = DB_ID(N'AdventureWorks2022');
SET @object_id = OBJECT_ID(N'AdventureWorks2022.Person.Address');
IF @db_id IS NULL
BEGIN
PRINT N'Invalid database';
END;
ELSE IF @object_id IS NULL
BEGIN
PRINT N'Invalid object';
END;
ELSE
BEGIN
SELECT *
FROM [sys].dm_db_index_operational_stats(@db_id, @object_id, NULL, NULL);
END;
GO
例: Azure Synapse Analytics、Analytics Platform System (PDW)
D. 指定したオブジェクトのオブジェクト ID を返します
次の例では、AdventureWorksPDW2022 データベース内の FactFinance テーブルのオブジェクト ID が返されます。
SELECT OBJECT_ID('AdventureWorksPDW2012.dbo.FactFinance') AS 'Object ID';