Tutoriel 1 : Créer une Native Apps de base avec Snowflake¶

Ce que vous apprenez dans ce tutoriel¶

Dans ce tutoriel, vous apprenez à :

• Créez un paquet d’application qui contient les données et la logique d’entreprise de votre application.

• Partager des données avec un paquet d’application.

• Ajouter une logique métier à un paquet d’application.

• Testez l’application localement.

• Voyez et testez l’application dans Snowsight.

• Publier votre application en créant une annonce privée.

• Installez l’application à partir d’une annonce privée.

• Utilisez Snowflake CLI pour effectuer la plupart des étapes ci-dessus.

À propos des fournisseurs et des consommateurs¶

Dans le contexte du Snowflake Native App Framework, les fournisseurs sont les rôles et les organisations qui disposent de données et d’une logique métier qu’ils souhaitent partager avec d’autres utilisateurs de Snowflake, qui sont les consommateurs. Un consommateur peut être un autre compte au sein de votre organisation, une organisation différente au sein de votre entreprise ou un utilisateur de Snowflake dans une autre entreprise.

Dans le contexte de ce tutoriel, la plupart des tâches que vous effectuez sont celles généralement réalisées par les fournisseurs, mais elles incluent des tâches qui peuvent être réalisées par plusieurs rôles au sein de votre organisation, notamment les développeurs d’applications et les administrateurs de bases de données.

Dans ce tutoriel, vous effectuez également des tâches qui imitent les actions réalisées par les consommateurs pour installer une application.

Conditions préalables¶

• La version 3.0.0 ou supérieure de la CLI Snowflake doit être installée sur votre machine.

• Vous devez exécuter toutes les commandes SQL dans la même session de commande SQL, car le contexte de la session est nécessaire.

  Pour ce faire dans Snowsight, par exemple, collez tout votre code dans la même feuille de calcul au fur et à mesure. Au fur et à mesure que vous progressez, chaque section s’appuie sur la précédente.

• Vous devez être en mesure d’utiliser le rôle ACCOUNTADMIN pour effectuer les tâches suivantes :

  • Créez le rôle utilisé dans ce tutoriel, à savoir le rôle tutorial1_role.

  • Accordez les privilèges requis au rôle tutorial1_role.

  • Créez une annonce pour votre application.

  Dans ce tutoriel, vous effectuez les étapes pour créer votre Snowflake Native App de base en utilisant le rôle tutorial1_role. En règle générale, cependant, vous utiliserez des rôles dont les privilèges sont spécifiquement définis pour l’action que vous effectuez. Par exemple, vous pouvez avoir des rôles distincts pour les utilisateurs suivants :

  • Les développeurs qui créent des UDFs et des procédures stockées

  • Les administrateurs de base de données qui gèrent les rôles et les autorisations

  • Les administrateurs qui gèrent les annonces à l’aide de Snowflake Collaboration

• Pour installer votre application à partir d’une annonce privée, vous devez avoir accès à un deuxième compte Snowflake. Vous utilisez ce compte pour imiter la façon dont les consommateurs installeraient une application.

  Note

  Bien que le Snowflake Native App Framework prenne en charge le partage d’applis avec des comptes appartenant à des organisations différentes, pour les besoins de ce tutoriel, les deux comptes doivent appartenir à la même organisation.

• Vous devez définir un entrepôt courant. Voir USE WAREHOUSE.

Initialiser un nouveau dossier de projet¶

Vous utilisez Snowflake CLI pour initialiser un nouveau projet Snowflake Native App dans votre système de fichiers local.

Pour ce faire :

1. Exécutez la commande suivante :

   snow init --template app_basic tutorial
   

   Copy

2. Saisissez une valeur pour l’identificateur du projet.

   Cette valeur est utilisée comme nom de base pour les entités que les commandes de l’application snow génèreront. Par exemple, si vous saisissez foo, le paquet d’application est foo_pkg et l’entité d’application est foo. Cependant, dans ce tutoriel de démarrage, vous remplacerez le contenu du fichier de définition de projet (snowflake.yml), qui remplace la valeur que vous avez spécifiée pour l’identificateur du projet.

