sys.sql_expression_dependencies (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイントMicrosoft Fabric のウェアハウス

現在のデータベースのユーザー定義エンティティに対する名前による依存関係ごとに 1 行を含みます。 これには、ネイティブ コンパイルのスカラー ユーザー定義関数と、他の SQL Server モジュール間の依存関係が含まれます。 2 つのエンティティ間の依存関係は、一方のエンティティ (参照先エンティティ) の名前が、もう一方のエンティティ (参照元エンティティ) の保存されている SQL 式の中で参照された場合に形成されます。 たとえば、ビューの定義でテーブルが参照されるとき、ビューは参照元エンティティとして、参照先エンティティであるテーブルに依存します。 テーブルが削除されると、ビューは使用できません。

詳しくは、「インメモリ OLTP でのユーザー定義のスカラー関数」をご覧ください。

このカタログ ビューを使用して、次のエンティティの依存関係情報を報告できます。

  • スキーマ バインド エンティティ。

  • 非スキーマ バインド エンティティ。

  • 複数のデータベースやサーバーにまたがるエンティティ。 エンティティ名はレポートされますが、エンティティ ID は解決されません。

  • スキーマ バインド エンティティに対する列レベルの依存関係。 非スキーマ バインド オブジェクトの列レベルの依存関係を返すには、sys.dm_sql_referenced_entities を使用します。

  • サーバー レベル DDL トリガー (マスター データベースのコンテキストの場合)。

列名 データ型 説明
referencing_id int 参照元エンティティの ID。 NULL 値は許可されません。
referencing_minor_id int 参照元エンティティが列の場合は列 ID。それ以外の場合は 0。 NULL 値は許可されません。
referencing_class tinyint 参照元エンティティのクラス。

1 = オブジェクトまたは列

12 = データベース DDL トリガー

13 = サーバー DDL トリガー

NULL 値は許可されません。
referencing_class_desc nvarchar(60) 参照元エンティティのクラスの説明。

OBJECT_OR_COLUMN

DATABASE_DDL_TRIGGER

SERVER_DDL_TRIGGER

NULL 値は許可されません。
is_schema_bound_reference bit 1 = 参照先エンティティがスキーマ バインドです。

0 = 参照先エンティティが非スキーマ バインドです。

NULL 値は許可されません。
referenced_class tinyint 参照先エンティティのクラス。

1 = オブジェクトまたは列

6 = 型

10 = XML スキーマ コレクション

21 = パーティション関数

NULL 値は許可されません。
referenced_class_desc nvarchar(60) 参照先エンティティのクラスの説明。

OBJECT_OR_COLUMN

TYPE

XML_SCHEMA_COLLECTION

PARTITION_FUNCTION

NULL 値は許可されません。
referenced_server_name sysname 参照先エンティティのサーバー名。

この列には、有効な 4 部構成の名前を指定することによって作成された複数サーバーにまたがる依存関係が格納されます。 マルチパート名の詳細については、「Transact-SQL 構文表記規則」を参照してください。

4 部構成の名前を指定せずにエンティティが参照される非スキーマ バインド エンティティの場合は NULL。

スキーマ バインド エンティティの場合は NULL。これらは同じデータベースに存在する必要があるため、2 部構成 (schema.object) の名前だけで定義できます。
referenced_database_name sysname 参照先エンティティのデータベース名。

有効な 3 部構成または 4 部構成の名前を指定することによって作成された複数データベースまたは複数サーバーにまたがる参照については、この列に値が格納されます。

非スキーマ バインド参照の場合は NULL (1 部または 2 部構成の名前を使用して指定されるとき)。

スキーマ バインド エンティティの場合は NULL。これらは同じデータベースに存在する必要があるため、2 部構成 (schema.object) の名前だけで定義できます。
referenced_schema_name sysname 参照先エンティティが属しているスキーマ。

スキーマ名を指定せずにエンティティが参照される非スキーマ バインド参照の場合は NULL。

スキーマ バインド エンティティは 2 つの部分で構成される名前を使用して定義および参照する必要があるので、スキーマ バインド参照の場合、NULL にすることはできません。
referenced_entity_name sysname 参照先エンティティの名前。 NULL 値は許可されません。
referenced_id int 参照先エンティティの ID。 スキーマ バインド参照の場合、この列の値は NULL になりません。 この列の値は、サーバー間参照とデータベース間参照では常に NULL です。

データベース内の参照の場合は NULL (ID が判別できない場合)。 非スキーマ バインド参照は、次の場合には ID を解決できません。

参照先エンティティがデータベースに存在しません。

参照先エンティティのスキーマが呼び出し元に依存し、実行時に解決される。 この場合、is_caller_dependent は 1 に設定されます。
referenced_minor_id int 参照元エンティティが列の場合は参照される列の ID。それ以外の場合は 0。 NULL 値は許可されません。

参照元エンティティの中で列が名前で指定されていた場合、または SELECT * ステートメントの中で親エンティティが使用されていた場合、参照先エンティティは列になります。
is_caller_dependent bit 参照先エンティティのスキーマ バインドが実行時に行われるため、エンティティ ID の解決が呼び出し元のスキーマに依存することを示します。 これが該当するのは、参照先エンティティがストアド プロシージャ、拡張ストアド プロシージャ、または、EXECUTE ステートメント内で呼び出される非スキーマ バインド ユーザー定義関数である場合です。

1 = 参照先エンティティは呼び出し元に依存するため、実行時に解決されます。 この場合、referenced_id は NULL です。

0 = 参照先エンティティ ID は呼び出し元に依存しません。

スキーマ バインド参照のほか、スキーマ名を明示的に指定するデータベース間参照やサーバー間参照の場合は常に 0 になります。 たとえば、EXEC MyDatabase.MySchema.MyProc 形式のエンティティ参照は呼び出し元に依存しません。 ただし、形式が EXEC MyDatabase..MyProc の参照は呼び出し元に依存します。
is_ambiguous bit 参照があいまいであり、実行時には、ユーザー定義関数、ユーザー定義型 (UDT)、または xml 型の列への xquery 参照に解決される可能性があることを示します。

たとえば、ステートメント SELECT Sales.GetOrder() FROM Sales.MySales がストアド プロシージャに定義されているとします。 Sales.GetOrder() が Sales スキーマ内のユーザー定義関数なのか、Sales という名前のメソッドを持つ UDT 型の GetOrder() という名前の列なのかは、ストアド プロシージャが実行されるまで不明です。

1 = 参照があいまいです。

0 = 参照は明確です。つまり、ビューを呼び出したときに、エンティティを正しくバインドできます。

スキーマ バインド参照の場合は常に 0。

解説

次の表に、依存関係情報を作成および管理するエンティティの種類を示します。 ルール、既定値、一時テーブル、一時ストアド プロシージャ、またはシステム オブジェクトに対しては、依存関係情報は作成または管理されません。

注意

Azure Synapse Analytics と Parallel Data Warehouse では、この一覧の中から、テーブル、ビュー、フィルター選択された統計情報、および Transact-SQL ストアド プロシージャのエンティティ型がサポートされます。 依存関係情報は、テーブル、ビュー、およびフィルター選択された統計情報に対してのみ作成および管理されます。

エンティティ型 参照元エンティティ 参照先エンティティ
テーブル はい* はい
表示 はい はい
フィルター選択されたインデックス 可** いいえ
フィルター選択された統計情報 可** いいえ
Transact-SQL ストアド プロシージャ*** はい はい
CLR ストアド プロシージャ (CLR stored procedure) いいえ はい
Transact-SQL ユーザー定義関数 はい はい
CLR ユーザー定義関数 いいえ はい
CLR トリガー (DML および DDL) いいえ いいえ
Transact-SQL DML トリガー はい いいえ
Transact-SQL データベース レベル DDL トリガー はい いいえ
Transact-SQL サーバー レベル DDL トリガー はい いいえ
拡張ストアド プロシージャ いいえ はい
キュー いいえ はい
シノニム いいえ はい
型 (別名および CLR ユーザー定義型) いいえ はい
XML スキーマ コレクション いいえ はい
パーティション関数 いいえ はい

* テーブルが参照元エンティティとして追跡されるのは、計算列、CHECK 制約、または DEFAULT 制約の定義内で、Transact-SQL モジュール、ユーザー定義型、または XML スキーマ コレクションを参照する場合のみです。

** フィルター述語で使用する各列は、参照元エンティティとして追跡されます。

** 整数値が 1 を超える番号付きストアド プロシージャは、参照元エンティティとしても、参照先エンティティとしても追跡されません。

アクセス許可

データベースに対する VIEW DEFINITION 権限およびデータベースの sys.sql_expression_dependencies に対する SELECT 権限が必要です。 既定では、SELECT 権限は db_owner 固定データベース ロールのメンバーだけに与えられます。 SELECT 権限と VIEW DEFINITION 権限が別のユーザーに与えられている場合、権限が許可されているユーザーはデータベース内のすべての依存関係を表示できます。

例

A. 別のエンティティによって参照されるエンティティを返す

次の例では、ビュー Production.vProductAndDescription 内で参照されているテーブルおよび列を取得します。 このビューは、referenced_entity_name 列と referenced_column_name 列に返されるエンティティ (テーブルと列) に依存します。

USE AdventureWorks2022;  
GO  
SELECT OBJECT_NAME(referencing_id) AS referencing_entity_name,   
    o.type_desc AS referencing_description,   
    COALESCE(COL_NAME(referencing_id, referencing_minor_id), '(n/a)') AS referencing_minor_id,   
    referencing_class_desc,  
    referenced_server_name, referenced_database_name, referenced_schema_name,  
    referenced_entity_name,   
    COALESCE(COL_NAME(referenced_id, referenced_minor_id), '(n/a)') AS referenced_column_name,  
    is_caller_dependent, is_ambiguous  
FROM sys.sql_expression_dependencies AS sed  
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id  
WHERE referencing_id = OBJECT_ID(N'Production.vProductAndDescription');  
GO

B. 別のエンティティを参照するエンティティを返す

次の例では、テーブル Production.Product を参照するエンティティを取得します。 referencing_entity_name 列に返されるエンティティは、Product テーブルに依存します。

USE AdventureWorks2022;  
GO  
SELECT OBJECT_SCHEMA_NAME ( referencing_id ) AS referencing_schema_name,  
    OBJECT_NAME(referencing_id) AS referencing_entity_name,   
    o.type_desc AS referencing_description,   
    COALESCE(COL_NAME(referencing_id, referencing_minor_id), '(n/a)') AS referencing_minor_id,   
    referencing_class_desc, referenced_class_desc,  
    referenced_server_name, referenced_database_name, referenced_schema_name,  
    referenced_entity_name,   
    COALESCE(COL_NAME(referenced_id, referenced_minor_id), '(n/a)') AS referenced_column_name,  
    is_caller_dependent, is_ambiguous  
FROM sys.sql_expression_dependencies AS sed  
INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id  
WHERE referenced_id = OBJECT_ID(N'Production.Product');  
GO

C. データベース間の依存関係を返す

次の例は、データベース間のすべての依存関係を返します。 この例は、まずデータベース db1 を作成し、データベース db2 と db3 のテーブルを参照する 2 つのストアド プロシージャを作成します。 次に、sys.sql_expression_dependencies テーブルに対してクエリを実行して、プロシージャとテーブルの間のデータベース間依存関係をレポートします。 参照先エンティティ referenced_schema_name の t3 列に NULL が返されることに注意してください。これは、プロシージャの定義の中でそのエンティティにスキーマ名が指定されていないためです。

CREATE DATABASE db1;  
GO  
USE db1;  
GO  
CREATE PROCEDURE p1 AS SELECT * FROM db2.s1.t1;  
GO  
CREATE PROCEDURE p2 AS  
    UPDATE db3..t3  
    SET c1 = c1 + 1;  
GO  
SELECT OBJECT_NAME (referencing_id),referenced_database_name,   
    referenced_schema_name, referenced_entity_name  
FROM sys.sql_expression_dependencies  
WHERE referenced_database_name IS NOT NULL;  
GO  
USE master;  
GO  
DROP DATABASE db1;  
GO

参照

sys.dm_sql_referenced_entities (Transact-SQL)
sys.dm_sql_referencing_entities (Transact-SQL)