Créer un objet d’application¶

À propos de la création et du test d’objets d’application¶

Le Snowflake Native App Framework permet au fournisseur de créer un objet APPLICATION dans le même compte que le paquet d’application. Cela permet aux fournisseurs de tester un Snowflake Native App avant de le publier auprès des consommateurs. Il permet également aux fournisseurs de tester l”Snowflake Native App sur un seul compte, sans avoir à alterner entre les comptes fournisseur et consommateur.

Privilèges requis pour créer et tester un objet APPLICATION¶

Pour créer un objet APPLICATION à partir d’un paquet d’application, vous devez disposer des privilèges suivants accordés à votre rôle :

• Le privilège au niveau du compte CREATE APPLICATION accordé à votre rôle.

• Le privilège au niveau de l’objet INSTALL accordé sur le paquet d’application.

Les exemples suivants montrent comment utiliser la commande GRANT <privilèges> pour attribuer ces privilèges à votre compte :

GRANT CREATE APPLICATION ON ACCOUNT TO ROLE provider_role;
GRANT INSTALL ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE provider_role;

GRANT DEVELOP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE other_dev_role;

Processus de création et de test d’une application¶

Le Snowflake Native App Framework propose différentes manières de créer un objet APPLICATION à partir d’un paquet d’application. Cela vous permet de tester une Snowflake Native App avant de la publier auprès des consommateurs. La méthode que vous utilisez dépend des parties de l’objet APPLICATION que vous souhaitez tester.

Les étapes suivantes décrivent un processus typique de test d’un objet APPLICATION :

1. Créer un objet APPLICATION en utilisant le contenu d’une zone de préparation.

   Cela vous permet de tester rapidement une nouvelle version d’un script d’installation ou d’un fichier de code d’application. Reportez-vous à Création d’une application à l’aide de fichiers en zone de préparation pour plus d’informations.

2. Créer un objet APPLICATION à partir d’une version ou d’un correctif.

   Après avoir défini une version ou un correctif pour un paquet d’application, vous pouvez tester cette version en créant un objet APPLICATION utilisant cette version. Reportez-vous à Créer un objet d’application à partir d’une version ou d’un niveau de correctif.

3. Mettre à niveau un objet APPLICATION.

   Après avoir vérifié qu’une version d’un paquet d’application fonctionne correctement, vous pouvez mettre à niveau un objet APPLICATION existant vers la nouvelle version. Vous pouvez procéder à une mise à niveau de deux manières :

   • Mise à niveau d’une application en utilisant une zone de préparation (compte unique)

   • Mise à niveau d’une application à partir d’une version (compte unique)

4. Créer un objet APPLICATION directement à partir d’un paquet d’application.

   Après avoir vérifié que l’objet APPLICATION installée fonctionne correctement, vous pouvez créer un objet APPLICATION à partir d’un paquet d’application sans spécifier de version ni de fichiers en zone de préparation. L’objet APPLICATION est ainsi créé à l’aide de la directive de version par défaut.

   Reportez-vous à Création d’une application à l’aide de fichiers en zone de préparation pour plus d’informations.

5. Installez une Snowflake Native App à partir d’une annonce.

   Après avoir vérifié dans votre compte que le paquet d’application et l’objet APPLICATION fonctionnent correctement, vous pouvez ajouter le paquet d’application à une annonce et tester l’installation à l’aide de Snowsight.

   Reportez-vous à Création d’une application à l’aide de fichiers en zone de préparation pour plus d’informations.

Créer un objet d’application¶

Le Snowflake Native App Framework vous permet d’installer un objet APPLICATION directement dans votre compte pour tester une Snowflake Native App avant qu’elle ne soit partagée avec les clients. La commande CREATE APPLICATION prend en charge différentes syntaxes pour la création d’un objet APPLICATION.

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0;

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0 PATCH 2;

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package;

ALTER APPLICATION HelloSnowflake
  UPGRADE USING @CODEDATABASE.CODESCHEMA.AppCodeStage;

ALTER APPLICATION HelloSnowflake
 UPGRADE USING VERSION "v1_1";

Visualiser des objets d’application¶

Pour voir une liste des objets APPLICATION disponibles sur votre compte, utilisez la commande SHOW APPLICATIONS comme indiqué dans l’exemple suivant :

SHOW APPLICATIONS

À propos du mode développement¶

Lorsque vous créez un objet APPLICATION à partir d’un paquet d’application en spécifiant une version ou des fichiers d’application sur une zone de préparation nommée, l’objet APPLICATION est considéré comme étant en mode développement.

Le mode développement vous permet de tester et de dépanner un objet APPLICATION au sein d’un même compte. En mode développement, vous pouvez créer et tester un objet APPLICATION selon une version spécifique d’un paquet d’application. Vous pouvez également créer et tester un objet APPLICATION à l’aide de fichiers en zone de préparation. Vous pouvez ainsi tester rapidement les modifications apportées au script d’installation ou à la logique d’application.

Le mode développement offre un mode de débogage supplémentaire qui vous permet de vérifier le statut interne d’un objet APPLICATION qu’un consommateur ne pourrait pas voir autrement.

En mode développement, par exemple, l’exécution des commandes SHOW ou DESC sur des objets de l’objet APPLICATION n’affichera que les objets que le consommateur a été autorisé à voir. Cependant, en mode DEBUG, vous pouvez voir tous les objets de l’objet APPLICATION.

Activer le mode débogage¶

Le Snowflake Native App Framework vous permet de tester un objet APPLICATION en mode débogage. Le mode débogage vous permet de voir et de modifier tous les objets au sein de l’objet APPLICATION. Les objets qui ne sont pas visibles par un consommateur, par exemple les objets non attribués à un rôle de base de données ou les objets de contenu partagé, sont visibles dans ce mode.

L’utilisation d’un objet APPLICATION en mode débogage nécessite les éléments suivants :

• L’objet APPLICATION doit être créée en mode développement, ce qui signifie qu’elle doit être basée sur une version spécifique ou sur des fichiers sur une zone de préparation.

• Vous devez explicitement activer le mode débogage sur l’objet APPLICATION.

Pour activer le mode débogage sur un objet APPLICATION, utilisez la commande ALTER APPLICATION comme indiqué dans l’exemple suivant :

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = TRUE;

Cette commande active le mode débogage pour un objet APPLICATION installé nommé hello_snowflake_app. De même, pour désactiver le mode débogage, utilisez la même commande comme indiqué dans l’exemple suivant :

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = FALSE;

Cette commande désactive le mode débogage pour l’objet APPLICATION nommée hello_snowflake_app.

Définir un objet d’application comme contexte actif¶

Pour définir un objet APPLICATION comme contexte actif et actuel d’une session, exécutez la commande USE APPLICATION comme indiqué dans l’exemple suivant :

USE APPlICATION hello_snowflake_app;

Afficher les détails d’un objet d’application¶

Pour voir les détails d’un objet d’application, exécutez la commande DESCRIBE APPLICATION comme indiqué dans l’exemple suivant :

DESC APPLICATION hello_snowflake_app;

En mode développement, cette commande n’affiche que les schémas exposés au consommateur par le biais des rôles de la base de données de l’application.

En mode débogage, cette commande affiche tous les schémas de l’instance et du paquet d’application.