sys.sql_expression_dependencies （Transact-SQL）

适用于：Microsoft Fabric 的 Microsoft Fabric Warehouse 中的 SQL Server Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System （PDW）SQL 分析终结点

当前数据库中用户定义实体的每个按名称依赖项在此表中均占一行。 这包括本机编译的标量用户定义函数和其他 SQL Server 模块之间的依赖关系。 当一个称为“被引用的实体”的实体按名称显示在另一个称为“引用实体”的实体的持久化 SQL 表达式中时，将创建这两个实体之间的依赖关系。 例如，在视图定义中引用表时，作为引用实体的视图将依赖于表这个被引用的实体。 如果删除该表，则该视图不可用。

有关详细信息，请参阅内存中 OLTP 的标量用户定义函数。

您可以使用此目录视图来报告以下实体的依赖关系信息：

• 绑定到架构的实体。

• 非绑定到架构的实体。

• 跨数据库和跨服务器的实体。 实体名称会被报告;但实体ID尚未解决。

• 绑定到架构的实体的列级依赖关系。 可以使用 sys.dm_sql_referenced_entities 返回非绑定到架构的对象的列级依赖关系。

• 服务器级DDL在数据库上下文 master 中触发。

备注

下表列出了为其创建和维护依赖关系信息的实体类型。 依赖信息不会被创建或维护用于规则、默认值、临时表、临时存储过程或系统对象。

¹ 只有当表在计算列、CHECK约束 DEFAULT 或约束的定义中引用 Transact-SQL 模块、用户定义类型或XML模式集合时，才被追踪为引用实体。

² 过滤谓词中使用的每一列都作为引用实体被追踪。

³ 整数值大于 1 的编号存储过程既不作为引用实体也不会被跟踪。

权限

需要 VIEW 数据库的DEFINITION权限和数据库的SELECT权限 sys.sql_expression_dependencies 。 默认情况下，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');

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');

C. 返回跨数据库依赖

下面的示例返回所有跨数据库的依赖关系。 此示例首先创建数据库 db1 以及两个引用数据库 db2 和 db3 中的表的存储过程。 然后，对 sys.sql_expression_dependencies 表进行查询，以报告这两个过程和表之间的跨数据库依赖关系。 NULL由于过程定义中未指定该实体的模式名称，在被引用实体t3的列中返回referenced_schema_name。

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;

相关内容

• sys.dm_sql_referenced_entities（Transact-SQL）
• sys.dm_sql_referencing_entities（Transact-SQL）