• Prérequis
• Connexion à une base de données BigQuery
• Authentification
  • Compte de service Google (Auth de service)
  • Tokens prégénérés
  • Identifiants par défaut d'application

Prérequis

• Un compte Google BigQuery
• L'installation du driver JDBC BigQuery : consultez la page Connecteur BigQuery
• DigDash 2021R2 ou au-dessus

Connexion à une base de données BigQuery

Pour récupérer les données d'une base de données BigQuery :

1. Dans la boite Création d'un nouveau modèle de données, cliquez sur le bouton BigQuery de la section Rapports. 
   
   ➡ La boîte de dialogue BigQuery s'affiche.
   
2. Sélectionnez le mode de connexion souhaité :​

• Mode Connexion manuelle
  La connexion sera visible dans la source de données uniquement.
  1. Entrez les informations de connexion :
     • Hôte : L'adresse de l'hôte BigQuery.
     • Port : Le port de la base de données.
     • Projet : Le nom de votre projet BigQuery.
     • Authentification : La méthode d'authentification à utiliser (voir Authentification).
     • Options : Des options supplémentaires de connexion afin de configurer l'authentification et/ou les paramètres de la connexion.
  2. Cliquez sur le bouton Connexion.
      
• 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.
  3. Cliquez sur le bouton Connexion.

3. Configurez votre requête en utilisant l'assistant de création de requêtes :
   1. Sélectionnez une vue ou une table dans l'arbre à gauche.
   2. Sélectionnez les colonnes que vous souhaitez récupérer dans le tableau en haut à droite.
   3. Ajoutez si besoin des filtres en glissant et déposant des colonnes du tableau en haut à droite vers le tableau en bas à droite.
4. Une fois la requête configurée, vous pouvez prévisualiser les données dans l'onglet Columns.
5. Cliquez sur Suivant.

Authentification

Il existe plusieurs méthodes d'authentification pour se connecter à BigQuery

Compte de service Google (Auth de service)

Pour cette méthode d'authentification, il vous faudra copier le fichier .p12 ou .json sur le serveur DigDash et spécifier deux options de connexion via le bouton d'options lors de la configuration de la connexion :

• OAuthServiceAcctEmail : L'adresse email de votre compte de service Google
• OAuthPvtKeyPath : Le chemin du fichier .p12 ou .json sur le serveur DigDash

Tokens prégénérés

Pour cette méthode d'authentification, il vous faudra spécifier plusieurs options de connexion via le bouton d'options lors de la configuration de la connexion, la première option dénote si vous allez utiliser un token d'accès ou de rafraîchissement :

• OAuthAccessToken ou OAuthRefreshToken : Le token d'accès ou le token de rafraîchissement respectivement.

Si vous utilisez le token de rafraîchissement il vous faudra aussi :

• OAuthClientId : L'identifiant client.
• OAuthClientSecret : Le secret client.

Identifiants par défaut d'application

Pour cette méthode d'authentification, il faut s'assurer d'avoir bien configuré les "Application Default Credentials" sur le "Google Identity Platform". Aucune option de connexion n'est nécessaire.