大网数据广告活动
数据库与应用安全

SQL Server 数据库 — sys.sql_expression_dependencies (TRANSACT-SQL)

· 52CE 我爱测

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

适用对象:yesSQL Server(从 2008 开始)noAzure SQL 数据库yesAzure SQL 数据仓库yes并行数据仓库

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

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

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

  • 绑定到架构的实体。

  • 非绑定到架构的实体。

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

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

  • 服务器级别的 DDL 触发器(在 master 数据库的上下文中时)。

列名 数据类型 Description
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 被引用的实体的服务器的名称。 此列是为通过指定由四个部分组成的有效名称所生成的跨服务器依赖关系填充的。 有关多部分名称的信息,请参阅TRANSACT-SQL 语法约定(TRANSACT-SQL)。 对于非绑定到架构的实体,如果实体被引用时没有指定由四个部分组成的名称,此列为 NULL。 对于绑定到架构的实体为 NULL,因为它们必须在同一数据库中,因此可以仅使用定义两个部分 (schema.object) 名称。
referenced_database_name sysname 被引用的实体的数据库的名称。 此列是为通过指定由三个部分或四个部分组成的有效名称生成的跨数据库或跨服务器引用填充的。 对于非绑定到架构的引用,当使用由一个部分或两个部分组成的名称指定时,此列为 NULL。 对于绑定到架构的实体为 NULL,因为它们必须在同一数据库中,因此可以仅使用定义两个部分 (schema.object) 名称。
referenced_schema_name sysname 被引用的实体所属的架构。 对于非绑定到架构的引用,如果实体被引用时没有指定架构名称,此列为 NULL。 对于绑定到架构的引用,此列永不为 NULL,原因在于必须使用由两部分组成的名称来定义和引用绑定到架构的实体。
referenced_entity_name sysname 被引用的实体的名称。 不可为 null。
referenced_id int 被引用的实体的 ID。 此列的值永远不会为 NULL 的绑定到架构的引用。 此列的值始终为 NULL 的跨服务器和跨数据库引用。 对于数据库内的引用,如果无法确定 ID,则为 NULL。 对于非绑定到架构的引用,在以下情况下将无法解析 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) 或类型的列的 xquery 引用解析xml。 例如,假定语句 SELECT Sales.GetOrder() FROM Sales.MySales 是在存储过程中定义的。 在执行存储过程之前,并不知道 Sales.GetOrder() 是 Sales 架构中的用户定义函数还是带有名为 Sales 的方法、类型为 UDT 且名为 GetOrder() 的列。 1 = 引用不明确。 0 = 引用是明确的,或者在调用视图时可以成功绑定实体。 始终 0 表示架构绑定引用。

备注

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

实体类型 引用实体 被引用的实体
表 是* 用户帐户控制
“查看” 用户帐户控制 用户帐户控制
筛选索引 是** 否
筛选统计信息 是** 否
Transact-SQL 存储过程*** 用户帐户控制 用户帐户控制
CLR 存储过程 否 用户帐户控制
Transact-SQL 用户定义函数 用户帐户控制 用户帐户控制
CLR 用户定义函数 否 用户帐户控制
CLR 触发器(DML 和 DDL) 否 否
Transact-SQL DML 触发器 用户帐户控制 否
Transact-SQL 数据库级 DDL 触发器 用户帐户控制 否
Transact-SQL 服务器级 DDL 触发器 用户帐户控制 否
扩展存储过程 否 用户帐户控制
队列 否 用户帐户控制
同义词 否 用户帐户控制
类型(别名和 CLR 用户定义类型) 否 用户帐户控制
XML 架构集合 否 用户帐户控制
分区函数 否 用户帐户控制

* 仅当它引用时,跟踪表作为引用实体Transact-SQL模块、 用户定义类型或 XML 架构集合定义中的计算的列、 CHECK 约束或 DEFAULT 约束。

** 筛选谓词中使用的每列都作为引用实体进行跟踪。

*** 整数值大于 1 的带编号的存储过程将不会作为引用实体或被引用的实体进行跟踪。

Permissions

要求对数据库具有 VIEW DEFINITION 权限,并对数据库的 sys.sql_expression_dependencies 具有 SELECT 权限。 默认情况下,SELECT 权限仅授予 db_owner 固定数据库角色的成员。 将 SELECT 和 VIEW DEFINITION 权限授予其他用户时,被授权者可以查看数据库中的所有依赖关系。

示例

A. 返回另一实体引用的实体

下例返回在 Production.vProductAndDescription 视图中引用的表和列。 该视图依赖于 referenced_entity_name 和 referenced_column_name 列中返回的实体(表和列)。

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. 返回引用其他实体的实体

下面的示例返回引用表 Production.Product 的实体。 referencing_entity_name 列中返回的实体依赖于 Product 表。

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. 返回跨数据库依赖关系

下面的示例返回所有跨数据库的依赖关系。 此示例首先创建数据库 db1 以及两个引用数据库 db2 和 db3 中的表的存储过程。 然后,对 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)

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 stevestein)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 03/14/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。