Connecteur flocon de neige

Interroger les informations de Snowflake pour les utiliser avec les applications de Tulip

Audience

Veuillez noter que le Snowflake est technique et peut nécessiter votre support informatique pour créer les rôles et permissions appropriés.

Contact du support

Ce connecteur a été créé en collaboration avec Spaulding Ridge. Pour plus d'informations ou de questions, veuillez contacter Spaulding Ridge à l'adresse info@spauldingridge.com.

Objectif

Le connecteur Snowflake rationalise la manière d'interroger les informations d'un nuage de données Snowflake.

Notes sur le connecteur

• Le connecteur Snowflake est utilisé pour interroger des informations à partir de Snowflake ; actuellement, il n'y a pas de fonctionnalité pour écrire directement dans Snowflake. Cela peut être réalisé avec d'autres outils tels que l'API Tables.
• Le connecteur Snowflake peut produire assez facilement des lignes individuelles sous forme de variables. Pour interroger plusieurs lignes de données, des widgets personnalisés permettant de manipuler des tableaux seront nécessaires.
• Ladocumentation de Snowflake est disponible ici.

Configuration

Les éléments suivants sont nécessaires pour une utilisation correcte : * Capacité à créer des identifiants de sécurité en utilisant le rôle ACCOUNTADMIN * Capacité à utiliser des jetons de rafraîchissement pour générer des jetons d'accès supplémentaires (préférence en matière de sécurité pour la plupart des entreprises).

Pour activer cette connectivité, vous devez activer OAUTH sur votre instance Snowflake. 1. Connectez-vous à votre instance Snowflake avec un utilisateur ayant le rôle ACCOUNTADMIN. 2. Exécutez le script suivant pour créer une intégration de sécurité OAUTH

CREATE OR REPLACE SECURITY INTEGRATION oauth_tulip_int TYPE = OAUTH ENABLED = TRUE OAUTH_CLIENT = CUSTOM OAUTH_CLIENT_TYPE = 'CONFIDENTIAL' OAUTH_REDIRECT_URI = 'https://[instance].tulip.co' OAUTH_ISSUE_REFRESH_TOKEN_VALIDITY = 7776000 BLOCKED_ROLES_LIST = ('SYSADMIN')NOTE : La validité du jeton de rafraîchissement peut aller jusqu'à 90 jours. Les jetons d'accès sont générés de manière programmatique, mais les jetons de rafraîchissement sont créés manuellement. Snowflake dispose d'une documentation supplémentaire sur les informations d'identification de sécurité.

Veillez à mettre à jour l'URL OAUTH_REDIRECT_URI en fonction de l'URL de votre instance de tulipes.

1. Exécutez l'instruction describe ci-dessous pour obtenir les valeurs suivantes :
2. OAUTH_CLIENT_ID
3. OAUTH_REDIRECT_URI
4. OAUTH_AUTHORIZATION_ENDPOINT
5. OAUTH_TOKEN_ENDPOINT

DESC SECURITY INTEGRATION oauth_tulip_int ;

1. Exécutez l'instruction de sélection suivante pour obtenir les secrets des clients OAUTH :
2. OAUTH_CLIENT_SECRET2
3. OAUTH_CLIENT_SECRET

select SYSTEM$SHOW_OAUTH_CLIENT_SECRETS( 'OAUTH_TULIP_INT' ) ;5. Demander un code d'autorisation en naviguant vers l'URL :https://<yoursnowflakeinstance>.snowflakecomputing.com/oauth/authorize ?response_type=code&client_id=<OAUTH_CLIENT_ID>&redirect_uri=<valeur encodée deOAUTH_REDIRECT_URI>* Cela vous amènera à une fenêtre de connexion, connectez-vous et autorisez 'oauth_tulip_int' à accéder à votre compte snowflake. * Redirigé vers une page où l'URL contiendra code='xxxxxxxx'. Il s'agit de votre Auth Code Grant, conservez-le pour vous connecter dans Tulip.Veuillez noter:* Tous les paramètres de la requête doivent être encodés. Utilisez un outil tel que urlencoder.io pour encoder le texte correctement.

1. Connectez-vous à Tulip et ajoutez le connecteur Snowflake depuis la bibliothèque Tulip (Web ou Embedded).
2. Cliquez sur Production & testing & development dans la section environment settings sur le côté gauche de l'interface Tulip.
3. Mettez à jour le Host pour qu'il soit l'URL de votre instance Snowflake :

Allez sur votre instance Snowflake et copiez l'URL de votre compte située dans le coin inférieur droit de votre écran (il y aura un bouton sur lequel vous pourrez cliquer pour le copier).

1. Vous êtes maintenant en mesure de vous connecter de manière sécurisée à Snowflake depuis Tulip. Quelques exemples de fonctions sont inclus dans le contenu de la bibliothèque, y compris l'autorisation et l'obtention d'un jeton OAUTH.Exemple : Utilisez le Code Auth généré à l'étape 5 comme valeur pour refresh_token dans le modèle "Get OAuth2 Token".

Utilisation

Une fois que le jeton d'accès a été généré, il peut être utilisé comme jeton de support dans une requête SQL à Snowflake.

Assurez-vous que les requêtes sont définies comme des requêtes POST, et que /api/v2/statements est ajouté à la fin de l'url de l'hôte pour les requêtes de base de données.

Références supplémentaires

Ce guide de la communauté Snowflake fournit également un contexte supplémentaire pour l'intégration de Snowflake.