sys.sql_expression_dependencies (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-analysslutpunkt i Microsoft FabricWarehouse i Microsoft Fabric

Innehåller en rad för varje efternamnsberoende för en användardefinierad entitet i den aktuella databasen. Detta omfattar beroenden mellan internt kompilerade, skalära användardefinierade funktioner och andra SQL Server-moduler. Ett beroende mellan två entiteter skapas när en entitet, kallad den refererade entiteten, visas efter namn i ett beständiga SQL-uttryck för en annan entitet som kallas refererande entitet. När en tabell till exempel refereras till i definitionen av en vy beror vyn, som refererande entitet, på tabellen, den refererade entiteten. Om tabellen tas bort är vyn oanvändbar.

Mer information finns i Scalar User-Defined Functions for In-Memory OLTP.

Du kan använda den här katalogvyn för att rapportera beroendeinformation för följande entiteter:

• Schemabundna entiteter.

• Icke-schemabundna entiteter.

• Korsdatabas- och korsserverentiteter. Enhetsnamn rapporteras; dock löses inte entitets-ID:n.

• Beroenden på kolumnnivå för schemabundna entiteter. Beroenden på kolumnnivå för icke-schemabundna objekt kan returneras med hjälp av sys.dm_sql_referenced_entities.

• Servernivå-DDL triggas när den befinner sig i databasens master kontext.

Anmärkningar

I följande tabell visas de typer av entiteter för vilka beroendeinformation skapas och underhålls. Beroendeinformation skapas eller underhålls inte för regler, standardinställningar, temporära tabeller, tillfälliga lagrade procedurer eller systemobjekt.

¹ En tabell spåras som en referensentitet endast när den refererar till en Transact-SQL modul, användardefinierad typ eller XML-schemasamling i definitionen av en beräknad kolumn, CHECK-begränsning eller DEFAULT begränsning.

² Varje kolumn som används i filterpredikatet spåras som en referensentitet.

³ Numrerade lagrade procedurer med ett heltalsvärde större än 1 spåras inte som vare sig en refererande eller refererad entitet.

Behörigheter

Kräver VIEW DEFINITION-behörighet i databasen och SELECT-behörighet på sys.sql_expression_dependencies för databasen. Som standard beviljas SELECT-behörighet endast till medlemmar i den db_owner fasta databasrollen. När SELECT- och VIEW DEFINITION-behörigheter beviljas till en annan användare kan den beviljade användaren visa alla beroenden i databasen.

Exempel

A. Returnera entiteter som refereras av en annan entitet

I följande exempel returneras de tabeller och kolumner som refereras i vyn Production.vProductAndDescription. Vyn beror på vilka entiteter (tabeller och kolumner) som returneras i kolumnerna referenced_entity_name och 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. Returnera entiteter som refererar till en annan entitet

I följande exempel returneras de entiteter som refererar till tabellen Production.Product. De entiteter som returneras i kolumnen referencing_entity_name beror på tabellen 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. Returnera databasöverskridande beroenden

I följande exempel returneras alla beroenden mellan databaser. Exemplet skapar först databasen db1 och två lagrade procedurer som refererar till tabeller i databaserna db2 och db3. Den sys.sql_expression_dependencies tabellen efterfrågas sedan för att rapportera beroenden mellan databaser mellan procedurerna och tabellerna. NULL returneras i referenced_schema_name kolumnen för den refererade entiteten t3 eftersom ett schemanamn inte anges för den entiteten i proceduren definition.

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;

Relaterat innehåll

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