Installation de l’environnement Snowflake Data Clean Rooms¶

Exigences du compte et de l’utilisateur¶

Voici les exigences pour installer Snowflake Data Clean Rooms dans votre compte Snowflake :

• Le compte doit satisfaire l’exigence Snowflake Edition :

  • Pour créer des clean rooms, vous devez disposer de l’Enterprise Edition ou d’une édition supérieure.

  • Pour rejoindre et utiliser une clean room créée dans un autre compte, vous devez disposer de Standard Edition ou d’une édition supérieure.

• Le compte doit autoriser l’authentification par paire de clés <label-cleanrooms_get_started_key_pair>, qui est utilisée par le compte de service pour l’authentification.

• Vous devez accepter les conditions de partage des données. Si vous n’avez pas accepté les conditions relatives à la fonctionnalité de partage des données contrôlées par le client Snowflake, veuillez contacter le support Snowflake. Snowflake Data Clean Rooms permet d’exploiter les listings, qui font partie du service Snowflake et sont soumises à vos conditions de service avec Snowflake, y compris les conditions relatives à la fonctionnalité de partage de données contrôlé par le client de Snowflake et la politique d’utilisation acceptable de Snowflake.

• Vous ne devez pas définir un classement de niveau de compte par défaut. Vous pouvez vérifier l’état de votre classement en exécutant la commande suivante : SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

• (UI Clean room seulement) Le compte Snowflake doit être un compte de capacité : il s’agit d’un compte qui comporte un engagement de capacité initial. Les comptes Snowflake à la demande ne peuvent pas accéder aux UI de clean rooms.

• (UI Clean room seulement) Vous devez utiliser l’authentification multifactorielle (MFA) avec une app supportée par l’authentificateur.

Si vous ne répondez pas à toutes ces exigences et que vous devez procéder à une mise à niveau, contactez le support Snowflake.

Les exigences des installateurs¶

Voici les exigences auxquelles doit répondre la personne chargée de l’installation de l’environnement de la clean room :

• Vous devez avoir le rôle ACCOUNTADMIN dans un compte Snowflake pour pouvoir installer l’environnement de clean room dans ce compte.

• L’utilisateur ayant le rôle ACCOUNTADMIN doit avoir un prénom, un nom et une adresse e-mail valides définis pour son objet utilisateur. Pour vérifier, exécutez DESCRIBE USER.

1. Installer l’application native¶

Installez l’application native soit dans le code, soit à partir du marketplace :

Si vous ne souhaitez pas accepter les conditions du fournisseur et du consommateur du marketplace :

Exécutez le code suivant dans votre compte Snowflake :

USE ROLE ACCOUNTADMIN;
CALL system$accept_legal_terms('DATA_EXCHANGE_LISTING', 'GZSTZTP0KKO');
CREATE APPLICATION SAMOOHA_BY_SNOWFLAKE FROM LISTING 'GZSTZTP0KKO';

Copy

Si vous acceptez les conditions du fournisseur et du consommateur de la place de marché :

1. Paramétrez votre rôle actuel sur ACCOUNTADMIN

2. Installez l’application Snowflake Data Clean Rooms à partir du marketplace Snowflake Data

3. Sélectionnez Get et acceptez les options par défaut.

Le programme d’installation prend quelques minutes.

2. Installer l’API Clean Room¶

L’API Clean Room est utilisée pour la création et l’utilisation programmatiques de clean rooms.

Voici les étapes à suivre pour installer l’API de clean room dans votre compte Snowflake :

1. Après avoir installé l’application native, lancez-la dans Snowflake : Data products » Apps » Snowflake Data Clean Rooms » Launch app. Cela ouvre une feuille de calcul avec les commandes SQL.

2. Exécutez les commandes SQL pour installer l’API Clean Room, en tenant compte des remarques suivantes :

   • Si vous avez renommé l’application native pendant l’installation, vous devrez modifier le script comme indiqué dans les commentaires du script.

   • Si vous souhaitez consulter le script d’installation complet avant de l’exécuter, décommentez la ligne du script DRY_RUN=TRUE et exécutez toutes les commandes jusqu’à cette ligne incluse pour voir le contenu du script. Notez que vous ne devez pas exécuter manuellement le script d’installation exposé par cette commande, car cela pourrait entraîner une installation incomplète.

   • Notez que l’installation prend plusieurs minutes.

