Section courante

A propos

Section administrative du site

ALTER FUNCTION

Modifie la fonction
PostgreSQL

Syntaxe

ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] action [ ... ] [ RESTRICT ]
ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] RENAME TO new_name
ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] SET SCHEMA new_schema
ALTER FUNCTION name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ]
DEPENDS ON EXTENSION extension_name

où l'action est l'une des suivantes :

CALLED ON NULL INPUT | RETURNS NULL ON NULL INPUT | STRICT
IMMUTABLE | STABLE | VOLATILE
[ NOT ] LEAKPROOF
[ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
PARALLEL { UNSAFE | RESTRICTED | SAFE }
COST execution_cost
ROWS result_rows
SET configuration_parameter { TO | = } { value | DEFAULT }
SET configuration_parameter FROM CURRENT
RESET configuration_parameter
RESET ALL

Paramètres

Nom Description
name Ce paramètre permet d'indiquer le nom (éventuellement qualifié par le schéma) d'une fonction existante. Si aucune liste de paramètres n'est spécifiée, le nom doit être unique dans son schéma.
argmode Ce paramètre permet d'indiquer le mode d'un paramètre : IN, OUT, INOUT ou VARIADIC. S'il est omis, la valeur par défaut est IN. Notez que ALTER FUNCTION ne prête aucune attention aux paramètres OUT, puisque seuls les paramètres d'entrée sont nécessaires pour déterminer l'identité de la fonction. Il suffit donc de lister les paramètres IN, INOUT et VARIADIC.
argname Ce paramètre permet d'indiquer le nom d'un paramètre. Notez qu'ALTER FUNCTION ne prête aucune attention aux noms des paramètres, puisque seuls les types de données des arguments sont nécessaires pour déterminer l'identité de la fonction.
argtype Ce paramètre permet d'indiquer le(s) type(s) de données des paramètres de la fonction (éventuellement qualifiés de schéma), le cas échéant.
new_name Ce paramètre permet d'indiquer le nouveau nom de la fonction.
new_owner Ce paramètre permet d'indiquer le nouveau propriétaire de la fonction. Notez que si la fonction est marquée SECURITY DEFINER, elle s'exécutera par la suite en tant que nouveau propriétaire.
new_schema Ce paramètre permet d'indiquer le nouveau schéma de la fonction.
extension_name Ce paramètre permet d'indiquer le nom de l'extension dont dépend la fonction.
CALLED ON NULL INPUT Ce paramètre permet de modifier la fonction afin qu'elle soit invoquée lorsque certains ou tous ses paramètres sont nuls.
RETURNS NULL ON NULL INPUT
STRICT
Ces paramètres permet de modifier la fonction afin qu'elle ne soit pas invoquée si l'un de ses paramètres est nul ; à la place, un résultat nul est supposé automatiquement.
IMMUTABLE
STABLE
VOLATILE
Ce paramètre permet de modifier la volatilité de la fonction sur le paramètre spécifié.
[ EXTERNAL ] SECURITY INVOKER
[ EXTERNAL ] SECURITY DEFINER
Ce paramètre permet de modifier si la fonction est un définisseur de sécurité ou non. Le mot clef EXTERNAL est ignoré pour la conformité SQL.
PARALLEL Ce paramètre permet de modifier si la fonction est considérée comme sûre pour le parallélisme.
LEAKPROOF Ce paramètre permet de modifier si la fonction est considérée comme étanche ou non.
COST execution_cost Ce paramètre permet de modifier le coût d'exécution estimé de la fonction.
ROWS Ce paramètre permet de modifier le nombre estimé de lignes renvoyées par une fonction de retour d'ensemble.
configuration_parameter Ce paramètre permet d'indiquer le paramètre de configuration.
value Ce paramètre permet d'ajouter ou de modifier l'affectation à faire à un paramètre de configuration lors de l'appel de la fonction. Si la valeur est DEFAULT ou, de manière équivalente, RESET est utilisé, le paramètre local de fonction est supprimé, de sorte que la fonction s'exécute avec la valeur présente dans son environnement. Utilisez RESET ALL pour effacer tous les paramètres locaux de fonction. SET FROM CURRENT enregistre la valeur du paramètre étant en cours lorsque ALTER FUNCTION est exécuté comme valeur à appliquer lorsque la fonction est entrée.
RESTRICT Ce paramètre permet d'ignorer pour la conformité avec la norme SQL.

Description

Cette instruction permet de changer la définition d'une fonction.



Dernière mise à jour : Jeudi, le 14 Octobre 2021