ALTER APPLICATION

Modifie les propriétés d’une Snowflake Native App installée. Utilisez ALTER APPLICATION pour mettre à niveau une application vers une version ou un correctif spécifique. Cette commande est également utilisée pour définir d’autres propriétés d’une application.

Voir aussi :

CREATE APPLICATION, DESCRIBE APPLICATION, DROP APPLICATION, SHOW APPLICATIONS

Syntaxe

ALTER APPLICATION [ IF EXISTS ] <name> SET
  [ COMMENT = '<string-literal>' ]
  [ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
  [ DEBUG_MODE = { TRUE | FALSE } ]

ALTER APPLICATION [ IF EXISTS ] <name> UNSET
  [ COMMENT ]
  [ SHARE_EVENTS_WITH_PROVIDER ]
  [ DEBUG_MODE ]

ALTER APPLICATION [ IF EXISTS ] <name> RENAME TO <new_app_name>

ALTER APPLICATION <name> SET FEATURE POLICY <policy_name> [ FORCE ]

ALTER APPLICATION <name> UNSET FEATURE POLICY;

ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER APPLICATION <name> SET SHARED TELEMETRY EVENTS ('<event_definition' [ , <event_definition>, ...])

ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

ALTER APPLICATION <name> UNSET REFERENCES [ ( '<reference_name>' [ , '<reference_alias>' ] ) ]

ALTER APPLICATION <name> UPGRADE

ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]

ALTER APPLICATION <name> UPGRADE USING <path_to_stage>
Copy

Paramètres

name

Spécifie l’identificateur de l’application en cours de modification. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères de différentes casses, toute la chaîne doit être entre guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

SET

Spécifie une (ou plusieurs) propriété(s) à définir pour l’application (séparée(s) par des espaces vides, des virgules ou de nouvelles lignes). Pour plus de détails sur les propriétés que vous pouvez définir, voir CREATE APPLICATION.

COMMENT = '{string}'

Ajoute un commentaire ou remplace un commentaire existant pour l’application.

DEBUG_MODE = { TRUE | FALSE }

Active ou désactive le mode débogage pour le programme d’installation.

  • TRUE active le mode débogage pour le programme d’installation.

  • FALSE désactive le mode débogage pour le programme d’installation.

Vous pouvez définir DEBUG_MODE sur l’app uniquement si les conditions suivantes sont remplies :

  • L’application installée se trouve dans le même compte que le paquet d’application.

  • L’application installée doit avoir été créée en mode développement.

    Le mode développement est installé avec une zone de préparation, une version ou un correctif explicite.

  • Vous disposez des privilèges OWNERSHIP sur l’application installée et votre rôle s’est vu accorder le privilège DEVELOP sur le paquet d’application utilisé pour créer l’application installée.

SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }

Indique s’il faut partager les journaux et les données d’événements avec le fournisseur.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus d’informations sur la spécification des balises dans une instruction, voir Quota de balise pour les objets.

UNSET

Spécifie une (ou plusieurs) propriété(s) et/ou paramètre(s) de session à désactiver pour l’application, ce qui a pour effet de rétablir les valeurs par défaut.

Vous pouvez réinitialiser plusieurs propriétés/paramètres avec une seule instruction ALTER ; cependant, chaque propriété/paramètre doit être séparé(e) par une virgule. Lors de la réinitialisation d’une propriété ou d’un paramètre, spécifiez seulement le nom ; si vous spécifiez une valeur pour la propriété/le paramètre, vous obtiendrez une erreur.

  • COMMENT

  • DEBUG_MODE Désactive le mode débogage pour le programme d’installation. Cette clause est sémantiquement la même que la définition de DEBUG_MODE = FALSE.

  • TAG tag_name [ , tag_name ... ]

  • REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]

    Désactive une référence persistante pour une application. Si aucun argument n’est transmis, annule toutes les références persistantes établies pour l’application.

RENAME TO new_app_name

Spécifie un nouvel identificateur pour l’application. Cet identificateur doit être unique pour votre compte.

SET FEATURE POLICY policy_name [ FORCE ]

Spécifie la politique de fonctions à appliquer à l’application. Si une politique de fonctions est déjà paramétrée sur l’application, vous pouvez utiliser FORCE pour paramétrer la politique de fonctions sans avoir à la désactiver au préalable.

UNSET FEATURE POLICY

Supprime la politique de fonction de l’application. Lorsqu’une politique de fonctions est supprimée d’une application, la politique de fonctions au niveau du compte, si elle existe, est appliquée.

SET SHARED TELEMETRY EVENTS ( 'event_definition' [ , event_definition, ... ] )

Spécifie la définition d’événement facultative à activer pour une application.

SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

Si défini sur TRUE, active toutes les définitions d’événements requises pour une application. Cependant, les définitions d’événements facultatives restent désactivées. Utilisez la clause SET SHARED TELEMETRY EVENTS pour définir des définitions d’événements facultatives pour une application.

Prudence

Après avoir défini cette valeur sur TRUE, vous ne pouvez pas réinitialiser la valeur à FALSE s’il y a des définitions d’événements requises dans l’application.

UNSET REFERENCES[ ( 'reference_name' [ , 'reference_alias' ] ) ]

Supprime les références spécifiées de l’application.

UPGRADE

Met à jour l’application si le fournisseur a publié une nouvelle version ou un correctif pour l’application.

Une application est automatiquement mise à niveau lorsque le fournisseur paramètre la directive de version de l’application. Toutefois, cette commande peut être utilisée pour commencer immédiatement la mise à niveau sans attendre que la mise à niveau automatique ait lieu. Cette commande ne peut être utilisée que sur des applications qui n’ont pas été créées en mode développement. Les applications en mode développement sont installées à partir d’un listing ou sans spécifier de zone de préparation ou de version, et sont principalement destinées à tester le processus de mise à niveau.

UPGRADE USING VERSION version_name [ PATCH patch_num ]

Met à jour l’application vers la version spécifiée. Si patch_num n’est pas spécifié, le dernier correctif est utilisé. Cette commande n’est valable que pour les applications qui ont été installées en spécifiant une version et un correctif.

UPGRADE USING path_to_stage

Met à jour l’application en utilisant des fichiers sur une zone de préparation nommée au chemin spécifié par path_to_stage.

Cette clause ne s’applique que si vous avez installé l’application à partir d’une zone de préparation nommée.

Notes sur l’utilisation

  • Si vous ne spécifiez pas de valeurs pour les paramètres facultatifs, les valeurs de ces paramètres sont obtenues à partir du fichier manifest.yml. Si vous spécifiez des valeurs à la fois dans le manifeste et lors de l’exécution de la commande, les valeurs spécifiées dans la commande sont prioritaires.

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