Skip to main content
Formulaire de configuration de la source BigQuery

​
Présentation

La source BigQuery synchronise les données depuis une table Google BigQuery directement dans Reelevant. C’est idéal pour les équipes qui centralisent leurs données dans BigQuery et souhaitent les exploiter pour la personnalisation.

​
Configuration

​
Champs obligatoires

​
Authentification

BigQuery prend en charge deux méthodes d’authentification :
Authentification à l’aide d’une clé de compte de service Google Cloud.
Le rôle minimum requis est BigQuery Data Viewer (roles/bigquery.dataViewer) sur le dataset cible. Si vous utilisez une requête SQL personnalisée, le compte de service a également besoin du rôle BigQuery Job User (roles/bigquery.jobUser) sur le projet.

​
Champs optionnels

​
Requêtes SQL personnalisées

Lorsque vous fournissez une requête SQL personnalisée, Reelevant l’exécute sur BigQuery au lieu de lire la table entière. Cela est utile pour :
  • Filtrer des lignes (par ex. SELECT * FROM my_table WHERE active = true)
  • Sélectionner des colonnes spécifiques
  • Joindre plusieurs tables
  • Appliquer des transformations
La requête doit être en SQL standard BigQuery valide. Assurez-vous que le compte de service a la permission d’exécuter des jobs dans le projet.

​
Synchronisation incrémentale

BigQuery prend en charge la synchronisation incrémentale lorsqu’il est utilisé avec le mode de mise à jour Keep Previous Data. Pour l’activer : Lorsque cette option est configurée, Reelevant ne récupère que les lignes dont le champ timestamp est supérieur à la dernière valeur enregistrée, en ajoutant les nouvelles données au dataset existant.
Si votre Datasource utilise le mode de mise à jour Override Previous Data (par défaut), le champ timestamp n’est pas nécessaire — la table entière ou le résultat de la requête est réimporté à chaque synchronisation.

​
Types de données pris en charge

Les types de données BigQuery sont automatiquement convertis : | Type BigQuery | Comportement | ||----------| | STRING, INT64, FLOAT64, BOOL | Transmis tels quels. | | DATE, DATETIME, TIME, TIMESTAMP | Convertis en leur représentation textuelle. | | NUMERIC, BIGNUMERIC | Convertis en nombres JavaScript. | | STRUCT (enregistrements imbriqués) | Aplatis en champs individuels. | | ARRAY (champs répétés) | Préservés sous forme de tableaux. |

​
Fonctionnement

  1. Reelevant s’authentifie auprès de BigQuery avec les identifiants fournis.
  2. Si une requête personnalisée est fournie, elle est exécutée. Sinon, la table complète est exportée.
  3. Pour les tables volumineuses, Reelevant utilise un pipeline d’export vers GCS optimisé pour de meilleures performances.
  4. Les champs sont extraits et rendus disponibles pour le mapping.
  5. Lors des synchronisations suivantes, la requête ou la table est relue (ou récupérée de manière incrémentale si configuré).
Assurez-vous que le compte de service dispose d’un accès en lecture au dataset et à la table spécifiés. Le rôle minimum requis est BigQuery Data Viewer. Pour les requêtes personnalisées, le compte de service a également besoin du rôle BigQuery Job User.