Umbenennen von benutzerdefinierten FunktionenRename User-defined Functions

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL DatabaseAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaAzure SQL-DatenbankAzure SQL DatabaseYesAzure SQL-DatenbankAzure SQL Database

Sie können benutzerdefinierte Funktionen in SQL Server 2019 (15.x)SQL Server 2019 (15.x) mit SQL Server Management StudioSQL Server Management Studio oder Transact-SQLTransact-SQLumbenennen.You can rename user-defined functions in SQL Server 2019 (15.x)SQL Server 2019 (15.x) by using SQL Server Management StudioSQL Server Management Studio or Transact-SQLTransact-SQL.

In diesem ThemaIn This Topic

VorbereitungenBefore You Begin

EinschränkungenLimitations and Restrictions

  • Funktionsnamen müssen den Regeln für Bezeichnerentsprechen.Function names must comply with the rules for identifiers.

  • Beim Umbenennen einer benutzerdefinierten Funktion wird der Name des entsprechenden Objektnamens in der Definitionsspalte der sys.sql_modules -Katalogsicht nicht geändert.Renaming a user-defined function will not change the name of the corresponding object name in the definition column of the sys.sql_modules catalog view. Daher empfiehlt es sich, diesen Objekttyp nicht umzubenennen.Therefore, we recommend that you do not rename this object type. Löschen Sie die gespeicherte Prozedur stattdessen, und erstellen Sie sie unter dem neuen Namen neu.Instead, drop and re-create the stored procedure with its new name.

  • Das Ändern des Namens oder der Definition einer benutzerdefinierten Funktion kann dazu führen, dass abhängige Objekte einen Fehler erzeugen, wenn die Objekte nicht so aktualisiert wurden, dass sie die Änderungen an der Funktion widerspiegeln.Changing the name or definition of a user-defined function can cause dependent objects to fail when the objects are not updated to reflect the changes that have been made to the function.

SicherheitSecurity

BerechtigungenPermissions

Zum Löschen der Funktion ist entweder die ALTER-Berechtigungen für das Schema, zu dem die Funktion gehört, oder die CONTROL-Berechtigung für die Funktion erforderlich.To drop the function, requires either ALTER permission on the schema to which the function belongs or CONTROL permission on the function. Zum Neuerstellen der Funktion ist die CREATE FUNCTION-Berechtigung in der Datenbank und die ALTER-Berechtigung für das Schema erforderlich, in dem die Funktion erstellt wird.To re-create the function, requires CREATE FUNCTION permission in the database and ALTER permission on the schema in which the function is being created.

Verwenden von SQL Server Management StudioUsing SQL Server Management Studio

So benennen Sie benutzerdefinierte Funktionen umTo rename user-defined functions

  1. Klicken Sie im Objekt-Explorerauf das Pluszeichen neben der Datenbank, in der die Tabelle enthalten ist, die Sie umbenennen möchten.In Object Explorer, click the plus sign next to the database that contains the function you wish to rename and then

  2. Klicken Sie neben dem Ordner Programmierbarkeit auf das Pluszeichen.Click the plus sign next to the Programmability folder.

  3. Klicken Sie neben dem Ordner, der die Funktion enthält, die Sie umbenennen möchten, auf das Pluszeichen:Click the plus sign next to the folder that contains the function you wish to rename:

    • Table-valued FunctionTable-valued Function

    • SkalarwertfunktionScalar-valued Function

    • AggregatfunktionAggregate Function

  4. Klicken Sie mit der rechten Maustaste auf die Funktion, die Sie umbenennen möchten, und wählen Sie die Option Umbenennen.Right-click the function you wish to rename and select Rename.

  5. Geben Sie den neuen Namen der Funktion ein.Enter the function's new name.

Verwenden von Transact-SQLUsing Transact-SQL

So benennen Sie benutzerdefinierte Funktionen umTo rename user-defined functions

Diese Aufgabe kann nicht mit Transact-SQL-Anweisungen ausgeführt werden.This task cannot be performed using Transact-SQL statements. Um eine benutzerdefinierte Funktion mit Transact-SQL umzubenennen, müssen Sie zuerst die vorhandene Funktion löschen und dann unter dem neuen Namen neu erstellen.To rename a user-defined function using Transact-SQL, you must first delete the existing function and then re-create it with the new name. Stellen Sie sicher, dass für den Code und alle Anwendungen, die den alten Namen der Funktion verwendet haben, jetzt der neue Name verwendet wird.Ensure that all code and applications that used the function's old name now use the new name.

Weitere Informationen finden Sie unter CREATE FUNCTION (Transact-SQL) und DROP FUNCTION (Transact-SQL).For more information, see CREATE FUNCTION (Transact-SQL) and DROP FUNCTION (Transact-SQL).

Weitere InformationenSee Also

sys.sql_expression_dependencies (Transact-SQL) sys.sql_expression_dependencies (Transact-SQL)
Anzeigen benutzerdefinierter FunktionenView User-defined Functions