sys.dm_sql_referenced_entities (Transact-SQL)

構文

sys.dm_sql_referenced_entities (
        ' [ schema_name. ] referencing_entity_name ' , ' <referencing_class> ' )

<referencing_class> ::=
{
    OBJECT
  | DATABASE_DDL_TRIGGER
  | SERVER_DDL_TRIGGER
}

引数

• [ schema_name. ] referencing_entity_name
  参照元エンティティの名前です。参照元のクラスが OBJECT の場合、schema_name は必須です。

  schema_name.referencing_entity_name のデータ型は nvarchar(517) です。

• <referencing_class> ::= { OBJECT | DATABASE_DDL_TRIGGER   | SERVER_DDL_TRIGGER }
  指定された参照元エンティティのクラスです。クラスは 1 つのステートメントに 1 つだけ指定できます。

  <referencing_class> のデータ型は nvarchar(60) です。

返されるテーブル

例外

次のいずれかの条件に該当した場合は、空の結果セットが返されます。

• システム オブジェクトが指定されている。

• 指定されたエンティティが現在のデータベースに存在しない。

• 指定されたエンティティがいずれのエンティティも参照しない。

• 無効なパラメータが渡される。

指定された参照元エンティティが番号付きストアド プロシージャの場合は、エラーが返されます。

列の依存関係を解決できない場合は、エラー 2020 が返されます。このエラーによって、クエリからオブジェクト レベルの依存関係が返されなくなることはありません。詳細については、「SQL の依存関係のトラブルシューティング」を参照してください。

説明

この関数は、サーバー レベルの DDL トリガを参照するエンティティを取得するために、任意のデータベースのコンテキストで実行できます。

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

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

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

詳細については、「SQL の依存関係について」を参照してください。

権限

sys.dm_sql_referenced_entities に対する SELECT 権限および参照元エンティティに対する VIEW DEFINITION 権限が必要です。既定では、SELECT 権限が public に与えられます。参照元エンティティがデータベース レベルの DDL トリガである場合は、データベースに対する VIEW DEFINITION 権限またはデータベースに対する ALTER DATABASE DDL TRIGGER 権限が必要です。参照元エンティティがサーバー レベルの DDL トリガである場合は、サーバーに対する VIEW ANY DEFINITION 権限が必要です。

使用例

A. データベース レベルの DDL トリガによって参照されるエンティティを取得する

USE AdventureWorks;
GO
SELECT referenced_schema_name, referenced_entity_name, referenced_minor_name, 
    referenced_minor_id, referenced_class_desc
FROM sys.dm_sql_referenced_entities ('ddlDatabaseTriggerLog', 'DATABASE_DDL_TRIGGER');
GO

B. オブジェクトによって参照されるエンティティを取得する

USE AdventureWorks;
GO
SELECT referenced_schema_name, referenced_entity_name, referenced_minor_name, 
    referenced_minor_id, referenced_class_desc, is_caller_dependent, is_ambiguous
FROM sys.dm_sql_referenced_entities ('dbo.ufnGetContactInformation', 'OBJECT');
GO

C. 列の依存関係を取得する

USE AdventureWorks;
GO
CREATE TABLE dbo.Table1 (a int, b int, c AS a + b);
GO
SELECT referenced_schema_name AS schema_name,
    referenced_entity_name AS table_name,
    referenced_minor_name AS referenced_column,
    COALESCE(COL_NAME(OBJECT_ID(N'dbo.Table1'),referencing_minor_id), 'N/A') AS referencing_column_name
FROM sys.dm_sql_referenced_entities ('dbo.Table1', 'OBJECT');
GO
-- Remove the table.
DROP TABLE dbo.Table1;
GO

D. 非スキーマ バインド列の依存関係を取得する

USE AdventureWorks;
GO
IF OBJECT_ID ( 'dbo.Table1', 'U' ) IS NOT NULL 
    DROP TABLE dbo.Table1;
GO
CREATE TABLE dbo.Table2 (c1 int, c2 int);
GO
CREATE PROCEDURE dbo.Proc1 AS
    SELECT a, b, c FROM Table1;
    SELECT c1, c2 FROM Table2;
GO
SELECT referenced_id, referenced_entity_name AS table_name, referenced_minor_name AS referenced_column_name
FROM sys.dm_sql_referenced_entities ('dbo.Proc1', 'OBJECT');
GO

E. 依存関係の動的管理

USE AdventureWorks;
GO
CREATE TABLE Table1 (a int, b int, c AS a + b);
GO 
SELECT referenced_id, referenced_entity_name AS table_name, referenced_minor_name as column_name
FROM sys.dm_sql_referenced_entities ('dbo.Proc1', 'OBJECT');
GO
DROP TABLE Table1, Table2;
DROP PROC Proc1;
GO

変更履歴

関連項目

タスク

参照

概念