Cette commande crée un dossier nommé tutorial dans le répertoire de travail actuel et le remplit avec un projet de base Snowflake Native App basé sur un modèle de base. Il s’agit du répertoire racine de tous les fichiers de votre application.

Créer le script d’installation¶

Modifiez ou remplacez le contenu du fichier app/setup_script.sql comme affiché dans l’exemple suivant :

-- Setup script for the Hello Snowflake! app.

Copy

Cette ligne est un espace réservé, car le script d’installation ne peut pas être vide.

Note

Ce tutoriel fait référence à une structure et à un nom de fichier particuliers pour le script d’installation. Cependant, lorsque vous créez votre propre appli, vous pouvez choisir votre propre nom et votre propre structure de répertoire pour ce fichier.

Créer un fichier README pour votre appli¶

Un fichier Lisez-moi fournit une description de ce que fait votre application. Vous visualisez le fichier lisez-moi lorsque vous voyez votre application dans Snowsight.

Modifiez ou remplacez le contenu de app/README.md par ce qui suit :

This is the readme file for the Hello Snowflake app.

Copy

Créer le fichier manifeste¶

Le Snowflake Native App Framework exige un fichier manifeste pour chaque appli. Le fichier manifeste contient des métadonnées et des paramètres de configuration pour une appli et influence le comportement de votre appli pendant l’exécution.

Modifiez ou remplacez le contenu de app/manifest.yml par ce qui suit :

manifest_version: 1
artifacts:
   setup_script: setup_script.sql
   readme: README.md

La propriété setup_script spécifie l’emplacement du script d’installation par rapport à l’emplacement du fichier manifeste. Le chemin et le nom de fichier spécifiés ici doivent être identiques à l’emplacement relatif du script d’installation que vous avez modifié ci-dessus. La propriété readme suit les mêmes règles.

Créer le fichier de définition du projet¶

Snowflake CLI utilise un fichier de définition de projet pour décrire les objets qui peuvent être déployés sur Snowflake. Ce fichier doit être nommé snowflake.yml. Ce fichier contrôle le nom du paquet d’application et de l’objet déployés, ainsi que les fichiers qui sont téléchargés dans la phase de projet.

Note

Ce fichier doit être nommé snowflake.yml et doit se trouver à la racine de votre projet. Les chemins vers d’autres fichiers, y compris le manifest.yml et le script d’installation, sont relatifs à l’emplacement de ce fichier.

Modifiez ou remplacez le contenu de snowflake.yml par ce qui suit :

