ALTER APPLICATION

Modifie les propriétés d’une application installée dans le Native Apps Framework. Utilisez ALTER APPLICATION pour mettre à niveau une application installée vers une version ou un correctif spécifique. Cette commande est également utilisée pour activer ou désactiver le mode de débogage 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 <name> UPGRADE

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

 ALTER APPLICATION <name> UPGRADE USING <path_to_stage>

 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> UNSET REFERENCES[ ( '<reference_name>' [ , '<reference_alias>' ] ) ]
Copy

Paramètres

name

Spécifie l’identificateur pour l’application en cours de modification. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, toute la chaîne doit être délimitée par des 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ées par des espaces, 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 l’application installée.

  • TRUE active le mode débogage pour l’application installée.

  • FALSE désactive le mode débogage pour l’application installée.

Vous ne pouvez définir DEBUG_MODE sur l’application que 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 Quotas de balises pour les objets et les colonnes.

UPGRADE

Effectue une mise à niveau de l’application si le fournisseur de l’application a indiqué que l’instance devait être mise à niveau.

Une application sera automatiquement mise à niveau lorsque le fournisseur aura indiqué qu’elle doit l’être, mais cette commande peut être utilisée pour que la mise à niveau ait lieu immédiatement, sans attendre la mise à niveau automatique. Cette commande ne peut être utilisée que sur des applications qui ne sont pas en mode développement, qui sont installées depuis une annonce ou sans spécifier de zone de préparation ou de version, et est principalement destinée à prendre en charge le test du processus de mise à niveau de l’application.

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_version_directory>

Met à jour l’application en utilisant les fichiers d’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.

UNSET

Spécifie une (ou plusieurs) propriété(s) et/ou paramètres de session à désactiver pour l’application, ce qui les réinitialise aux 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 l’application installée. 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 fourni, annule toutes les références persistantes définies pour l’application.

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.