Installation de l’environnement Snowflake Data Clean Rooms¶
Avant de commencer¶
Si l’environnement Snowflake Data Clean Room n’est pas installé pour votre compte, suivez les instructions d’installation de cette page.
Si l’environnement des salles blanches est installé pour votre compte et que vous souhaitez y accéder, demandez à un administrateur de vous fournir des privilèges appropriés pour effectuer des opérations de salle blanche dans votre compte.
Régions prises en charge¶
Snowflake Data Clean Rooms sont disponibles pour les comptes Snowflake dans les régions Cloud suivantes :
Plateforme Cloud |
Régions prises en charge |
|---|---|
Amazon Web Services (AWS) |
|
Microsoft Azure |
|
Google Cloud (GCP) |
|
Exigences relatives à l’installation de Snowflake Data Clean Rooms¶
Exigences relatives au compte, à l’installateur et à l’utilisateur¶
Lorsque vous installez l’environnement de salle blanche, vous l’installez pour tous les utilisateurs potentiels du compte Snowflake. Toutefois, l’accès à l’environnement de salle blanche doit être accordé aux utilisateurs de manière explicite par un administrateur de salles blanches.
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 collaborations et être propriétaire, vous devez disposer de Standard Edition ou une version supérieure.
Pour rejoindre une collaboration en tant qu’exécuteur d’analyses, vous devez disposer de l’édition Standard ou supérieure.
Pour rejoindre une collaboration en tant que fournisseur de données ou activer des données vers un autre collaborateur, vous devez disposer de Enterprise Edition ou d’une version supérieure.
L’installateur doit répondre à ces exigences de rôle et vis-à-vis de l’utilisateur.
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.
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/>`_.
Vous devez désactiver les paramètres non pris en charge au niveau du compte. Voir la liste des paramètres au niveau du compte non pris en charge.
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 ne prend pas en charge certaines valeurs de paramètre au niveau du compte. Le tableau suivant indique les valeurs requises pour ces paramètres :
Nom du paramètre |
Valeur requise |
Remarques |
|---|---|---|
DEFAULT_DDL_COLLATION |
Aucune valeur prise en charge, doit être nul |
Le classement au niveau du compte n’est pas pris en charge. |
QUOTED_IDENTIFIERS_IGNORE_CASE |
|
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> :
Par exemple :
Exigences vis-à-vis du rôle et de l’utilisateur¶
Voici les exigences de rôle pour la personne qui installe l’environnement de salle blanche :
Vous devez disposer d’un rôle ACCOUNTADMIN dans un compte Snowflake afin d’installer l’environnement de salle blanche 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.
Installer l’environnement Snowflake Data Clean Rooms¶
Procédez comme suit pour installer un environnement de salle blanche dans votre compte Snowflake.
Vous devez toujours installer l’application native (étape 1), mais après cela, vous pouvez activer l’API des salles blanches pour l’utilisation du code (étape 2).
1. Installer l’application native¶
Installez l’application native depuis le Marketplace :
Paramétrez votre rôle actuel sur ACCOUNTADMIN
Installez l’application Snowflake Data Clean Rooms à partir du marketplace Snowflake Data
Sélectionnez Open et acceptez les options par défaut.
Le programme d’installation prend quelques minutes. Lorsque vous avez terminé, passez à l’étape 2.
2. Installer l’API des salles blanches¶
L’API de salle blanche est tenue d’utiliser des salles blanches via l’UI ou l’API.
Voici les étapes d’installation de l’API des salles blanches dans votre compte Snowflake :
Après avoir installé l’application natif , lancez-la dans Snowflake. Dans le menu de navigation, sélectionnez Catalog » Apps » Snowflake Data Clean Rooms. Cliquez sur le bouton Open in Worksheet dans le coin supérieur droit. Cela ouvre une feuille de calcul avec les commandes SQL.
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=TRUEet 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.
Confirmez que vous pouvez accéder à l’API:
Si cela renvoie FALSE, confirmez que vous utilisezSAMOOHA_APP_ROLE et si c’est le cas, veuillez réessayer d’exécuter la commande du script de montage par le rôle ACCOUNTADMIN.
Prochaines étapes¶
Après avoir installé l’environnement de salle blanche sur votre compte, vous pouvez procéder comme suit :
Ajoutez des développeurs. Accordez l’accès aux rôles de votre compte Snowflake, afin qu’ils puissent accéder aux environnements de salle blanche en fonction de privilèges spécifiques.
Activez l’exécution automatique inter-Cloud. Par défaut, les salles blanches ne peuvent être partagées qu’avec des participants de la même région cloud sous-jacente. Pour activer les collaborations avec d’autres personnes dans différentes régions Cloud, vous devez activer l’exécution automatique inter-Cloud pour votre compte.
Activez les mises à jour automatiques de la version de la salle blanche. Activez l’environnement d’API des salles blanches pour qu’elles soient mises à jour automatiquement chaque fois que Snowflake publie une nouvelle version. Vous pouvez également installer les mises à jour manuellement, mais nous vous recommandons d’activer les mises à jour automatiques.