Anzeigen benutzerdefinierter Funktionen
Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance
Sie können Informationen über die Definition oder die Eigenschaften einer benutzerdefinierten Funktion in SQL Server erhalten, indem Sie SQL Server Management Studio oder Transact-SQL verwenden. Manchmal ist es erforderlich, die Definition einer Funktion anzuzeigen, um zu verstehen, wie die Daten der Funktion aus den Quelltabellen abgeleitet werden, oder um die durch die Funktion definierten Daten anzuzeigen.
Wenn Sie den Namen eines Objekts ändern, auf das eine Funktion verweist, müssen Sie den Text dieser Funktion mit dem neuen Namen aktualisieren. Bevor Sie ein Objekt umbenennen, sollten Sie daher erst die Abhängigkeiten des Objekts anzeigen, um feststellen zu können, ob Funktionen von der beabsichtigten Änderung betroffen sind.
Berechtigungen
Für die Verwendung von sys.sql_expression_dependencies
zur Suche aller Abhängigkeiten von einer Funktion sind die Berechtigung VIEW DEFINITION für die Datenbank und die Berechtigung SELECT auf sys.sql_expression_dependencies
für die Datenbank erforderlich. Systemobjektdefinitionen, wie die in OBJECT_DEFINITION zurückgegebenen Definitionen, sind öffentlich sichtbar.
Verwenden von SQL Server Management Studio
Anzeigen der Eigenschaften einer benutzerdefinierten Funktion
Klicken Sie im Objekt-Explorer auf das Pluszeichen neben der Datenbank mit der Funktion, deren Eigenschaften Sie anzeigen möchten, und klicken Sie dann auf das Pluszeichen, um den Ordner Programmierbarkeit zu erweitern.
Klicken Sie auf das Pluszeichen, um den Ordner Funktionen zu erweitern.
Klicken Sie auf das Pluszeichen, um den Ordner mit der Funktion zu erweitern, deren Eigenschaften Sie anzeigen möchten:
- Table-valued Function
- Skalarwertfunktion
- Aggregatfunktion
Klicken Sie mit der rechten Maustaste auf die Funktion, deren Eigenschaften Sie anzeigen möchten, und wählen Sie Eigenschaftenaus.
Die folgenden Eigenschaften werden im Dialogfeld Funktionseigenschaften - function_name angezeigt.
Funktionsname: Beschreibung Datenbank Name der Datenbank, die diese Funktion enthält. Server Name der aktuellen Serverinstanz. Benutzer Name des Benutzers dieser Verbindung. Erstellungsdatum Zeigt das Datum an, an dem die Funktion erstellt wurde. Ausführen als Ausführungskontext für die Funktion. Name Name der aktuellen Funktion. Schema Zeigt das Schema an, zu dem die Funktion gehört. Systemobjekt Gibt an, ob es sich bei der Funktion um ein Systemobjekt handelt. Gültige Werte sind True
undFalse
.ANSI NULLS Gibt an, ob das Objekt mit der Option ANSI NULLS erstellt wurde. Verschlüsselt Gibt an, ob die Funktion verschlüsselt ist. Gültige Werte sind True
undFalse
.Funktionstyp Typ der benutzerdefinierten Funktion. Bezeichner in Anführungszeichen Gibt an, ob das Objekt mit der Option Bezeichner in Anführungszeichen erstellt wurde. Schema-gebunden Gibt an, ob die Funktion Schema-gebunden ist. Die Werte sind True und False. Informationen zu schemagebundenen Funktionen finden Sie im Abschnitt SCHEMABINDING von CREATE FUNCTION (Transact-SQL).
Verwenden von Transact-SQL
Aufrufen der Definition und der Eigenschaften einer Funktion
Stellen Sie im Objekt-Explorer eine Verbindung mit einer Datenbank-Engine-Instanz her.
Klicken Sie in der Standardleiste auf Neue Abfrage.
Kopieren Sie eines der folgenden Beispiele, fügen Sie es in das Abfragefenster ein, und klicken Sie auf Ausführen.
Im folgenden Codebeispiel werden der Funktionsname, die Definition und die relevanten Eigenschaften abgerufen.
USE AdventureWorks2022; GO -- Get the function name, definition, and relevant properties SELECT sm.object_id, OBJECT_NAME(sm.object_id) AS object_name, o.type, o.type_desc, sm.definition, sm.uses_ansi_nulls, sm.uses_quoted_identifier, sm.is_schema_bound, sm.execute_as_principal_id -- using the two system tables sys.sql_modules and sys.objects FROM sys.sql_modules AS sm JOIN sys.objects AS o ON sm.object_id = o.object_id -- from the function 'dbo.ufnGetProductDealerPrice' WHERE sm.object_id = OBJECT_ID('dbo.ufnGetProductDealerPrice') ORDER BY o.type; GO
Im folgenden Codebeispiel wird die Definition der Beispielfunktion
dbo.ufnGetProductDealerPrice
abgerufen.USE AdventureWorks2022; GO -- Get the definition of the function dbo.ufnGetProductDealerPrice SELECT OBJECT_DEFINITION (OBJECT_ID('dbo.ufnGetProductDealerPrice')) AS ObjectDefinition; GO
Weitere Informationen finden Sie unter sys.sql_modules (Transact-SQL) und OBJECT_DEFINITION (Transact-SQL).
So rufen Sie die Abhängigkeiten einer Funktion ab
Stellen Sie im Objekt-Explorer eine Verbindung mit einer Datenbank-Engine-Instanz her.
Klicken Sie in der Standardleiste auf Neue Abfrage.
Kopieren Sie das folgende Beispiel in das Abfragefenster, und klicken Sie dann auf Ausführen.
USE AdventureWorks2022; GO -- Get all of the dependency information SELECT OBJECT_NAME(sed.referencing_id) AS referencing_entity_name, o.type_desc AS referencing_desciption, COALESCE(COL_NAME(sed.referencing_id, sed.referencing_minor_id), '(n/a)') AS referencing_minor_id, sed.referencing_class_desc, sed.referenced_class_desc, sed.referenced_server_name, sed.referenced_database_name, sed.referenced_schema_name, sed.referenced_entity_name, COALESCE(COL_NAME(sed.referenced_id, sed.referenced_minor_id), '(n/a)') AS referenced_column_name, sed.is_caller_dependent, sed.is_ambiguous -- from the two system tables sys.sql_expression_dependencies and sys.object FROM sys.sql_expression_dependencies AS sed INNER JOIN sys.objects AS o ON sed.referencing_id = o.object_id -- on the function dbo.ufnGetProductDealerPrice WHERE sed.referencing_id = OBJECT_ID('dbo.ufnGetProductDealerPrice'); GO
Weitere Informationen finden Sie unter sys.sql_expression_dependencies (Transact-SQL) und sys.objects (Transact-SQL).