sys.sql_expressie_afhankelijkheden (Transact-SQL)

Van toepassing op:SQL ServerAzureSQL Managed InstanceAzureSynapse AnalyticsAnalyticsPlatform System (PDW)SQL analytics endpoint in Microsoft FabricWarehousein Microsoft Fabric

Bevat één rij voor elke bijnaam-afhankelijkheid van een door de gebruiker gedefinieerde entiteit in de huidige database. Dit omvat afhankelijkheden tussen native gecompileerde, door de gebruiker gedefinieerde scalair-functies en andere SQL Server-modules. Er ontstaat een afhankelijkheid tussen twee entiteiten wanneer één entiteit, de genoemde entiteit, bij naam verschijnt in een behouden SQL-expressie van een andere entiteit, genaamd de referentie-entiteit. Wanneer bijvoorbeeld een tabel wordt genoemd in de definitie van een view, hangt de view, als referentie-entiteit, af van de tabel, de gerefereerde entiteit. Als de tafel wordt weggelaten, is de weergave onbruikbaar.

Zie Scalaire User-Defined functies voor In-Memory OLTP voor meer informatie.

U kunt deze catalogusweergave gebruiken om afhankelijkheidsinformatie te rapporteren voor de volgende entiteiten:

• Schema-gebonden entiteiten.

• Entiteiten die niet aan schema's gebonden zijn.

• Cross-database en cross-server entiteiten. Entiteitsnamen worden gerapporteerd; echter, entiteits-ID's worden niet opgelost.

• Kolomniveau-afhankelijkheden van schema-gebonden entiteiten. Kolomniveau-afhankelijkheden voor niet-schema-gebonden objecten kunnen worden teruggegeven door gebruik te maken van sys.dm_sql_referenced_entities.

• Serverniveau DDL wordt geactiveerd wanneer deze zich in de context van de master database bevindt.

Remarks

De volgende tabel geeft een overzicht van de typen entiteiten waarvoor afhankelijkheidsinformatie wordt aangemaakt en onderhouden. Afhankelijkheidsinformatie wordt niet aangemaakt of onderhouden voor regels, standaardinstellingen, tijdelijke tabellen, tijdelijke opgeslagen procedures of systeemobjecten.

¹ Een tabel wordt alleen als referentie-entiteit bijgehouden wanneer deze verwijst naar een Transact-SQL module, door de gebruiker gedefinieerd type of XML-schemaverzameling in de definitie van een berekende kolom, CHECK-beperking of DEFAULT constraint.

² Elke kolom die in het filterpredicaat wordt gebruikt, wordt gevolgd als een referentie-entiteit.

³ Genummerde opgeslagen procedures met een geheel getal groter dan 1 worden niet gevolgd als referentie- of referentieentiteit.

Permissions

Vereist VIEW DEFINITION-toestemming op de database en SELECT-toestemming op voor sys.sql_expression_dependencies de database. Select-machtigingen worden standaard alleen verleend aan leden van de db_owner vaste databaserol. Wanneer SELECT- en VIEW DEFINITION-machtigingen worden verleend aan een andere gebruiker, kan de grantee alle afhankelijkheden in de database bekijken.

Examples

A. Returneren entiteiten die door een andere entiteit worden aangeduid

Het volgende voorbeeld geeft de tabellen en kolommen terug die in de weergave Production.vProductAndDescriptionworden genoemd. De weergave hangt af van de entiteiten (tabellen en kolommen) die in de referenced_entity_name en-kolommen referenced_column_name worden teruggegeven.

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. Returneren entiteiten die verwijzen naar een andere entiteit

Het volgende voorbeeld geeft de entiteiten terug die naar de tabel Production.Productverwijzen. De entiteiten die in de kolom worden gegenereerd referencing_entity_name , zijn afhankelijk van de Product tabel.

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. Returneren cross-database afhankelijkheden

Het volgende voorbeeld geeft alle cross-database-afhankelijkheden terug. Het voorbeeld creëert eerst de database db1 en twee opgeslagen procedures die tabellen in de databases en db3refererendb2. De sys.sql_expression_dependencies tabel wordt vervolgens geraadpleegd om de cross-database afhankelijkheden tussen de procedures en de tabellen te rapporteren. NULL wordt teruggegeven in de referenced_schema_name kolom voor de gerefereerde entiteit t3 omdat er geen schemanaam voor die entiteit is gespecificeerd in de definitie van de procedure.

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;

Verwante inhoud

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