ALTER TYPE¶

Modifie les propriétés d’un type défini par l’utilisateur existant.

Voir aussi :: CREATE TYPE , DESCRIBE TYPE , SHOW TYPES , DROP TYPE , UNDROP TYPE

Syntaxe¶

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

ALTER TYPE [ IF EXISTS ] <name> UNSET COMMENT

Paramètres¶

name

Indique l’identificateur du type défini par l’utilisateur à 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.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

SET ...

Spécifie les propriétés à définir pour le type défini par l’utilisateur :

COMMENT = 'string_literal': Ajoute un commentaire ou remplace un commentaire existant pour le type défini par l’utilisateur.

UNSET ...

Spécifie les propriétés à désactiver pour le type défini par l’utilisateur, 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 le type défini par l’utilisateur.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :


Privilège	Objet	Remarques
OWNERSHIP	Type défini par l’utilisateur	OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Pour effectuer une opération sur un objet dans un schéma, il est nécessaire de disposer d’au moins un privilège sur la base de données parente et d’au moins un privilège sur le schéma parent.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Concernant les métadonnées :

Attention

Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.

Exemples¶

Ajouter un commentaire au type défini par l’utilisateur age :

ALTER TYPE age SET COMMENT = 'User-defined type for storing age values';

Supprimer le commentaire du type défini par l’utilisateur age :

ALTER TYPE age UNSET COMMENT;