sys.dm_sql_referenced_entities (Transact-SQL)

Gibt eine Zeile für jede benutzerdefinierte Entität aus, auf die in der Definition der angegebenen verweisenden Entität anhand des Namens verwiesen wird. Wenn eine benutzerdefinierte Entität (die Entität, auf die verwiesen wird) namentlich in einem persistenten SQL-Ausdruck einer anderen benutzerdefinierten Entität, der sogenannten verweisenden Entität aufgeführt ist, wird eine Abhängigkeit zwischen den beiden Entitäten erstellt. Handelt es sich beispielsweise bei einer gespeicherten Prozedur um die angegebene verweisende Entität, gibt diese Funktion alle benutzerdefinierten Entitäten zurück, auf die die gespeicherte Prozedur verweist, z. B. Tabellen, Sichten, benutzerdefinierte Typen (UDTs) oder andere gespeicherte Prozeduren.

Verwenden Sie diese dynamische Verwaltungsfunktion, um zu folgenden Entitätstypen, auf die in der verweisenden Entität verwiesen wird, einen Bericht zu erstellen.

• Schemagebundene Entitäten

• Nicht schemagebundene Entitäten

• Datenbankübergreifende und serverübergreifende Entitäten

• Abhängigkeiten auf Spaltenebene von schemagebundenen und nicht schemagebundenen Entitäten

• Benutzerdefinierte Typen (Alias und CLR UDT)

• XML-Schemaauflistungen

• Partitionsfunktionen

Syntax

sys.dm_sql_referenced_entities (
    ' [ schema_name. ] referencing_entity_name ' , ' <referencing_class> ' )

<referencing_class> ::=
{
    OBJECT
  | DATABASE_DDL_TRIGGER
  | SERVER_DDL_TRIGGER
}

Argumente

• [ schema_name. ] referencing_entity_name
  Der Name der verweisenden Entität. schema_name ist erforderlich, wenn die verweisende Klasse OBJECT ist.

  schema_name.referencing_entity_name ist vom Datentyp nvarchar(517).

• <referencing_class> ::= { OBJECT | DATABASE_DDL_TRIGGER   | SERVER_DDL_TRIGGER }
  Klasse der angegebenen verweisenden Entität. Pro Anweisung kann nur eine Klasse angegeben werden.

  <referencing_class> ist vom Datentyp nvarchar(60).

Zurückgegebene Tabelle

Ausnahmen

Gibt unter den folgenden Bedingungen ein leeres Resultset zurück:

• Ein Systemobjekt wird angegeben.

• Die angegebene Entität ist in der Datenbank nicht vorhanden.

• Die angegebene Entität verweist auf keine Entitäten.

• Ein ungültiger Parameter wird übergeben.

Gibt einen Fehler zurück, wenn die angegebene verweisende Entität eine nummerierte gespeicherte Prozedur ist.

Gibt Fehler 2020 zurück, wenn Spaltenabhängigkeiten nicht aufgelöst werden können. Dieser Fehler verhindert nicht, dass die Abfrage Abhängigkeiten auf Objektebene zurückgibt.

Hinweise

Diese Funktion kann im Kontext jeder beliebigen Datenbank ausgeführt werden, um die Entitäten zurückzugeben, die auf einen DDL-Trigger auf Serverebene verweisen.

In der folgenden Tabelle werden die Typen von Entitäten, für die Abhängigkeitsinformationen erstellt und verwaltet werden, aufgelistet. Für Regeln, Standardwerte, temporäre Tabellen, temporär gespeicherte Prozeduren oder Systemobjekte werden keine Abhängigkeitsinformationen erstellt oder verwaltet.

* Eine Tabelle wird nur dann als verweisende Entität aufgezeichnet, wenn sie auf ein Transact-SQL-Modul, einen benutzerdefinierten Typ oder auf eine XML-Schemaauflistung in der Definition einer berechneten Spalte, einer CHECK-Einschränkung oder einer DEFAULT-Einschränkung verweist.

** Nummerierte gespeicherte Prozeduren mit einem ganzzahligen Wert größer als 1 werden weder als verweisende Entität noch als Entität, auf die verwiesen wird, aufgezeichnet.

Berechtigungen

