Installation de l’environnement Snowflake Data Clean Rooms¶

Exigences vis-à-vis 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.

• Les comptes de lecteur ne sont pas pris en charge, car les comptes de lecteur n’autorisent pas le partage de données nécessaire pour installer et exécuter l’application des salles blanches.

• 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 de données. Si vous n’avez pas accepté les Conditions de la fonctionnalité de partage de données contrôlée par le client de Snowflake, veuillez contacter le Support Snowflake. Snowflake Data Clean Rooms utilise des listes qui font partie du service Snowflake, sous réserve des conditions d’utilisation du service que vous avez conclues avec Snowflake, y compris les conditions d’utilisation de la fonctionnalité de partage de données contrôlée par le client Snowflake et `la politique d’utilisation acceptable de Snowflake<//www.snowflake.com/legal/acceptable-use-policy/>`_.

• You must unset any unsupported account-level parameters. See the list of unsupported account-level settings.

• (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.

Paramètres de niveau compte non pris en charge¶

Snowflake Data Clean Rooms does not support certain account-level parameter values. The following table shows the required values for these parameters:

Pour vérifier un paramètre de votre compte, exécutez la commande SQL suivante, en remplaçant le nom du paramètre par <parameter_name> :

SHOW PARAMETERS LIKE '<parameter_name>' IN ACCOUNT;

Par exemple :

SHOW PARAMETERS LIKE 'DEFAULT_DDL_COLLATION' IN ACCOUNT;

Exigences en matière de rôle¶

Voici les exigences de rôle pour la personne qui installe l’environnement de la salle blanche :

• 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 depuis le Marketplace :

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 des salles blanches¶

L’API des salles blanches est utilisée pour la création et l’utilisation programmatiques de salles blanches.

Voici les étapes d’installation de l’API des salles blanches dans votre compte Snowflake :

1. Après avoir installé l’application natif , lancez-la dans Snowflake. Dans le menu de navigation, sélectionnez Catalog » Apps » Snowflake Data Clean Rooms » Launch app. Cela ouvre une feuille de calcul avec des commandes SQL.

2. Exécutez les commandes SQL pour installer l’API des salles blanches en tenant compte de ce qui suit :

   • 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 des salles blanches fournit un environnement sans code convivial pour gérer votre compte de salles blanches, créer des salles blanches et exécuter des analyses. L’interface fournit également des fonctionnalités supplémentaires non disponibles dans l’API des salles blanches, telles que les requêtes planifiées, l’activation de fonctionnalités tierces et les 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. Complete the UI setup. This step configures a service user [*] that the clean rooms UI uses to communicate with Snowflake.

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

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

   3. Sous Enable the Data Clean Rooms UI, choisissez Quick Setup ou Manual Setup :

      • Quick Setup - Crée automatiquement un utilisateur de service. Indiquez un nom d’utilisateur de service unique pour ce compte.

      • Manual Setup - Si vous souhaitez créer vous-même l’utilisateur de service ou réutiliser un utilisateur de service existant, sélectionnez cette option. Notez que les salles blanches prendront le contrôle de l’utilisateur du service et le modifieront, aussi assurez-vous que l’utilisateur du service n’est pas utilisé pour autre chose. Découvrez comment créer un utilisateur de service.

   4. Saisissez le nom d’utilisateur de service unique et sélectionnez. Finish.

3. Configurez votre environnement de salles blanches comme décrit dans la section suivante.