Catégories :

Table, vue et séquence DDL

ALTER SEQUENCE

Modifie les propriétés d’une séquence existante.

Voir aussi :

CREATE SEQUENCE , SHOW SEQUENCES

Syntaxe

ALTER SEQUENCE [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER SEQUENCE [ IF EXISTS ] <name> [ SET ] [ INCREMENT [ BY ] [ = ] <sequence_interval> ]

ALTER SEQUENCE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER SEQUENCE [ IF EXISTS ] <name> UNSET COMMENT

Paramètres

nom

Indique l’identifiant de la séquence à modifier. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

RENAME TO nouveau_nom

Indique le nouvel identificateur de la séquence ; doit être unique pour le schéma.

Pour plus de détails, voir Exigences relatives à l’identificateur.

Lorsqu’un objet est renommé, les autres objets qui le référencent doivent être mis à jour avec le nouveau nom.

SET...

[ INCREMENT [ BY ] intervalle_séquence ]

Spécifie l’intervalle d’incrémentation de la séquence :

  • Pour un intervalle de séquence positif n, les valeurs suivantes n-1 sont réservées par chaque appel de séquence.

  • Pour un intervalle de séquence négatif -n, les valeurs inférieures suivantes n-1 sont réservées par chaque appel de séquence.

Les valeurs prises en charge sont n’importe quelle valeur qui peut être représentée par un entier de compliment de deux de 64 bits. 0 n’est pas autorisé comme intervalle de séquence.

COMMENT = 'litéral_chaine'

Ajoute un commentaire ou remplace un commentaire existant pour la séquence.

UNSET ...

Spécifie les propriétés à désactiver pour le rôle, qui les réinitialise aux valeurs par défaut.

Actuellement, la seule propriété que vous pouvez désactiver est COMMENT, ce qui supprime le commentaire, s’il existe, pour la séquence.

Notes sur l’utilisation

  • La première valeur initiale d’une séquence ne peut pas être modifiée après la création de la séquence.

  • Le déplacement d’une séquence vers un schéma d’accès géré (utilisant la syntaxe ALTER SEQUENCE … RENAME TO) est interdit sauf si le propriétaire de la séquence (c’est-à-dire le rôle qui a le privilège OWNERSHIP sur la séquence) est également propriétaire du schéma cible.

Exemples

Renommer la séquence myseq en newseq :

ALTER SEQUENCE myseq RENAME TO newseq;