ALTER APPLICATION PACKAGE

Modifie les propriétés d’un paquet d’application existant dans le Native Apps Framework.

Voir aussi :

CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES, SHOW VERSIONS, SHOW RELEASE DIRECTIVES

Syntaxe

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> SET
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = <string-literal> ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
  [ MULTIPLE_INSTANCES = TRUE ]

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
  [ DATA_RETENTION_TIME_IN_DAYS ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
  [ DEFAULT_DDL_COLLATION ]
  [ COMMENT ]
  [ DISTRIBUTION ]

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

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

Paramètres

name

Indique l’identificateur pour le paquet d’application à modifier. 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 le paquet d’application (séparées par des espaces, des virgules ou de nouvelles lignes) :

DATA_RETENTION_TIME_IN_DAYS = num

Spécifie le nombre de jours pendant lesquels des actions Time Travel (CLONE et UNDROP) peuvent être effectuées sur la base de données, ainsi que la durée de conservation Time Travel par défaut de tous les schémas créés dans la base de données.

La valeur que vous pouvez spécifier dépend de l’édition de Snowflake que vous utilisez :

  • Édition Standard : 0 ou 1

  • Édition Enterprise (ou supérieure) : 0 à 90

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

Paramètre d’objet qui spécifie le nombre maximum de jours pendant lesquels Snowflake peut prolonger la période de conservation des données pour les tables de la base de données, afin d’éviter que les flux sur les tables ne deviennent obsolètes.

Pour une description détaillée de ce paramètre, voir MAX_DATA_EXTENSION_TIME_IN_DAYS.

DEFAULT_DDL_COLLATION = 'collation_specification'

Définit une spécification de classement par défaut pour :

  • Toute nouvelle colonne ajoutée aux tables existantes dans la base de données.

  • Toutes les colonnes des nouvelles tables ajoutées à la base de données.

La définition du paramètre ne modifie pas la spécification de classement des colonnes existantes.

Pour plus d’informations sur ce paramètre, voir DEFAULT_DDL_COLLATION.

DEFAULT_DDL_COLLATION = 'collation_specification'

Définit une spécification de classement par défaut pour :

  • Toute nouvelle colonne ajoutée aux tables existantes dans la base de données.

  • Toutes les colonnes des nouvelles tables ajoutées à la base de données.

La définition du paramètre ne modifie pas la spécification de classement des colonnes existantes.

Pour plus d’informations sur ce paramètre, voir DEFAULT_DDL_COLLATION.

COMMENT = 'string_literal'

Ajoute un commentaire ou écrase un commentaire existant pour la base de données.

DISTRIBUTION = { INTERNAL | EXTERNAL }

Spécifie le type d’annonce qu’un fournisseur peut créer lorsqu’il utilise le paquet d’application comme produit de données d’une annonce.

  • INTERNAL indique qu’un fournisseur ne peut créer une annonce privée qu’au sein de la même organisation où le paquet d’application a été créé. L’analyse de sécurité automatisée n’est pas effectuée lorsque la propriété DISTRIBUTION est définie sur INTERNAL.

  • EXTERNAL indique qu’un fournisseur peut créer des annonces en dehors de la même organisation où le paquet d’application a été créé.

Voir Exécution de l’analyse de sécurité automatisée pour des informations sur le paramètre de la propriété DISTRIBUTION et l’analyse de sécurité automatisée.

Note

La définition du paramètre DISTRIBUTION sur EXTERNAL déclenche un examen de sécurité automatisé pour chaque version active et chaque correctif définis dans le paquet d’application.

Les restrictions suivantes s’appliquent jusqu’à ce que l’examen de sécurité automatisé ait le statut APPROVED :

  • Vous ne pouvez pas définir une directive de version pour une version ou un correctif.

  • Vous ne pouvez pas publier une annonce pour le paquet d’application.

MULTIPLE_INSTANCES = TRUE

Permet au consommateur d’installer plusieurs instances d’une application à partir du paquet d’application. Cette propriété ne peut pas être définie pour les paquets d’applications qui sont inclus dans une annonce à essai ou monétisée.

Lorsque plusieurs instances sont autorisées, les consommateurs peuvent installer un maximum de 10 instances d’une application dans leur compte.

Prudence

Une fois que cette propriété a été paramétrée à true, elle ne peut être ni paramétrée à FALSE, ni annulée ultérieurement.

UNSET ...

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

  • DATA_RETENTION_TIME_IN_DAYS

  • MAX_DATA_EXTENSION_TIME_IN_DAYS

  • EXTERNAL_VOLUME

  • CATALOG

  • DEFAULT_DDL_COLLATION

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

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é, vous obtiendrez une erreur.

Notes sur l’utilisation

  • Si vous ne spécifiez pas les valeurs des propriétés optionnelles, la commande utilise les valeurs spécifiées dans le fichier manifeste de l’application.

    Si vous spécifiez des valeurs pour les propriétés dans la commande et dans le fichier manifeste de l’application, les valeurs spécifiées dans la commande sont prioritaires.

  • Si deux versions sont actives (par exemple, si le déploiement de la version actuelle n’est pas terminé), l’ajout d’une nouvelle version entraîne une erreur.

  • Les nouvelles versions sont ajoutées avec un numéro de correctif par défaut de 0.

  • 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 PACKAGE hello_snowflake_package SET
  COMMENT = 'Altered the Hello Snowflake app.';
Copy
+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+