sys.sql_dipendenze_espressioni (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure endpoint di analisi SQL di Azure Synapse Analytics Platform System (PDW) in Microsoft Fabric Warehouse in Microsoft Fabric

Contiene una riga per ogni dipendenza in base al nome in un'entità definita dall'utente nel database corrente. Sono incluse le dipendenze tra funzioni definite dall'utente scalari compilate in modo nativo e altri moduli di SQL Server. Una dipendenza tra due entità viene creata quando un'entità, denominata entità a cui si fa riferimento, viene visualizzata per nome in un'espressione SQL persistente di un'altra entità, denominata entità di riferimento. Ad esempio, quando viene fatto riferimento a una tabella nella definizione di una vista, la vista, ovvero l'entità di riferimento, dipende dalla tabella, ovvero l'entità a cui si fa riferimento. Se la tabella viene eliminata, la vista non è utilizzabile.

Per altre informazioni, vedere Funzioni scalari definite dall'utente per OLTP in memoria.

È possibile utilizzare questa vista del catalogo per creare report relativi alle informazioni sulle dipendenze per le entità seguenti:

• Entità associate a schema.

• Entità non associate a schema.

• Entità tra database e tra server. I nomi delle entità sono riportati; tuttavia, gli ID delle entità non vengono risolti.

• Dipendenze a livello di colonna relative alle entità associate a schema. Le dipendenze a livello di colonna per gli oggetti non associati a schema possono essere restituite tramite sys.dm_sql_referenced_entities.

• Il DDL a livello server si attiva quando si trova nel contesto del master database.

Osservazioni:

Nella tabella seguente sono elencati i tipi di entità per i quali vengono create e gestite le informazioni sulle dipendenze. Le informazioni sulle dipendenze non vengono create o mantenute per regole, impostazioni predefinite, tabelle temporanee, stored procedure temporanee o oggetti di sistema.

¹ Una tabella viene tracciata come entità di riferimento solo quando fa riferimento a un modulo Transact-SQL, a un tipo definito dall'utente o a una collezione di schema XML nella definizione di colonna calcolata, vincolo CHECK o DEFAULT vincolo.

² Ogni colonna utilizzata nel predicato del filtro viene tracciata come entità di riferimento.

³ Le stored procedure numerate con valore intero maggiore di 1 non vengono tracciate né come entità di riferimento né come di riferimento né come entità di riferimento.

Autorizzazioni

Richiede VIEW il permesso DEFINITION sul database e il permesso SELECT attivo sys.sql_expression_dependencies per il database. L'autorizzazione SELECT è concessa per impostazione predefinita solo ai membri del ruolo predefinito del database db_owner . Quando vengono concesse autorizzazioni SELECT e VIEW DEFINITION a un altro utente, l'utente autorizzato può visualizzare tutte le dipendenze nel database.

Esempi

R. Restituire entità che sono citate da un'altra entità

Nell'esempio seguente sono restituite le tabelle e colonne con riferimenti nella vista Production.vProductAndDescription. La vista dipende dalle entità (tabelle e colonne) restituite nelle colonne 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');

B. Restituire entità che fanno riferimento a un'altra entità

Nell'esempio seguente vengono restituite le entità che fanno riferimento alla tabella Production.Product. Le entità restituite nella colonna referencing_entity_name dipendono dalla tabella 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. Restituire dipendenze cross-database

Nell'esempio seguente vengono restituite tutte le dipendenze tra database. L'esempio prima crea il database db1 e due stored procedure che fanno riferimento alle tabelle nei database db2 e db3. Sulla tabella sys.sql_expression_dependencies viene quindi eseguita una query per riportare le dipendenze tra database tra le procedure e le tabelle. NULL viene restituito nella referenced_schema_name colonna per l'entità t3 di riferimento perché un nome di schema non è specificato per quell'entità nella definizione della procedura.

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;

Contenuti correlati

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