Kategorien:

DDL für benutzerdefinierte Funktionen, externe Funktionen und gespeicherte Prozeduren

ALTER FUNCTION

Ändert die Eigenschaften für eine vorhandene UDF (benutzerdefinierte Funktion). Derzeit werden nur die folgenden Operationen unterstützt:

  • Umbenennen einer UDF.

  • Konvertieren in eine sichere (oder Zurücksetzen von einer sicheren) UDF.

  • Hinzufügen, Überschreiben, Entfernen eines Kommentars für eine UDF.

Um weitere Änderungen an einer UDF vorzunehmen, müssen Sie die Funktion (mit DROP FUNCTION) löschen und dann neu erstellen.

Siehe auch:

CREATE FUNCTION, SHOW USER FUNCTIONS

Syntax

ALTER FUNCTION [ IF EXISTS ] <name> ( [ <arg_data_type> , ... ] ) RENAME TO <new_name>

ALTER FUNCTION [ IF EXISTS ] <name> ( [ <arg_data_type> , ... ] ) SET { SECURE | COMMENT = '<string_literal>' }

ALTER FUNCTION [ IF EXISTS ] <name> ( [ <arg_data_type> , ... ] ) UNSET { SECURE | COMMENT }

Parameter

Name

Gibt den Bezeichner für die zu ändernde UDF an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Datentyp_des_Arguments [ , ... ]

Gibt den Datentyp der Argumente, falls vorhanden, für die UDF an. Die Argumenttypen sind notwendig, da UDFs die Überladung von Namen unterstützen (d. h. zwei UDFs im gleichen Schema können den gleichen Namen haben), und sie werden verwendet, um die UDF zu identifizieren, die Sie ändern möchten.

RENAME TO neuer_Name

Gibt den neuen Bezeichner für die UDF an. Die Kombination aus dem Bezeichner und den vorhandenen Argumentdatentypen muss für das Schema eindeutig sein.

Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.

Bemerkung

Wenn Sie den neuen Namen für die UDF angeben, verwenden Sie keine Argumentdatentypen oder Klammern, sondern geben Sie nur den neuen Namen an.

Wenn ein Objekt umbenannt wird, müssen andere Objekte, die darauf verweisen, mit dem neuen Namen aktualisiert werden.

SET ...

SECURE

Gibt an, ob eine Funktion sicher ist. Weitere Details dazu finden Sie unter Sichere UDFs.

COMMENT = 'Zeichenfolgenliteral'

Fügt einen Kommentar hinzu oder überschreibt den vorhandenen Kommentar für die UDF. Der von Ihnen angegebene Wert wird in der Spalte DESCRIPTION der Ausgabe SHOW FUNCTIONS und SHOW USER FUNCTIONS angezeigt.

UNSET ...

Gibt die Eigenschaften an, die für die UDF nicht gesetzt werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden.

Beispiele

Benennen Sie die UDF function1 in function2 um:

ALTER FUNCTION IF EXISTS function1(number) RENAME TO function2;

Konvertieren Sie die reguläre UDF function2 in eine sichere UDF:

ALTER FUNCTION IF EXISTS function2(number) SET SECURE;