sys.sql_expression_dependencies (Transact-SQL)

適用於：Microsoft Fabric Microsoft網狀架構倉儲中的 SQL Server Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW）SQL 分析端點

針對目前資料庫中使用者定義實體的每個依名稱相依性，各包含一個數據列。 這包括原生編譯、純量使用者定義函式和其他 SQL Server 模組之間的相依性。 當一個稱為 參考實體的實體出現在另一個實體的保存 SQL 運算式中，稱為 參考實體時，就會建立兩個實體之間的相依性。 例如，在檢視定義中參考數據表時，檢視會以參考實體的身分，相依於數據表、參考的實體。 如果卸除數據表，則檢視無法使用。

如需詳細資訊，請參閱記憶體內部 OLTP 的純量使用者定義函數。

您可以使用此目錄檢視來報告下列實體的相依性資訊：

• 架構系結的實體。

• 非架構系結實體。

• 跨資料庫和跨伺服器實體。 報告實體名稱;不過，不會解析實體標識碼。

• 架構系結實體的數據行層級相依性。 非架構系結對象的數據行層級相依性可以使用sys.dm_sql_referenced_entities傳回。

• 在 master 資料庫的內容中時，伺服器層級 DDL 觸發程式。

備註

下表列出建立和維護相依性資訊的實體類型。 不會針對規則、預設值、臨時表、暫存程式或系統物件建立或維護相依性資訊。

* 只有在數據表參考計算數據行、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中的數據表。 sys.sql_expression_dependencies接著會查詢數據表，以報告程式與數據表之間的跨資料庫相依性。 請注意，NULL 會在參考實體referenced_schema_name的數據行中t3傳回，因為程式定義中未指定該實體的架構名稱。

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)