Se connecter à une base de données Snowflake

Last modified by Aurelie Bertrand on 2025/09/19 09:23

Pour se connecter à une base de données Snowflake :

Dans la boite Création d'un nouveau modèle de données, cliquez sur le bouton Snowflake de la section Base de données.

➡ La boîte de dialogue Base Snowflake s'affiche.
Sélectionnez le mode de connexion souhaité et renseignez les champs demandés :

Mode Connexion manuelle
La connexion sera visible dans la source de données uniquement
1. Renseignez les champs suivants :
  - Organisation : Le nom de l'organisation Snowflake.
  - Compte : Le nom unique du compte au sein de votre organisation Snowflake.
  - Port : Le port de la base de données.
  - Utilisateur : L'utilisateur avec lequel il faudra s'authentifier.
  - Mot de passe : Le mot de passe de l'utilisateur.
2. Cliquez sur le bouton Options afin de configurer l'authentification et/ou les paramètres de la connexion.
  Il est possible de configurer :
  - une authentification OAuth avec compte de service : consultez la documentation Snowflake Utilisation du flux d’identifiants de connexion du client OAuth 2.0 pour plus de détails.
  - une authentification Key-pair : consultez la documentation Snowflake Utilisation de l’authentification par paire de clés et rotation de clés pour plus de détails.
3. Cliquez sur le bouton Connexion pour obtenir le statut de la connexion (connexion réussie ou échec de la connexion). En cas d'échec, modifiez les paramètres de connexion.

Voici certaines options de connexion utiles/nécessaires à spécifier :

Mode Connexion nommée
La connexion sera visible dans le gestionnaire de connexions et utilisable par l'ensemble des sources de données.
1. Cliquez sur Sélectionner : le Gestionnaire des connexions aux bases de données s'affiche.
2. Vous pouvez :
  - Sélectionner une connexion existante dans la liste. Cliquez alors sur OK.
  - Créer une nouvelle connexion comme décrit sur la page Ajouter une connexion nommée.

Lorque la connexion est réussie, une boite de dialogue Sélection du contexte s'affiche :

Sélectionnez les catalogues que vous souhaitez importer et cliquez sur OK.
Dans l'onglet Requête, créez une requête via l'Assistant :
- Cochez la table à utiliser dans le panneau de gauche.
  ➡ Les colonnes correspondantes s'affichent dans le panneau droite.
- Vous pouvez retirer des colonnes en décochant les cases correspondantes. Le bouton permet de tout sélectionner.
- Vous pouvez définir des règles sur des colonnes : sélectionnez la colonne puis cliquez sur le bouton en haut à droite des colonnes et définissez la règle. La règle est ajoutée dans le tableau en-dessous des colonnes.
Cliquez sur Options si vous souhaitez modifier les propriétés avancées de la base de données. Consultez le paragraphe options ci-dessous.
Dans l'onglet Résultat, prévisualisez le résultat de la requête définie. Consultez la page Prévisualisation pour plus de détails.
Vous pouvez également y ajouter des transformations de données. Consultez la page Transformer les données pour plus de détails.
Une fois le résultat satisfaisant, cliquez sur Suivant pour configurer le modèle de données.

Options

Temps maximum de la requête	Durée maximum de la requête en secondes (60 secondes par défaut). Si définie à 0, il n'y pas de limite maximale.
Nombre de lignes par bloc	Nombre de lignes qui doivent être extraites de la base de données. Si défini à 0, le nombre prend la valeur "fetchsize" du pilote JDBC.
Nombre de réessais sur erreur	Nombre de fois où le requête est répétée en cas d'erreur. Si différent de 0, le délai entre chaque essai doit être spécifié, en secondes.
Persister l'erreur sur programmation	Permet de générer un cube contenant l'erreur. Tout le processus échouera plus tard, mais cela évite ainsi de refaire le job (et d'être à nouveau en erreur) pour toutes les tâches.
Mode données incrémentales	Le mode incrémental est utilisé pour l'alimentation incrémentale du cube : chaque rafraîchissement du cube ne ramène que les nouvelles données par rapport au rafraîchissement précédent. Il se base sur une colonne de référence et sur l'utilisation dans la requête d'un mot-clé : ${LASTVAL}. Par exemple : select ... where ref_col> '${LASTVAL} La colonne de référence est à renseigner dans le champ Colonne de référence en-dessous.

Il est possible de modifier la requête manuellement en sélectionnant Avancé....
La requête générée par l'assistant est affichée.

❗ Si vous rebasculez sur l'assistant, la requête sera écrasée.

Vous pouvez sauvegarder la requête saisie pour une utilisation ultérieure. Pour cela :

Cliquez sur le bouton Favoris .
Sélectionnez Ajouter aux favoris puis saisissez le nom que vous souhaitez donner à cette requête.
➡ La requête sera disponible depuis le même menu Favoris.

Il est également possible d'accéder à l'historique des modifications via le bouton Historique.