Erfordert die SELECT-Berechtigung für sys.dm_sql_referenced_entities und die VIEW DEFINITION-Berechtigung für die verweisende Entität. Standardmäßig wird die SELECT-Berechtigung der public-Rolle erteilt. Erfordert die Berechtigung VIEW DEFINITION oder ALTER DATABASE DDL TRIGGER für die Datenbank, wenn es sich bei der verweisenden Entität um einen DDL-Trigger auf Datenbankebene handelt. Erfordert die VIEW ANY DEFINITION-Berechtigung für den Server, wenn es sich bei der verweisenden Entität um einen DDL-Trigger auf Serverebene handelt.

Beispiele

A.Zurückgeben von Entitäten, auf die von einem DDL-Trigger auf Datenbankebene verwiesen wird

Im folgenden Beispiel werden die Entitäten (Tabellen und Spalten) zurückgegeben, auf die vom DDL-Trigger auf Datensatzebene ddlDatabaseTriggerLog verwiesen wird.

USE AdventureWorks2012;
GO
SELECT referenced_schema_name, referenced_entity_name, referenced_minor_name, 
    referenced_minor_id, referenced_class_desc
FROM sys.dm_sql_referenced_entities ('ddlDatabaseTriggerLog', 'DATABASE_DDL_TRIGGER');
GO

B.Zurückgeben von Entitäten, auf die von einem Objekt verwiesen wird

Im folgenden Beispiel werden die Entitäten zurückgegeben, auf die von der benutzerdefinierten Funktion dbo.ufnGetContactInformation verwiesen wird.

USE AdventureWorks2012;
GO
SELECT referenced_schema_name, referenced_entity_name, referenced_minor_name, 
    referenced_minor_id, referenced_class_desc, is_caller_dependent, is_ambiguous
FROM sys.dm_sql_referenced_entities ('dbo.ufnGetContactInformation', 'OBJECT');
GO

C.Zurückgeben von Spaltenabhängigkeiten

Im folgenden Beispiel wird die Table1-Tabelle mit der berechneten Spalte c, die als Summe der Spalten a und b definiert ist, erstellt. Anschließend wird die sys.dm_sql_referenced_entities-Sicht aufgerufen. Die Sicht gibt zwei Zeilen zurück: eine für jede in der berechneten Spalte definierte Spalte.

USE AdventureWorks2012;
GO
CREATE TABLE dbo.Table1 (a int, b int, c AS a + b);
GO
SELECT referenced_schema_name AS schema_name,
    referenced_entity_name AS table_name,
    referenced_minor_name AS referenced_column,
    COALESCE(COL_NAME(OBJECT_ID(N'dbo.Table1'),referencing_minor_id), 'N/A') AS referencing_column_name
FROM sys.dm_sql_referenced_entities ('dbo.Table1', 'OBJECT');
GO
-- Remove the table.
DROP TABLE dbo.Table1;
GO

Dies ist das Resultset.

schema_name table_name referenced_column referencing_column

----------- ---------- ----------------- ------------------

dbo         Table1     a                 c

dbo         Table1     b                 c

D.Zurückgeben von nicht schemagebundenen Spaltenabhängigkeiten

Im folgenden Beispiel wird die Table1-Tabelle gelöscht und die Table2-Tabelle sowie die gespeicherte Prozedur Proc1 erstellt. Die Prozedur verweist auf die Table2-Tabelle und auf die nicht vorhandene Table1-Tabelle. Die sys.dm_sql_referenced_entities-Sicht wird mit der gespeicherten Prozedur ausgeführt, die als verweisende Entität angegeben ist. Das Resultset zeigt eine Zeile für Table1 und drei Zeilen für Table2 an. Da Table1 nicht vorhanden ist, können die Spaltenabhängigkeiten nicht aufgelöst werden, und es wird der Fehler 2020 zurückgegeben. Die Spalte is_all_columns_found gibt 0 für Table1 zurück. Damit wird angegeben, dass einige Spalten nicht ermittelt werden konnten.

USE AdventureWorks2012;
GO
IF OBJECT_ID ( 'dbo.Table1', 'U' ) IS NOT NULL 
    DROP TABLE dbo.Table1;
GO
CREATE TABLE dbo.Table2 (c1 int, c2 int);
GO
CREATE PROCEDURE dbo.Proc1 AS
    SELECT a, b, c FROM Table1;
    SELECT c1, c2 FROM Table2;
