Google BigQuery

BigQuery est l’entrepôt de données de Google qui permet l’analyse évolutive des données. Cette intégration permet d’envoyer vos propriétés d’entrée spécifiques, ou toutes, vers BigQuery.

Fonctionnalités clés

La destination Google BigQuery offre les fonctionnalités clés suivantes :

  • Structure des événements : notre Référence des Events alimente BigQuery, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.

  • Prise en charge de plusieurs schémas: stocker les données d’événement selon votre schéma préféré/existant ou nous pouvons vous aider à en créer un universel.

  • Contrôle des données: sélectionnez vos propriétés ou cochez simplement une case pour les envoyer toutes vers BigQuery.

Configuration de la destination

Assurez-vous BigQuery API est activée. Plus de détails sont disponibles en suivant ce LINK. Utilisez Destination filters pour affiner les événements et/ou autres propriétés correspondant à vos besoins spécifiques.

Cette destination accueille tous les schémas, plus précisément :

  1. votre schéma de table existant ou,

  2. un schéma universel.

La première option est utile pour ceux qui souhaitent utiliser une table existante avec ses colonnes prédéfinies : c’est un scénario courant lorsque vous avez déjà des données stockées et c’est l’option recommandée car elle est rapide à configurer et les données peuvent être consultées directement depuis la colonne spécifique. Pour activer ce mode, dans le Configurationvous devez simplement cocher le Auto-discover table structure (recommended) puis procéder à la section Event Property Mapping pour sélectionner les colonnes dans BigQuery column et leurs valeurs dans Votre valeur . La seconde méthode repose sur un Universal schema, où toutes vos données (ou propriétés sélectionnées) sont stockées dans une seule colonne sous forme de chaîne JSON et en utilisant la fonction BigQuery PARSE_JSON vous pouvez récupérer des valeurs spécifiques. Nous suggérons de consulter la section Universal schema avec une explication détaillée sur la façon dont vous pouvez créer le schéma universel et déterminer si c’est la structure de table appropriée pour vous. Pour activer ce mode, dans le Configurationvous pouvez soit cocher Send all properties to BigQuery with universal schema afin que toutes les propriétés soient incluses ou vous pouvez saisir les propriétés que vous souhaitez envoyer en utilisant la Property name table dans la section Properties to include with universal schema .

Configuration

Settings
Description

Authentification

Requis Vos identifiants avec Google tels que définis dans l’interface Commanders Act selon : AdministrationIdentifiants du connecteurAjouter des identifiants de connecteurBigQuery

Project Id

Requis Sélectionnez l’identifiant de votre project dans le menu déroulant tel qu’indiqué dans la console BigQuery. Plus de détails sont disponibles en suivant ce LINK.

Dataset Id

Requis Sélectionnez l’identifiant de votre dataset tel qu’indiqué dans la console BigQuery. Plus de détails sont disponibles en suivant ce LINK.

Table Id

Requis Sélectionnez l’identifiant de la table tel qu’indiqué dans la console BigQuery. Plus de détails sont disponibles en suivant ce LINK.

Auto-discover table structure (recommended)

Cochez cette option pour activer la fonctionnalité d’auto-découverte de la structure de la table.

Envoyer toutes les propriétés vers BigQuery avec

un schéma universel

Cochez cette option pour envoyer toutes les propriétés vers BigQuery selon un schéma spécifique : voir la section Universal schema pour plus de détails.

Event property Mapping

Lorsque Auto-discover table structure (recommended) est cochée, vous devez mapper vos champs BigQuery en les sélectionnant dans le BigQuery column et définir leurs valeurs dans Votre valeur .

Property name [1]

Lorsque les deux Auto-discover table structure (recommended) et Send all properties to BigQuery with universal schema ne sont pas cochés, vous pouvez saisir les propriétés que vous souhaitez inclure dans votre table avec schéma universel, une par ligne.

[1] dans la section Properties to include with universal schema .

Universal schema

Les étapes suivantes ne sont pas nécessaires si vous cochez Auto-discover table structure (recommended) .

Lors de la sélection de Send all properties to BigQuery un schéma spécifique est requis. Consultez les sous-sections suivantes pour apprendre comment créer un schéma universel. Ceci n’est pas

Dataset

Accès BigQuery console pour localiser votre (1) identifiant de projet et cliquez (2) le trois points à droite. Sélectionnez (3) Create dataset dans le menu ou, alternativement, vous pouvez utiliser un dataset existant et passer à la sous-section suivante.

Création du dataset n°1.

Saisissez un (4) identifiant de dataset (par ex. "myDatasetId"), sélectionnez un (5) type d’emplacement et cliquez (6) CREATE DATASET.

Création du dataset n°2.

Table

Créez une table avec la structure suivante :

Nom du champ
Type
Mode

rawDataCa

Chaîne

Requis

createdAt

Timestamp

Requis

La manière la plus simple de la créer est de cliquer sur (7) le plus bouton :

Composer une nouvelle requête.

copiez et collez la requête suivante dans (8) la zone de saisie :

CREATE TABLE IF NOT EXISTS [PROJECT_ID].[DATASET_ID].[TABLE_ID] (rawDataCa STRING NOT NULL, createdAt TIMESTAMP NOT NULL) OPTIONS(description="CA raw event data stored in Google BigQuery")

Remplacez [PROJECT_ID] , [DATASET_ID] et [TABLE_ID] par votre project, dataset et identifiant de table respectivement. Vous définissez votre identifiant de table à cette étape.

puis cliquez sur le (9) RUN bouton.

Exécuter la requête de création de table.

Référence rapide

Commanders Act Events
Colonnes de la table BigQuery

[Any events] [1]

rawDataCa, createdAt [2]

[1] Utilisez Destination filters pour spécifier vos événements de correspondance. &#xNAN;[2] Deux colonnes : rawDataCa contient vos propriétés d’événement, tandis que createdAt est le timestamp de création.

Mis à jour

Ce contenu vous a-t-il été utile ?