Portail de support Workiva

Avec le connecteur Snowflake® JDBC, vous pouvez utiliser les commandes dans une chaîne pour effectuer des opérations en langage de requête structuré (SQL) dans les bases de données Snowflake. Par exemple, avec ce connecteur, vous pouvez :

• Exécuter des commandes SQL, y compris une instruction CREATE ou UPDATE ou une requête SELECT.
• Récupérer les détails d'une table dans Snowflake
• Insérer des enregistrements dans une base de données Snowflake

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Conditions préalables

Pour activer la connexion au Snowflake, un administrateur de sécurité de l'org doit d'abord l'activer à partir de Configuration.

Le connecteur lui-même utilise la connectivité de base de données Java (JDBC), sécurisée par une authentification de base ou par paire de clés. Pour configurer le connecteur, vous aurez besoin de :

• Un utilisateur d'intégration désigné créé dans Snowflake pour le connecteur, ainsi que le nom d'utilisateur et le mot de passe de l'utilisateur d'intégration.
  

  Note: L'authentification de base ne sera plus prise en charge à partir de novembre 2025. Nous recommandons d'utiliser plutôt l'authentification par paires de clés. En savoir plus.

• (Facultatif) Un fichier de clés privées pour activer l'authentification par paires de clés .
• L'URL de la connexion JDBC, telle que jdbc:snowflake://[accountName].snowflakecomputing.com/?[options].
• Pour se connecter à une base de données Snowflake sur site, un GroundRunner pour la connexion. (Pour se connecter à une instance de Snowflake dans le nuage, utilisez le CloudRunner par défaut).

Configurer le connecteur Snowflake

1. À partir du Générateur de chaînes, cliquez sur Connexions  compare_arrows, puis sur Créer en haut à droite.
2. Sous Connector Connection, sélectionnez Snowflake JDBC et le programme d'exécution à utiliser avec la connexion.
   
3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier la connexion.
4. (Facultatif) Sous Resources, téléchargez votre fichier de clé privée. Vous devrez saisir le nom exact du fichier dans le champ "Fichier de clé privée" à l'étape suivante.
5. Sous Properties, entrez les détails du connecteur :
   
   

   Propriété	Détails
   Nom d’utilisateur	Saisissez le nom d'utilisateur avec lequel vous souhaitez vous authentifier. Si un fichier de clé privée est fourni ci-dessous, il permettra d'authentifier automatiquement ce nom d'utilisateur.
   Mot de passe	Saisissez le mot de passe pour la propriété Username. Si un fichier de clé privée est fourni ci-dessous, saisissez le mot de passe ici. Note : Laisser vide pour les fichiers de clés non chiffrés.
   URL de connexion	Saisissez l'URL de la connexion JDBC, par exemple jdbc:snowflake://[accountName].snowflakecomputing.com/. Pour inclure des propriétés optionnelles pour la connexion, ajoutez-les en tant que chaîne de requête. Par exemple, pour retarder automatiquement l'ouverture d'une session si la connexion n'a pas lieu dans la minute qui suit, ajoutez ?loginTimeout=60.
   Fichier de clés privées	(Facultatif) Utilisé pour l'authentification avec la clé publique du serveur. Le nom d'utilisateur et le mot de passe doivent être saisis dans les champs ci-dessus. En savoir plus : Authentification et rotation des paires de clés Note: Le nom du fichier doit correspondre à un fichier téléchargé en tant que ressource de connexion.

   Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256. Pour des raisons de sécurité, évitez d'inclure les informations d'identification de l'utilisateur en tant que propriétés facultatives dans la propriété Connection URL.

6. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
7. Pour tester la connexion, créez et exécutez une chaîne avec la commande Get Table Definition du connecteur et vérifiez qu'elle renvoie un résultat valide.

Dépannage

• Si la connexion à Snowflake échoue :
  • Vérifiez les informations d'authentification.
  • Si vous utilisez l'authentification par paire de clés, assurez-vous que le nom de fichier téléchargé via Resources correspond au nom de fichier saisi dans le champ Private Key File.
  • Vérifiez l'URL de la connexion JDBC, y compris son nom de compte.
  • Si vous vous connectez à une base de données sur site, vérifiez le GroundRunner sélectionné pour le connecteur.
• Si la connexion ne parvient pas à exécuter une commande, vérifiez que ses entrées, telles que sa syntaxe SQL ou sa table, sont valides.
• Si une commande Snowflake échoue avec le message d’erreur Incoming request with IP/Token XX.XX.XX.XX is not allowed to access Snowflake, reportez-vous à cet article Snowflake pour savoir comment ajouter l’adresse IP requise ( CloudRunner ou GroundRunner) à la liste des adresses IP autorisées dans votre instance Snowflake.