Documentation PostgreSQL 14.22 » Référence » Commandes SQL » ALTER PROCEDURE

Précédent | Niveau supérieur | Suivant
ALTER POLICY | Sommaire | ALTER PUBLICATION

## ALTER PROCEDURE

ALTER PROCEDURE — Modifier la définition d'une procédure

## Synopsis

    ALTER PROCEDURE nom [ ( [ [ mode_arg ] [ nom_arg ] type_arg [, ...] ] ) ]
        action [ ... ] [ RESTRICT ]

    ALTER PROCEDURE nom [ ( [ [ mode_arg ] [ nom_arg ] type_arg [, ...] ] ) ]
        RENAME TO nouveau_nom

    ALTER PROCEDURE nom [ ( [ [ mode_arg ] [ nom_arg ] type_arg [, ...] ] ) ]
        OWNER TO { nouveau_propriétaire | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

    ALTER PROCEDURE nom [ ( [ [ mode_arg ] [ nom_arg ] type_arg [, ...] ] ) ]
        SET SCHEMA nouveau_schema

    ALTER PROCEDURE nom [ ( [ [ mode_arg ] [ nom_arg ] type_arg [, ...] ] ) ]
        [ NO ] DEPENDS ON EXTENSION nom_extension

    où action fait partie de :

        [ EXTERNAL ] SECURITY INVOKER | [ EXTERNAL ] SECURITY DEFINER
        SET paramètre_de_configuration { TO | = } { valeur | DEFAULT }
        SET paramètre_de_configuration FROM CURRENT
        RESET paramètre_de_configuration
        RESET ALL

## Description

`ALTER PROCEDURE` modifie la définition d'une procédure.

Seul le propriétaire de la procédure peut utiliser `ALTER PROCEDURE`. Le droit `CREATE` sur le nouveau schéma est requis pour pouvoir changer le schéma de la procédure. Pour modifier le propriétaire, il est nécessaire d'être membre direct ou indirect du nouveau rôle propriétaire. Ce dernier doit posséder le droit `CREATE` sur le schéma de la procédure. Ces restrictions assurent que la modification du propriétaire n'a pas d'effets autres que ceux obtenus par la suppression et la re-création de la procédure ; toutefois, un super-utilisateur peut modifier le propriétaire de n'importe quelle procédure.

## Paramètres

`nom`

  Le nom d'une procédure existante (éventuellement qualifié par le schéma). Si aucune liste d'arguments n'est spécifiée, le nom doit être unique dans son schéma.

`mode_arg`

  Le mode d'un argument : `IN`, `OUT`, `INOUT`, ou `VARIADIC`. Si non précisé, le défaut est `IN`.

`nom_arg`

  Le nom d'un argument. Notez que `ALTER PROCEDURE` ne fait pas vraiment attention aux noms des arguments, puisqu'il n'a besoin que des types des arguments pour déterminer la procédure.

`type_arg`

  Les types de données des arguments de la procédure (éventuellement qualifiés par le schéma), s'il y en a. Voir DROP PROCEDURE pour les détails sur comment la procédure est recherchée en utilisant les types de données des arguments.

`nouveau_nom`

  Le nouveau nom de la procédure.

`nouveau_propriétaire`

  Le nouveau propriétaire de la procédure. Si cette procédure est marquée `SECURITY DEFINER`, elle s'exécute par la suite sous cette identité.

`nouveau_schema`

  Le nouveau schéma de la procédure.

`nom_extension`

  Cette forme marque la procédure comme dépendante de l'extension, ou comme indépendante de l'extension si `NO` est ajoutée. Une procédure marquée comme dépendante d'une extension est supprimée quand l'extension est supprimée même si la cascade n'est pas explicitement demandée. Une procédure peut dépendre de plusieurs extensions, et ne sera supprimée que quand une de ces extensions est supprimée.

`[ EXTERNAL ] SECURITY INVOKER`
`[ EXTERNAL ] SECURITY DEFINER`

  Précise si la procédure doit être appelée avec les droits de l'utilisateur qui l'a créée. Le mot clé `EXTERNAL`, ignoré, existe pour des raisons de compatibilité SQL. Voir CREATE PROCEDURE pour plus d'informations.

`paramètre_de_configuration`
`valeur`

  Ajoute ou modifie l'initialisation d'un paramètre de configuration lorsque la procédure est appelée. Si `valeur` est `DEFAULT` ou, de façon équivalente, si `RESET` est utilisé, le paramètre local de la procédure est supprimé pour que la procédure s'exécute avec la valeur par défaut du paramètre. Utiliser `RESET ALL` supprime toutes les valeurs spécifiques des paramètres pour cette procédure. `SET FROM CURRENT` sauvegarde la valeur actuelle du paramètre quand `ALTER PROCEDURE` est exécuté comme valeur à appliquer lors de l'exécution de la procédure.

  Voir SET et Chapitre 20 pour plus d'informations sur les noms des paramètres et les valeurs autorisés.

`RESTRICT`

  Ignoré, présent pour des raisons de conformité avec le standard SQL.

## Exemples

Renommer la procédure `insert_data` ayant deux arguments de type `integer` vers `insert_record` :

    ALTER PROCEDURE insert_data(integer, integer) RENAME TO insert_record;

Changer le propriétaire de la procédure `insert_data` ayant deux arguments de type `integer` vers `joe` :

    ALTER PROCEDURE insert_data(integer, integer) OWNER TO joe;

Changer le schéma de la procédure `insert_data` ayant deux arguments de type `integer` vers `accounting` :

    ALTER PROCEDURE insert_data(integer, integer) SET SCHEMA accounting;

Marquer la procédure `insert_data(integer, integer)` comme dépendante de l'extension `myext` :

    ALTER PROCEDURE insert_data(integer, integer) DEPENDS ON EXTENSION myext;

Pour ajuster automatiquement le chemin de recherche des schémas pour une procédure :

    ALTER PROCEDURE check_password(text) SET search_path = admin, pg_temp;

Pour désactiver le paramètre `search_path` d'une procédure :

    ALTER PROCEDURE check_password(text) RESET search_path;

La procédure s'exécutera maintenant avec la valeur de la session pour cette variable.

## Compatibilité

La compatibilité de cette instruction avec l'instruction `ALTER PROCEDURE` du standard SQL est partielle. Le standard autorise la modification d'un plus grand nombre de propriétés d'une procédure mais ne laisse pas la possibilité de renommer une procédure, de placer le commutateur `SECURITY DEFINER` sur la procédure, d'y attacher des valeurs de paramètres ou d'en modifier le propriétaire, le schéma ou la volatilité. Le standard requiert le mot clé `RESTRICT` ; il est optionnel avec PostgreSQL.

## Voir aussi

CREATE PROCEDURE, DROP PROCEDURE, ALTER FUNCTION, ALTER ROUTINE