sys.sql_expression_dependencies (Transact-SQL)sys.sql_expression_dependencies (Transact-SQL)

• 03/14/2017
• • 
  • 

適用対象: SQL Server Azure SQL Database Azure SQL Data Warehouse Parallel Data Warehouse APPLIES TO: SQL Server Azure SQL Database Azure SQL Data Warehouse Parallel Data Warehouse

ユーザー定義エンティティに対する名前による依存関係ごとに 1 つの行を現在のデータベースに格納します。Contains one row for each by-name dependency on a user-defined entity in the current database. これには、ネイティブコンパイル、スカラーユーザー定義関数、およびそのSQL ServerSQL Server他のモジュール間の依存関係が含まれます。This includes dependences between natively compiled, scalar user-defined functions and other SQL ServerSQL Server modules. 2つのエンティティ間の依存関係は、参照先エンティティと呼ばれる1つのエンティティが、別のエンティティの永続化された SQL 式 (参照元エンティティと呼ばれます) で名前によって表示される場合に作成されます。A dependency between two entities is created when one entity, called the referenced entity, appears by name in a persisted SQL expression of another entity, called the referencing entity. たとえば、ビューの定義内でテーブルが参照されている場合、参照元エンティティであるビューは、参照先エンティティであるテーブルに依存します。For example, when a table is referenced in the definition of a view, the view, as the referencing entity, depends on the table, the referenced entity. テーブルが削除された場合、ビューは使用できなくなります。If the table is dropped, the view is unusable.

詳しくは、「インメモリ OLTP でのユーザー定義のスカラー関数」をご覧ください。For more information, see Scalar User-Defined Functions for In-Memory OLTP.

このカタログ ビューを使用すると、次のエンティティについて依存関係情報をレポートできます。You can use this catalog view to report dependency information for the following entities:

• スキーマ バインド エンティティ。Schema-bound entities.

• 非スキーマ バインド エンティティ。Non-schema-bound entities.

• 複数のデータベースやサーバーにまたがるエンティティ。Cross-database and cross-server entities. エンティティ名はレポートされますが、エンティティ ID は解決されません。Entity names are reported; however, entity IDs are not resolved.

• スキーマ バインド エンティティの列レベルの依存関係。Column-level dependencies on schema-bound entities. スキーマバインドされていないオブジェクトの列レベルの依存関係を返すには、そのエンティティを使用します。Column-level dependencies for non-schema-bound objects can be returned by using sys.dm_sql_referenced_entities.

• サーバーレベルの DDL トリガー (master データベースのコンテキスト内)。Server-level DDL triggers when in the context of the master database.

コメントRemarks

次の表に、依存関係情報が作成および管理されるエンティティの種類を示します。The following table lists the types of entities for which dependency information is created and maintained. ルール、既定値、一時テーブル、一時ストアド プロシージャ、またはシステム オブジェクトについては、依存関係情報は作成も管理もされません。Dependency information is not created or maintained for rules, defaults, temporary tables, temporary stored procedures, or system objects.

*テーブルは、計算列、check 制約、または DEFAULT 制約Transact-SQLTransact-SQLの定義でモジュール、ユーザー定義型、または XML スキーマコレクションを参照している場合にのみ、参照元エンティティとして追跡されます。* A table is tracked as a referencing entity only when it references a Transact-SQLTransact-SQL module, user-defined type, or XML schema collection in the definition of a computed column, CHECK constraint, or DEFAULT constraint.

** フィルター述語で使用する各列は、参照元エンティティとして追跡されます。** Each column used in the filter predicate is tracked as a referencing entity.

*** 1 より大きな整数値を持つ番号付きストアド プロシージャは、参照元エンティティとしても、参照先エンティティとしても追跡されません。*** Numbered stored procedures with an integer value greater than 1 are not tracked as either a referencing or referenced entity.

アクセス許可Permissions

データベースに対する VIEW DEFINITION 権限およびデータベースの sys.sql_expression_dependencies に対する SELECT 権限が必要です。Requires VIEW DEFINITION permission on the database and SELECT permission on sys.sql_expression_dependencies for the database. 既定では、SELECT 権限は db_owner 固定データベース ロールのメンバーだけに与えられます。By default, SELECT permission is granted only to members of the db_owner fixed database role. SELECT 権限と VIEW DEFINITION 権限が別のユーザーに与えられている場合、権限が許可されているユーザーはデータベース内のすべての依存関係を表示できます。When SELECT and VIEW DEFINITION permissions are granted to another user, the grantee can view all dependencies in the database.

使用例Examples

A.A. 別のエンティティによって参照されるエンティティを取得するReturning entities that are referenced by another entity

次の例では、ビュー Production.vProductAndDescription 内で参照されているテーブルおよび列を取得します。The following example returns the tables and columns referenced in the view Production.vProductAndDescription. ビューは、列referenced_entity_nameおよびreferenced_column_name列に返されるエンティティ (テーブルおよび列) によって異なります。The view depends on the entities (tables and columns) returned in the referenced_entity_name and referenced_column_name columns.

USE AdventureWorks2012;  
GO  
SELECT OBJECT_NAME(referencing_id) AS referencing_entity_name,   
    o.type_desc AS referencing_desciption,   
    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.B. 別のエンティティを参照するエンティティを取得するReturning entities that reference another entity

次の例では、テーブル Production.Product を参照するエンティティを取得します。The following example returns the entities that reference the table Production.Product. referencing_entity_name 列に返されるエンティティは、Product テーブルに依存します。The entities returned in the referencing_entity_name column depend on the Product table.

USE AdventureWorks2012;  
GO  
SELECT OBJECT_SCHEMA_NAME ( referencing_id ) AS referencing_schema_name,  
    OBJECT_NAME(referencing_id) AS referencing_entity_name,   
    o.type_desc AS referencing_desciption,   
    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.C. データベース間の依存関係を取得するReturning cross-database dependencies

次の例では、データベース間の依存関係をすべて取得します。The following example returns all cross-database dependencies. この例では、まずdb1データベースを作成し、データベースdb2とdb3のテーブルを参照する2つのストアドプロシージャを作成します。The example first creates the database db1 and two stored procedures that reference tables in the databases db2 and db3. 次に、sys.sql_expression_dependencies テーブルに対してクエリを実行して、プロシージャとテーブルの間のデータベース間依存関係をレポートします。The sys.sql_expression_dependencies table is then queried to report the cross-database dependencies between the procedures and the tables. 参照先エンティティ referenced_schema_name の t3 列に NULL が返されることに注意してください。これは、プロシージャの定義の中でそのエンティティにスキーマ名が指定されていないためです。Notice that NULL is returned in the referenced_schema_name column for the referenced entity t3 because a schema name was not specified for that entity in the definition of the procedure.

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  
  

参照See Also

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