ALTER APPLICATION ROLE¶

Syntaxe¶

ALTER APPLICATION ROLE [ IF EXISTS ] <name> RENAME TO <new_name>

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

ALTER APPLICATION ROLE [ IF EXISTS ] <name> UNSET COMMENT

Paramètres¶

name

Spécifie l’identificateur pour le rôle d’application. 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 new_name

Spécifie le nouvel identificateur pour le rôle d’application. L’identificateur doit être unique au sein de l’application.

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

Notez que lorsque vous spécifiez le nom complet du rôle d’application, vous ne pouvez pas spécifier une application différente. Le nom de l’application, application_name, doit rester le même. Seul le application_role_name peut changer lors d’une opération de renommage.

SET ...

Spécifie les propriétés à définir pour le rôle d’application :

COMMENT = 'string_literal'

Ajoute un commentaire ou remplace un commentaire existant pour le rôle d’application.

UNSET ...

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

• COMMENT

Notes sur l’utilisation¶

• Cette commande ne peut être exécutée que dans le contexte d’une application créée à l’aide du Native Apps Framework.

• Seul le propriétaire du rôle d’application (c’est-à-dire le rôle avec le privilège OWNERSHIP sur le rôle d’application), ou un rôle supérieur, peut exécuter cette commande.

• Renommer un rôle d’application n’est autorisé qu’au sein de la même application.

• 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¶

ALTER APPLICATION ROLE app_role RENAME TO new_app_role;

ALTER APPLICATION ROLE app_role SET
  COMMENT = 'Application role for the Hello Snowflake application.';

ALTER APPLICATION ROLE app_role UNSET COMMENT;