GO
SELECT referenced_id, referenced_entity_name AS table_name, referenced_minor_name AS referenced_column_name, is_all_columns_found
FROM sys.dm_sql_referenced_entities ('dbo.Proc1', 'OBJECT');
GO

Dies ist das Resultset.

referenced_id table_name   referenced_column_name  is_all_columns_found

------------- ------------ ----------------------- --------------------

935674381     Table2       NULL                    1

935674381     Table2       C1                      1

935674381     Table2       C2                      1

NULL          Table1       NULL                    0

Msg 2020, Level 16, State 1, Line 1The dependencies reported for entity "dbo.Proc1" might not include references to all columns. This is either because the entity references an object that does not exist or because of an error in one or more statements in the entity. Before rerunning the query, ensure that there are no errors in the entity and that all objects referenced by the entity exist.

E.Veranschaulichen der dynamischen Verwaltung von Abhängigkeiten

Das folgende Beispiel stellt eine Erweiterung von Beispiel D dar und zeigt, dass Abhängigkeiten dynamisch verwaltet werden. In dem Beispiel wird zuerst Table1 neu erstellt, die in Beispiel D gelöscht wurde. Anschließend wird sys.dm_sql_referenced_entities mit der als verweisende Entität angegebenen gespeicherten Prozedur erneut ausgeführt. Das Resultset zeigt, dass beide Tabellen zusammen mit den in der gespeicherten Prozedur definierten zugehörigen Spalten zurückgegeben werden. Außerdem gibt die Spalte is_all_columns_found für alle Objekte und Spalten 1 zurück.

USE AdventureWorks2012;
GO
CREATE TABLE Table1 (a int, b int, c AS a + b);
GO 
SELECT referenced_id, referenced_entity_name AS table_name, referenced_minor_name as column_name, is_all_columns_found
FROM sys.dm_sql_referenced_entities ('dbo.Proc1', 'OBJECT');
GO
DROP TABLE Table1, Table2;
DROP PROC Proc1;
GO

Dies ist das Resultset.

referenced_id table_name   referenced_column_name  is_all_columns_found

------------- ------------ ----------------------- --------------------

935674381     Table2       NULL                    1

935674381     Table2       c1                      1

935674381     Table2       c2                      1

967674495     Table1       NULL                    1

967674495     Table1       a                       1

967674495     Table1       b                       1

967674495     Table1       c                       1

F.Zurückgeben von Objekten und Spalten (Verwendung)

Im folgenden Beispiel werden die Objekte und die Spaltenabhängigkeiten der gespeicherten Prozedur HumanResources.uspUpdateEmployeePersonalInfo zurückgegeben. Diese Prozedur aktualisiert die Spalten NationalIDNumber, BirthDate, MaritalStatus und Gender der Employee-Tabelle auf Grundlage eines angegebenen BusinessEntityID-Werts. Eine andere gespeicherte Prozedur, upsLogError, wird in einem Block vom Typ "TRY…CATCH" definiert, um Ausführungsfehler zu erfassen. Die Spalten is_selected, is_updated und is_select_all geben Informationen darüber zurück, wie diese Objekte und Spalten innerhalb des verweisenden Objekts verwendet werden. Die Tabelle und geänderten Spalten werden mit 1 in der Spalte "is_updated" angegeben. Die Spalte BusinessEntityID wird nur ausgewählt und die gespeicherte Prozedur uspLogError wird weder ausgewählt noch geändert.

SELECT referenced_entity_name AS table_name, referenced_minor_name as column_name, is_selected, is_updated, is_select_all
FROM sys.dm_sql_referenced_entities ('HumanResources.uspUpdateEmployeePersonalInfo', 'OBJECT');

Dies ist das Resultset.

table_name    column_name         is_selected is_updated is_select_all

------------- ------------------- ----------- ---------- -------------

uspLogError   NULL                0           0          0

Employee      NULL                0           1          0

Employee      BusinessEntityID    1           0          0

Employee      NationalIDNumber    0           1          0

Employee      BirthDate           0           1          0

Employee      MaritalStatus       0           1          0

Employee      Gender              0           1          0

Siehe auch

Verweis

sys.dm_sql_referencing_entities (Transact-SQL)

sys.sql_expression_dependencies (Transact-SQL)