Référence des commandes de Declarative Native App¶

Syntaxe¶

CREATE APPLICATION PACKAGE [ IF NOT EXISTS ] <name> TYPE = DATA

Nouveau paramètre facultatif :

TYPE = [ DATA | NATIVE ]

Spécifie le type de paquet d’application à créer :

• DATA : indique que le paquet d’application contiendra une Declarative Native App.

• NATIVE : indique que le paquet d’application contiendra une Snowflake Native App. Il s’agit de la valeur par défaut.

Après avoir spécifié un type de paquet d’application, vous ne pouvez pas utiliser ALTER APPLICATION PACKAGE pour modifier le type ultérieurement.

Lorsque TYPE = DATA est spécifié, les autres paramètres de cette commande, tels que DATA_RETENTION_TIME_IN_DAYS et COMMENT, ne sont pas pris en charge.

Ce paramètre nécessite un rôle avec les privilèges CREATE APPLICATION PACKAGE et CREATE DATABASE :ref:` <label-access_control_overview_privileges>`.

Le créateur du paquet d’application reçoit automatiquement le privilège OWNERSHIP sur ce paquet d’application.

Syntaxe¶

ALTER APPLICATION PACKAGE <name>
[ ADD LIVE VERSION
| ADD VERSION FROM @STAGE/path
| BUILD
| COMMIT
| RELEASE [LIVE VERSION]
| ABORT LIVE VERSION ]
[COMMENT = 'string_literal']

Nouveaux paramètres facultatifs¶

ADD LIVE VERSION

Créez une version active du paquet d’application qui peut être modifiée. Cette version active est utilisée pour ajouter ou mettre à jour des fichiers, tels que le fichier manifeste et les fichiers notebook.

ADD VERSION FROM @<STAGE>/<path>

Crée une version active du paquet d’application à partir de fichiers provenant d’une zone de préparation. Cette méthode est utile si vous souhaitez inclure un ensemble de fichiers dans le paquet d’application, et que vous souhaitez les ajouter tous en même temps.

BUILD

Construit l’application, mais ne la valide pas. Utilisez cette commande pour valider le fichier manifeste et continuer à travailler sur le paquet d’application.

COMMIT

Construit l’application, la valide pour la publication, mais ne la publie pas.

Le processus de validation prépare le paquet d’application pour la publication en ajoutant un numéro de version interne et rend le paquet d’application immuable.

RELEASE

Publie une version validée de l’application dans la Snowflake Marketplace.

RELEASE LIVE VERSION

Construit l’application, la valide pour la publication et la publie dans la Snowflake Marketplace.

Équivalent à l’exécution des commandes BUILD, COMMIT, et RELEASE dans l’ordre.

ABORT LIVE VERSION

Supprime la version LIVE du paquet d’application. Restaure le paquet d’application sur la dernière version validée.

Paramètres existants¶

Ces paramètres sont pris en charge à la fois pour Declarative Native Apps et Snowflake Native Apps.

<name>

Spécifie l’identificateur pour le paquet d’application.

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.

COMMENT = 'string_literal'

En option : Ajoute un commentaire ou remplace un commentaire existant pour la version de l’application. Ce commentaire est affiché dans SHOW APPLICATION PACKAGES.

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

Cette commande requiert un rôle avec le privilège OWNERSHIP pour le paquet d’application.

Exemples¶

• Créez un nouveau paquet d’application :

  CREATE APPLICATION PACKAGE market_data_app TYPE = DATA;
  

  Copy

• Créez une version active du paquet d’application qui peut être modifiée :

  ALTER APPLICATION PACKAGE market_data_app
    ADD LIVE VERSION
    COMMENT = 'Market views for Northern region';
  

  Copy

• Créez une nouvelle version du paquet d’application à partir d’un paquet d’application de zone de préparation existant :

  ALTER APPLICATION PACKAGE market_data_app
    ADD VERSION FROM @my_stage/market_data_app_v1;
  

  Copy

• Créez le paquet d’application, mais ne le validez pas :

  ALTER APPLICATION PACKAGE market_data_app BUILD;
  

  Copy

• Créez et validez le paquet d’application pour la publication, mais ne le publiez pas :

  ALTER APPLICATION PACKAGE market_data_app
    COMMIT
    COMMENT = 'Market views for North and East regions';
  

  Copy

• Publiez le paquet d’application sur la Snowflake Marketplace :

  ALTER APPLICATION PACKAGE market_data_app RELEASE;
  

  Copy

• Créez, validez et publiez la version active du paquet d’application sur la Snowflake Marketplace :

  ALTER APPLICATION PACKAGE market_data_app RELEASE LIVE VERSION
    COMMENT = 'Market views for North, East, and West regions';
  

  Copy

• Après avoir ajouté une version active de l’application et l’avoir modifiée, arrêtez la modification et restaurez la dernière version validée :

  ALTER APPLICATION PACKAGE market_data_app ABORT LIVE VERSION
  

  Copy

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

Cette commande requiert un rôle avec le privilège OWNER pour l’application installée.

Syntaxe¶

GRANT IMPORTED PRIVILEGES ON APPLICATION <name> TO ROLE <role_name>;

Exemple¶

GRANT IMPORTED PRIVILEGES ON APPLICATION market_data_app TO ROLE marketing_team_east;