3. Confirmez que vous pouvez accéder à l’API:

   USE ROLE samooha_app_role;
   USE WAREHOUSE app_wh;
   CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.LIBRARY.CHECK_MOUNT_STATUS();
   

   Copy

   Si vous obtenez le résultat FALSE, consultez la section de dépannage ci-dessous.

4. Autorisez l’accès à l’API à d’autres utilisateurs dans votre compte Snowflake :

   • Pour ajouter des utilisateurs ayant toutes les possibilités de créer et de gérer des clean rooms, exécutez la commande suivante GRANT ROLE SAMOOHA_APP_ROLE to USER USER

   • Pour ajouter des utilisateurs ayant des autorisations d’exécution par le consommateur uniquement, créez un ou plusieurs rôles Snowflake et accordez aux utilisateurs l’accès à ce rôle. Accordez ensuite l’accès à des clean rooms spécifiques en appelant consumer.grant_run_on_cleanrooms_to_role.

5. (Optionnel) Installez les UI de clean rooms pour permettre un accès sans code à vos clean rooms ou d’autres fonctions telles que les requêtes planifiées.

3. Permettre les UI de clean rooms¶

L’UI de clean rooms fournit un environnement simple et sans code pour gérer votre compte de clean rooms, créer des clean rooms et effectuer des analyses. Il offre également quelques fonctionnalités supplémentaires qui ne sont pas disponibles dans l’API de clean room, telles que les requêtes planifiées, l’activation par des tiers et des modèles prédéfinis utiles.

Voici comment activer l’UI de clean rooms dans votre compte Snowflake :

1. Configurez vos politiques réseau pour permettre à l’UI de clean rooms d’accéder à votre compte Snowflake. (Nécessaire uniquement si votre compte Snowflake utilise une politique réseau pour contrôler le trafic réseau.)

2. Créez un utilisateur de service. Cet utilisateur de service est utilisé par l’UI de clean rooms pour communiquer avec Snowflake.

   1. Connectez-vous à Snowsight avec vos identifiants d’administrateur Snowflake et créez un utilisateur de service comme indiqué ci-dessous. Fournissez un mot de passe et une adresse électronique à laquelle vous pouvez accéder. Nous vous recommandons d’utiliser une liste de distribution plutôt qu’un courriel personnel.

      -- Create the service user account.
      
      USE ROLE USERADMIN;
      CREATE USER <SERVICE-USER-USERNAME> PASSWORD='<SERVICE-USER-PASSWORD>'
      FIRST_NAME='DCR' LAST_NAME='Service User'
      EMAIL='<SERVICE-USER-EMAIL-ADDRESS>';
      

      Copy

   2. Enregistrez le nom d’utilisateur et le mot de passe du service en dehors de Snowsight, car vous les utiliserez pendant le processus d’installation.

   3. Déconnectez-vous de l’utilisateur actuel dans Snowsight, puis reconnectez-vous au même compte Snowflake mais avec les identifiants de l’utilisateur du service.

   4. Ouvrez le profil et sélectionnez Resend verification email.

   5. Ouvrez l’e-mail de vérification et suivez le lien pour vérifier l’adresse e-mail de l’utilisateur du service. Il n’est pas nécessaire de se connecter à nouveau à Snowsight avec les identifiants de l’utilisateur du service. Vous pouvez consulter les coordonnées de l’utilisateur du service dans les UI de clean rooms sur la page Admin » Snowflake Admin, sous Snowflake.

3. Terminez la configuration de l’UI. Cette étape applique votre politique réseau à l’utilisateur du service, fait passer l’utilisateur du service de l’authentification par mot de passe à l’authentification par paire clé et accorde SAMOOHA_APP_ROLE à l’utilisateur du service. Suivez les étapes suivantes pour terminer la configuration de base de l’UI:

   1. Connectez-vous à l’UI de clean rooms avec vos identifiants Snowflake.

   2. Ouvrez Admin » Snowflake Admin » Connect to Snowflake account.

   3. Saisissez le nom d’utilisateur de votre compte de service et sélectionnez Save.

   4. Vous pouvez maintenant utiliser l’UI de clean rooms.