sys.sql_expression_dependencies (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)ponto de extremidade de análise SQL no Microsoft FabricWarehouse no Microsoft Fabric

Contém uma linha para cada dependência de nome em uma entidade definida pelo usuário no banco de dados atual. Isso inclui dependências entre funções escalares definidas pelo usuário e outros módulos do SQL Server compilados nativamente. Uma dependência entre duas entidades é criada quando uma entidade, chamada entidade referenciada, aparece pelo nome em uma expressão SQL persistente de outra entidade, chamada de entidade de referência . Por exemplo, quando uma tabela é referenciada na definição de um modo de exibição, o modo de exibição, como a entidade de referência, depende da tabela, a entidade referenciada. Se a tabela for descartada, a exibição ficará inutilizável.

Para obter mais informações, consulte Scalar User-Defined Functions for In-Memory OLTP.

Você pode usar essa exibição de catálogo para relatar informações de dependência para as seguintes entidades:

• Entidades vinculadas ao esquema.

• Entidades não vinculadas ao esquema.

• Entidades entre bancos de dados e entre servidores. Os nomes das entidades são relatados; no entanto, os IDs de entidade não são resolvidos.

• Dependências em nível de coluna em entidades ligadas ao esquema. As dependências em nível de coluna para objetos não vinculados ao esquema podem ser retornadas usando sys.dm_sql_referenced_entities.

• DDL no nível do servidor é acionada quando no contexto do banco de dados mestre.

Comentários

A tabela a seguir lista os tipos de entidades para as quais as informações de dependência são criadas e mantidas. As informações de dependência não são criadas ou mantidas para regras, padrões, tabelas temporárias, procedimentos armazenados temporários ou objetos do sistema.

* Uma tabela é rastreada como uma entidade de referência somente quando faz referência a um módulo Transact-SQL, tipo definido pelo usuário ou coleção de esquema XML na definição de uma coluna calculada, restrição CHECK ou restrição DEFAULT.

** Cada coluna usada no predicado do filtro é rastreada como uma entidade de referência.

Os procedimentos armazenados numerados com um valor inteiro maior que 1 não são rastreados como uma entidade referencial ou referenciada.

Permissões

Requer a permissão VIEW DEFINITION no banco de dados e a permissão SELECT no sys.sql_expression_dependencies para o banco de dados. Por padrão, a permissão SELECT é concedida apenas aos membros da função de banco de dados fixa db_owner. Quando as permissões SELECT e VIEW DEFINITION são concedidas a outro usuário, o beneficiário pode exibir todas as dependências no banco de dados.

Exemplos

Um. Entidades que retornam que são referenciadas por outra entidade

O exemplo a seguir retorna as tabelas e colunas referenciadas no modo de exibição Production.vProductAndDescription. A exibição depende das entidades (tabelas e colunas) retornadas nas colunas referenced_entity_name e 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. Entidades que retornam que fazem referência a outra entidade

O exemplo a seguir retorna as entidades que fazem referência à tabela Production.Product. As entidades retornadas na coluna referencing_entity_name dependem da tabela 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. Retornando dependências entre bancos de dados

O exemplo a seguir retorna todas as dependências entre bancos de dados. O exemplo primeiro cria o db1 de banco de dados e dois procedimentos armazenados que fazem referência a tabelas nos bancos de dados db2 e db3. A tabela sys.sql_expression_dependencies é consultada para relatar as dependências entre bancos de dados entre os procedimentos e as tabelas. Observe que NULL é retornado na coluna referenced_schema_name para a entidade referenciada t3 porque um nome de esquema não foi especificado para essa entidade na definição do procedimento.

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  
  

Ver também

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