Wiki source code of Connecteur BigQuery

Last modified by jhurst on 2021/11/15 09:22
Show last authors
1 {{ddtoc/}}
2
3 ----
4
5 = Prérequis =
6
7 * Un compte Google BigQuery
8 * DigDash 2021R2 ou au dessus
9
10 = Création d'une source de données BigQuery =
11
12 == Création d'une connection nommée (optionnel) ==
13
14 Vous pouvez créer une connexion nommée afin de pouvoir réutiliser cette connexion dans plusieurs sources de données différentes. En centralisant la configuration de votre connexion, vous pourrez plus facilement reconfigurer la connexion sans devoir modifier les sources de données dans l'avenir si besoin.
15
16 Pour créer cette connexion nommée :
17
18 1. Ouvrez l'interface de gestion des connexions aux bases de données.
19 1. Cliquez sur le bouton ajouter.
20 1. Choisissez BigQuery dans la liste déroulante.
21 1. (((
22 Remplissez les informations de la connexion :
23
24 * **Hôte** : L'adresse de l'hôte BigQuery.
25 * **Port** : Le port de la base de données.
26 * **Projet** : Le nom de votre projet BigQuery.
27 * **Authentification** : La méthode d'authentification à utiliser (voir [[Authentification>>doc:||anchor="HAuthentification"]]).
28 * **Options** : Des options supplémentaires de connexion afin de configurer l'authentification et/ou les paramètres de la connexion.
29 )))
30
31 === Authentification ===
32
33 Il y a plusieurs méthodes d'authentification pour se connecter à BigQuery :
34
35 ==== Compte de service Google ====
36
37 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 :
38
39 * **OAuthServiceAcctEmail** : L'adresse email de votre compte de service Google
40 * **OAuthPvtKeyPath** : Le chemin du fichier .p12 ou .json sur le serveur DigDash
41
42 ==== Compte de d'utilisateur Google ====
43
44 Cette méthode n'est pas supportée.
45
46 ==== Tokens prégénérés ====
47
48 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 :
49
50 * **OAuthAccessToken** ou **OAuthRefreshToken** : Le token d'accès ou le token de rafraîchissement respectivement.
51
52 Si vous utilisez le token de rafraîchissement il vous faudra aussi :
53 * **OAuthClientId** : L'identifiant client.
54 * **OAuthClientSecret** : Le secret client.
55
56 ==== Identifiants par défaut d'application ====
57
58 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écéssaire.
59
60 == Configuration de la source de données ==
61
62 1. Cliquez sur **Sources** dans le Studio.
63 1. Cliquez sur BigQuery dans la catégorie **Bases de données**.
64 1. Choisissez une connexion nommée ou configurez une connexion manuelle.
65 1. Configurez votre requête en utilisant l'assistant de création de requêtes :
66 11. Sélectionnez une vue ou une table dans l'arbre à gauche.
67 11. Sélectionnez les colonnes que vous souhaitez récupérer dans le tableau en haut à droite.
68 11. Ajoutez si besoin des filtres en glissant et déposant des colonnes du tableau en haut à droite vers le tableau en bas à droite.
69 1. Une fois la requête configurée, vous pouvez prévisualiser les données dans l'onglet **Columns**.
70 1. Cliquez sur **Suivant**.