definition_version: 2
entities:
   hello_snowflake_package:
      type: application package
      stage: stage_content.hello_snowflake_stage
      manifest: app/manifest.yml
      identifier: hello_snowflake_package
      artifacts:
         - src: app/*
           dest: ./
   hello_snowflake_app:
      type: application
      from:
         target: hello_snowflake_package
      debug: false

Copy

La section suivante de ce tutoriel décrit comment utiliser chacune de ces propriétés.

Passez en revue ce que vous avez appris dans cette section¶

Après avoir effectué les étapes décrites dans cette section, vous devriez avoir une structure de répertoire qui ressemble à ce qui suit :

/tutorial
  snowflake.yml
  README.md
  /app/
    manifest.yml
    README.md
    setup_script.sql

Dans cette section, vous avez appris à créer le script d’installation et les fichiers manifestes requis par le Snowflake Native App Framework et avez pris connaissance du fichier de définition de projet qui est requis par Snowflake CLI.

Bien que le contenu que vous avez ajouté au script d’installation et au fichier manifeste soit basique, toutes les applis doivent avoir ces fichiers.

Vous avez également ajouté un fichier Lisez-moi qui s’affiche lors de l’affichage de votre appli dans Snowsight ou lors de la publication de votre appli sous forme d’annonce.

Ajouter une procédure stockée au script d’installation¶

Dans cette section, vous ajoutez une procédure stockée à l’application en ajoutant le code de la procédure stockée au script d’installation sur votre système de fichiers local.

Pour ajouter une procédure stockée au script d’installation :

1. Ajoutez les instructions SQL suivantes à la fin du fichier setup_script.sql que vous avez créé dans une section précédente de ce tutoriel :

   CREATE APPLICATION ROLE IF NOT EXISTS app_public;
   CREATE SCHEMA IF NOT EXISTS core;
   GRANT USAGE ON SCHEMA core TO APPLICATION ROLE app_public;
   

   Copy

   Lorsque le script d’installation s’exécute pendant l’installation de l’appli, ces instructions créent un rôle d’application nommé app_public. Les rôles d’application sont similaires aux rôles de base de données, mais ils ne peuvent être utilisés que dans le contexte d’une appli. Ils sont utilisés pour accorder l’accès à des objets au sein de l’objet d’application qui est créé dans le compte consommateur.

   Cet exemple crée également un schéma pour contenir la procédure stockée et accorde le privilège USAGE sur le schéma au rôle d’application. La création d’un rôle d’application et l’attribution de privilèges sur un objet, par exemple un schéma, au rôle d’application sont un schéma courant dans le script d’installation.

2. Ajoutez le code de la procédure stockée à la fin du fichier setup_script.sql :

   CREATE OR REPLACE PROCEDURE CORE.HELLO()
     RETURNS STRING
     LANGUAGE SQL
     EXECUTE AS OWNER
     AS
     BEGIN
       RETURN 'Hello Snowflake!';
     END;
   

   Copy

   Cet exemple crée une procédure stockée qui produit la chaîne « Hello Snowflake ! ».

3. Ajoutez l’instruction suivante à la fin du fichier setup_script.sql :

   GRANT USAGE ON PROCEDURE core.hello() TO APPLICATION ROLE app_public;
   

   Copy

   Cet exemple attribue au rôle d’application le privilège USAGE sur la procédure stockée.

Dans cette section, vous avez ajouté une procédure stockée au script d’installation. Vous avez également créé un rôle d’application et attribué le privilège USAGE à ce rôle. Cela permet au script d’installation de créer la procédure stockée lors de l’installation de l’application. Cela autorise également l’appli à exécuter la procédure stockée.

Installer et tester l’appli en mode développement en zone de préparation¶

Vous êtes maintenant prêt à créer le paquet d’application, l’appli et toutes les autres entités que vous avez spécifiées dans le fichier de définition du projet.

Pour effectuer ces tâches :

1. Dans un terminal, accédez au dossier tutorial.

2. Exécutez la commande CLI suivante de Snowflake :

   snow app run -c tut1-connection
   

   Copy

Cette commande permet d’effectuer les performances suivantes :

1. Créez un paquet d’application nommé hello_snowflake_package avec le schéma stage_content et la zone de préparation hello_snowflake_stage.

2. Téléchargez tous les fichiers nécessaires dans la zone de préparation nommée.

3. Créez ou mettez à niveau l’application hello_snowflake_app en utilisant les fichiers de cette zone de préparation.

Si la commande s’exécute avec succès, elle produit une URL où vous pouvez voir votre application dans Snowsight.

Pour exécuter la procédure stockée HELLO que vous avez ajoutée à setup_script.sql dans une section précédente, exécutez la commande Snowflake CLI suivante :

snow sql -q "call hello_snowflake_app.core.hello()" -c tut1-connection

Regardez la sortie suivante après avoir exécuté cette commande :

+------------------+
| HELLO            |
|------------------|
| Hello Snowflake! |
+------------------+

Passez en revue ce que vous avez appris dans cette section¶

Félicitations ! Vous avez créé, installé et testé votre première Snowflake Native App en utilisant le Snowflake Native App Framework ! Bien que l’appli n’ait qu’une fonctionnalité de base, les composants que vous avez utilisés pour développer l’appli sont les mêmes pour des applis plus complexes.

Dans cette section, vous avez complété les éléments suivants :

• Ajout d’une procédure stockée au script d’installation. Le script d’installation spécifie comment votre appli est installée dans le compte consommateur. Dans les sections suivantes, vous ajoutez du contenu de données et d’autres types de logique d’application à votre application.

• Déploiement de votre appli pour la première fois à l’aide de Snowflake CLI.

• Vous avez testé votre appli installée en exécutant une procédure stockée.

Dans les sections suivantes, vous découvrirez d’autres façons de voir et de tester votre application.

Créer une table à partager avec une appli¶

Dans cette section, vous apprendrez à partager du contenu de données avec une application. Plus précisément, vous partagez une table dans le compte fournisseur en accordant des privilèges sur le schéma et la table au paquet d’application.

1. Pour créer une table et insérer les données d’exemple dans le paquet d’application, créez un dossier tutorial/scripts, puis un fichier shared_content.sql au sein du dossier. Ajoutez les contenus suivants à ce fichier :

   USE APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   
   CREATE SCHEMA IF NOT EXISTS shared_data;
   USE SCHEMA shared_data;
   CREATE TABLE IF NOT EXISTS accounts (ID INT, NAME VARCHAR, VALUE VARCHAR);
   TRUNCATE TABLE accounts;
   INSERT INTO accounts VALUES
     (1, 'Joe', 'Snowflake'),
     (2, 'Nima', 'Snowflake'),
     (3, 'Sally', 'Snowflake'),
     (4, 'Juan', 'Acme');
   -- grant usage on the ``ACCOUNTS`` table
   GRANT USAGE ON SCHEMA shared_data TO SHARE IN APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   GRANT SELECT ON TABLE accounts TO SHARE IN APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   

   Copy

   Dans cet exemple, <% ctx.entities.hello_snowflake_package.identifier %> est un modèle qui est remplacé par l’identificateur résolu de votre application package depuis le fichier snowflake.yml lorsque vous exécutez une commande CLI Snowflake.

   L’attribution de ces privilèges sur les objets du paquet d’application met la table shared_data.accounts à la disposition de tous les objets créés à partir de ce paquet d’application. Ce partage a lieu grâce à la commande de privilèges GRANT TO SHARE à la fin du script.

   Note

   Vous devez accorder le privilège USAGE à chaque schéma d’un paquet d’application pour chaque schéma que vous souhaitez partager avec un consommateur dans une application. Vous devez ensuite accorder le privilège SELECT aux objets du schéma que vous souhaitez partager.

2. Ajoutez une entrée au fichier de définition du projet pour vous assurer que ce script s’exécute lorsque vous mettez à jour votre paquet d’application. Le fichier de définition du projet final (snowflake.yml) doit être :

   definition_version: 2
   entities:
      hello_snowflake_package:
         type: application package
         stage: stage_content.hello_snowflake_stage
         manifest: app/manifest.yml
         identifier: hello_snowflake_package
         artifacts:
            - src: app/*
              dest: ./
         meta:
            post_deploy:
               - sql_script: scripts/shared_content.sql
      hello_snowflake_app:
         type: application
         from:
            target: hello_snowflake_package
         debug: false
   

   Copy

Ajouter une vue pour accéder au contenu des données¶

Dans cette section, vous mettez à jour le script d’installation pour ajouter une vue qui permet au consommateur qui a installé l’application d’accéder aux données de la table ACCOUNTS que vous avez créée dans la section précédente.

Pour ajouter une vue permettant d’accéder au contenu des données :

1. Pour créer un schéma pour la vue, ajoutez ce qui suit au script d’installation :

   CREATE OR ALTER VERSIONED SCHEMA code_schema;
   GRANT USAGE ON SCHEMA code_schema TO APPLICATION ROLE app_public;
   

   Copy

   Ces instructions créent un schéma versionné pour contenir la vue et attribuent le privilège USAGE sur le schéma. Le Snowflake Native App Framework utilise un schéma versionné pour gérer les différentes versions des procédures et fonctions stockées.

2. Pour créer la vue, ajoutez ce qui suit au script d’installation :

   CREATE VIEW IF NOT EXISTS code_schema.accounts_view
     AS SELECT ID, NAME, VALUE
     FROM shared_data.accounts;
   GRANT SELECT ON VIEW code_schema.accounts_view TO APPLICATION ROLE app_public;
   

   Copy

   Ces instructions créent la vue dans le schéma code_schema et accordent le privilège requis sur la vue au rôle d’application.

   Ce script d’installation mis à jour est également téléchargé dans la zone de préparation la prochaine fois que vous déployez votre appli à l’aide de Snowflake CLI.

Tester l’appli mise à jour¶

Dans cette sous-section, vous mettez à jour l’application et vous effectuez une requête sur la table d’exemple à l’aide de la vue de l’application installée.

Pour tester l’application mise à jour, procédez comme suit :

1. Pour mettre à jour le paquet d’application et l’objet d’application installé dans le compte du consommateur, exécutez la commande suivante :

   snow app run -c tut1-connection
   

   Copy

   Cela permet de télécharger tous les fichiers modifiés vers la zone de préparation, d’exécuter le script scripts/shared_content.sql et de mettre à niveau l’application à l’aide de ces fichiers sur la zone de préparation.

2. Pour vérifier que la vue fonctionne correctement, exécutez la commande suivante :

   snow sql -q "SELECT * FROM hello_snowflake_app.code_schema.accounts_view" -c tut1-connection
   

   Copy

   La sortie de cette commande devrait être la suivante :

   +----+----------+-----------+
   | ID | NAME     | VALUE     |
   |----+----------+-----------|
   |  1 | Joe      | Snowflake |
   |  2 | Nima     | Snowflake |
   |  3 | Sally    | Snowflake |
   |  4 | Juan     | Acme      |
   +----+----------+-----------+
   

   Copy

Passez en revue ce que vous avez appris dans cette section¶

Dans cette section, vous avez appris à inclure du contenu de données partagées dans votre appli en effectuant les tâches suivantes :

• Créer la table ACCOUNTS dans le paquet d’application et insérer des données dans la table.

• Attribuer au paquet d’application l’utilisation de la référence sur la table ACCOUNTS.

• Créer un schéma et une vue qui font référence à la table ACCOUNTS dans le paquet d’application.

• Accorder l’utilisation du schéma au rôle d’application.

• Accorder la sélection de la vue au rôle d’application.

Vous avez également mis à jour le script d’installation pour effectuer les opérations suivantes lors de l’installation de l’application :

• Créer un schéma et une vue que l’application utilise pour accéder aux données d’exemple.

• Accorder l’utilisation du schéma au rôle d’application.

• Accorder la sélection de la vue au rôle d’application.

Ajouter une fonction Python en ligne en tant que fonction définie par l’utilisateur (UDF)¶

Dans cette section, vous ajoutez une fonction Python en tant que UDF.

Pour inclure un UDF Python dans votre application, ajoutez le code suivant à votre script d’installation (setup_script.sql).

CREATE OR REPLACE FUNCTION code_schema.addone(i int)
RETURNS INT
LANGUAGE PYTHON
RUNTIME_VERSION = '3.11'
HANDLER = 'addone_py'
AS
$$
def addone_py(i):
  return i+1
$$;

GRANT USAGE ON FUNCTION code_schema.addone(int) TO APPLICATION ROLE app_public;

Copy

Ces commandes exécutent les tâches suivantes lors de l’installation de l’appli :

• Créez un schéma versionné nommé code_schema.

• Accordez le privilège d’utilisation du schéma au rôle d’application APP_PUBLIC.

• Créez l’UDF ADDONE() dans le schéma code_schema.

• Accordez le privilège d’utilisation de la fonction au rôle d’application APP_PUBLIC.

Notez que le schéma créé dans l’exemple de code ci-dessus est un schéma versionné. Les fonctions définies par l’utilisateur et les procédures stockées doivent être définies dans un schéma versionné au lieu d’un schéma normal. Cela permet d’éviter que les mises à niveau d’applications n’interfèrent avec l’exécution simultanée de codes.

Ajouter un module Python externe¶

Pour ajouter un module Python externe à votre appli :

1. Ajoutez la fonctionnalité Python suivante à votre script d’installation (setup_script.sql) :

   CREATE or REPLACE FUNCTION code_schema.multiply(num1 float, num2 float)
     RETURNS float
     LANGUAGE PYTHON
     RUNTIME_VERSION = 3.9
     IMPORTS = ('/python/hello_python.py')
     HANDLER='hello_python.multiply';
   
   GRANT USAGE ON FUNCTION code_schema.multiply(FLOAT, FLOAT) TO APPLICATION ROLE app_public;
   

   Copy

   Comme dans l’exemple précédent, ces instructions créent une UDF Python dans un schéma et attribuent des privilèges sur la fonction au rôle d’application. Cependant, cet exemple contient une clause IMPORTS qui fait référence à un fichier Python externe que vous créez et incluez dans votre zone de préparation externe.

2. Dans le dossier tutorial , créez un sous-dossier nommé python.

3. Dans le sous-dossier python , créez un fichier nommé hello_python.py.

4. Ajoutez ce qui suit au fichier hello_python.py :

   def multiply(num1, num2):
     return num1*num2
   

   Copy

   La fonction définie dans ce fichier externe correspond à la fonction en ligne définie dans le script d’installation.

5. Ajoutez ce qui suit à la section artifacts du fichier de définition du projet (snowflake.yml) :

   - python/hello_python.py
   

   Copy

Dans cette section, vous avez ajouté une UDF Python à votre appli. Cette UDF fait référence à un module Python externe qui peut être référencé par votre paquet d’application.

Installer et tester l’appli mise à jour¶

Pour installer et tester une appli :

1. Pour mettre à jour le paquet d’application et l’appli, exécutez la commande suivante :

   snow app run -c tut1-connection
   

   Copy

   Cette commande télécharge les fichiers modifiés et les nouveaux fichiers vers la zone de préparation et met à niveau votre application en utilisant les fichiers de la zone de préparation.

2. Pour tester la procédure stockée Python, exécutez la commande suivante :

   snow sql -q "SELECT hello_snowflake_app.code_schema.addone(1)" -c tut1-connection
   

   Copy

3. Pour tester la fonction Python référencée, exécutez la commande suivante :

   snow sql -q "SELECT hello_snowflake_app.code_schema.multiply(1,2)" -c tut1-connection
   

   Copy

Passez en revue ce que vous avez appris dans cette section¶

Dans cette section, vous avez ajouté les nouvelles fonctionnalités suivantes à votre appli :

• Une fonction Python définie comme une UDF ligne.

• Une fonction Python définie comme une UDF qui fait référence à du code externe.

Vous avez également testé chacun de ces exemples en installant une version mise à jour de votre appli et en exécutant chacune des fonctions.

Créer le fichier d’appli Streamlit¶

Pour créer une application Streamlit, procédez comme suit :

1. Dans le dossier tutorial , créez un sous-dossier nommé streamlit.

2. Dans le dossier streamlit , créez un fichier nommé hello_snowflake.py.

3. Ajoutez le code suivant à ce fichier :

   # Import python packages
   import streamlit as st
   from snowflake.snowpark import Session
   
   # Write directly to the app
   st.title("Hello Snowflake - Streamlit Edition")
   st.write(
      """The following data is from the accounts table in the application package.
         However, the Streamlit app queries this data from a view called
         code_schema.accounts_view.
      """
   )
   
   # Get the current credentials
   session = Session.builder.getOrCreate()
   
   #  Create an example data frame
   data_frame = session.sql("SELECT * FROM code_schema.accounts_view")
   
   # Execute the query and convert it into a Pandas data frame
   queried_data = data_frame.to_pandas()
   
   # Display the Pandas data frame as a Streamlit data frame.
   st.dataframe(queried_data, use_container_width=True)
   

   Copy

4. Ajoutez ce qui suit à la section artifacts du fichier de définition du projet (snowflake.yml) :

   - streamlit/hello_snowflake.py
   

   Copy

Ajouter l’objet Streamlit au script d’installation¶

Pour créer l’objet Streamlit dans l’application, procédez comme suit :

1. Ajoutez l’instruction suivante à la fin du fichier setup_script.sql pour créer l’objet Streamlit :

   CREATE STREAMLIT IF NOT EXISTS code_schema.hello_snowflake_streamlit
     FROM '/streamlit'
     MAIN_FILE = '/hello_snowflake.py'
   ;
   

   Copy

   Cette instruction crée un objet STREAMLIT dans le schéma principal.

2. Ajoutez l’instruction suivante à la fin du fichier setup_script.sql pour permettre au rôle APP_PUBLIC d’accéder à l’objet Streamlit :

   GRANT USAGE ON STREAMLIT code_schema.hello_snowflake_streamlit TO APPLICATION ROLE app_public;
   

   Copy

Installer l’appli mise à jour¶

1. Pour mettre à jour le paquet d’application et l’appli, exécutez la commande suivante :

   snow app run -c tut1-connection
   

   Copy

   Cette commande télécharge les fichiers modifiés et les nouveaux fichiers vers la zone de préparation et met à niveau votre application en utilisant les fichiers de la zone de préparation. Vous pouvez ensuite vous rendre à l’URL que cette commande imprime pour voir votre nouvelle Streamlit en action ; une fois sur place, cliquez sur l’onglet nommé HELLO_SNOWFLAKE_STREAMLIT qui apparaît à côté du nom de votre application.

Passez en revue ce que vous avez appris dans cette section¶

Dans cette section, vous avez ajouté une appli Streamlit à votre Snowflake Native App en procédant comme suit :

• Création d’un fichier python qui utilise la bibliothèque Streamlit pour afficher une interface utilisateur.

• Création d’une appli Streamlit dans votre Snowflake Native App qui affiche des données partagées.

Définition de la directive de version par défaut¶

Avant de pouvoir créer une annonce pour votre paquet d’application, vous devez définir une directive de version. Une directive de version précise la version et le correctif de votre application qui sont mis à la disposition des consommateurs.

Dans ce tutoriel, vous établissez la directive de version par défaut en utilisant la version que vous avez ajoutée dans une section précédente.

Pour paramétrer la directive de version par défaut sur le paquet d’application, procédez comme suit :

1. Pour voir les versions et les correctifs définis pour votre paquet d’application, exécutez la commande suivante :

   snow app version list -c tut1-connection
   

   Copy

   Cette commande affiche les versions et les correctifs définis pour le paquet d’application.

2. Pour définir la directive de version par défaut sur la version v1_0 et le correctif 0, exécutez la commande suivante :

   snow sql -q "ALTER APPLICATION PACKAGE hello_snowflake_package SET DEFAULT RELEASE DIRECTIVE VERSION = v1_0 PATCH = 0" -c tut1-connection
   

   Copy

   La sortie de cette commande est présentée dans l’exemple suivant :

   +-----------------------------------------------------------+
   | status                                                    |
   |-----------------------------------------------------------|
   | Default release directive set to version 'V1_0', patch 0. |
   +-----------------------------------------------------------+
   

   Copy

Dans cette section, vous avez vérifié quelles versions et quels correctifs existent dans votre paquet d’application. À l’aide de ces informations, vous avez défini la directive de version par défaut pour le paquet d’application.

Créez une annonce pour votre appli¶

Maintenant que vous avez spécifié une directive de version pour votre paquet d’application, vous créez une annonce et ajoutez le paquet d’application en tant que contenu de données de l’annonce. Cela vous permet de partager votre appli avec d’autres utilisateurs de Snowflake et leur permet d’installer et d’utiliser l’appli dans leur compte.

Pour créer une annonce pour votre appli :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data Products » Provider Studio.

3. Sélectionnez + Listing puis Specified consumers pour partager l’annonce en privé avec des comptes spécifiques.

4. Dans la liste déroulante Sélectionner un rôle, sélectionnez ACCOUNTADMIN.

5. Saisissez un nom pour votre annonce.

6. Sélectionnez Next.

7. Cliquez sur + Select pour sélectionner le paquet d’application de l’annonce.

8. Saisissez une description de votre annonce.

9. Dans la section Add consumer accounts, ajoutez l’identificateur du compte que vous utilisez pour tester l’installation de l’appli à partir d’une annonce du point de vue du consommateur.

10. Sélectionnez Publish.

Dans cette section, vous avez créé une annonce privée contenant votre paquet d’application comme contenu de données partagées.

Installez l’appli dans un compte de consommateur¶

Dans cette section, vous installez l’application associée à l’annonce que vous avez créée dans la section précédente. Vous installez l’annonce dans un compte différent, ce qui imite la façon dont un consommateur installerait l’application dans son compte.

Pour installer votre application à partir de l’annonce, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Dans le menu de navigation, sélectionnez Data Products » Apps.

3. Sélectionnez la vignette pour l’annonce sous Recently shared with you.

4. Sélectionnez Get.

5. Sélectionnez Options et saisissez un nom de client pour l’application. Pour ce tutoriel, utilisez « HelloSnowflakeApp ».

6. Sélectionnez l’entrepôt dans lequel installer l’application.

7. Sélectionnez Get.

8. Sélectionnez Open pour voir votre annonce ou Done pour terminer.

Dans cette section, vous avez appris à publier et à installer une annonce qui vous permet de partager votre appli avec d’autres utilisateurs de Snowflake.