Démarrage rapide : Utiliser des bibliothèques
Cette page explique comment utiliser l'API BigQuery dans votre langage de programmation favori.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Activez BigQuery API.
-
Créez un compte de service :
-
Dans la console Google Cloud, accédez à la page Créer un compte de service.
Accéder à la page "Créer un compte de service" - Sélectionnez votre projet.
-
Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.
Dans le champ Description du compte de service, saisissez une description. Exemple :
Service account for quickstart
. - Cliquez sur Créer et continuer.
-
Pour accorder l'accès à votre projet, attribuez le ou les rôles suivants à votre compte de service : Projet > Propriétaire.
Dans la liste Sélectionner un rôle, sélectionnez un rôle.
Pour ajouter des rôles supplémentaires, cliquez sur
Ajouter un autre rôle et ajoutez chaque rôle supplémentaire. - Cliquez sur Continuer.
-
Cliquez sur OK pour terminer la création du compte de service.
Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.
-
-
Créez une clé de compte de service :
- Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
- Cliquez sur Keys (Clés).
- Cliquez sur Ajouter une clé, puis sur Créer une clé.
- Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
- Cliquez sur Close (Fermer).
-
Définissez la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
pour qu'elle pointe vers le chemin du fichier JSON contenant la clé de votre compte de service. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir. -
Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
-
Activez BigQuery API.
-
Créez un compte de service :
-
Dans la console Google Cloud, accédez à la page Créer un compte de service.
Accéder à la page "Créer un compte de service" - Sélectionnez votre projet.
-
Dans le champ Nom du compte de service, saisissez un nom. La console Google Cloud remplit le champ ID du compte de service en fonction de ce nom.
Dans le champ Description du compte de service, saisissez une description. Exemple :
Service account for quickstart
. - Cliquez sur Créer et continuer.
-
Pour accorder l'accès à votre projet, attribuez le ou les rôles suivants à votre compte de service : Projet > Propriétaire.
Dans la liste Sélectionner un rôle, sélectionnez un rôle.
Pour ajouter des rôles supplémentaires, cliquez sur
Ajouter un autre rôle et ajoutez chaque rôle supplémentaire. - Cliquez sur Continuer.
-
Cliquez sur OK pour terminer la création du compte de service.
Ne fermez pas la fenêtre de votre navigateur. Vous en aurez besoin lors de la tâche suivante.
-
-
Créez une clé de compte de service :
- Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
- Cliquez sur Keys (Clés).
- Cliquez sur Ajouter une clé, puis sur Créer une clé.
- Cliquez sur Create (Créer). Un fichier de clé JSON est téléchargé sur votre ordinateur.
- Cliquez sur Close (Fermer).
-
Définissez la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
pour qu'elle pointe vers le chemin du fichier JSON contenant la clé de votre compte de service. Cette variable ne s'applique qu'à la session de shell actuelle. Par conséquent, si vous ouvrez une nouvelle session, vous devez de nouveau la définir.
Installer la bibliothèque cliente
C#
Pour savoir comment configurer votre environnement de développement C#, consultez le guide de configuration d'un environnement de développement C#.
Install-Package Google.Cloud.BigQuery.V2 -Pre
Go
go mod init YOUR_MODULE_NAME go get cloud.google.com/go/bigquery
Java
Pour savoir comment configurer votre environnement de développement Java, consultez le guide de configuration d'un environnement de développement Java.
Si vous utilisez Maven, ajoutez les lignes suivantes à votre fichier pom.xml
. Pour en savoir plus sur les BOM, consultez la page The Google Cloud Platform Libraries BOM (BOM des bibliothèques Google Cloud Platform).
Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :
Si vous utilisez sbt, ajoutez les éléments suivants à vos dépendances :
Si vous utilisez Visual Studio Code, IntelliJ ou Eclipse, vous pouvez ajouter des bibliothèques clientes à votre projet à l'aide des plug-ins IDE suivants :
Les plug-ins offrent des fonctionnalités supplémentaires, telles que la gestion des clés pour les comptes de service. Reportez-vous à la documentation de chaque plug-in pour plus de détails.
Node.js
Pour savoir comment configurer votre environnement de développement Node.js, consultez le guide de configuration d'un environnement de développement Node.js.
npm install --save @google-cloud/bigquery
PHP
composer require google/cloud-bigquery
Python
Pour savoir comment configurer votre environnement de développement Python, consultez le guide de configuration d'un environnement de développement Python.
pip install --upgrade google-cloud-bigquery
Ruby
Pour savoir comment configurer votre environnement de développement Ruby, consultez le guide de configuration d'un environnement de développement Ruby.
gem install google-cloud-bigquery
Importer les bibliothèques
C#
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour C#.
Go
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Go.
Java
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Java.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Node.js.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour PHP.
Python
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Python.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API BigQuery pour Ruby.
Initialiser un client BigQuery
Initialisez un client pour s'authentifier et se connecter à l'API BigQuery.
C#
Faites appel à la fonction BigQueryClient.Create() pour créer le client BigQuery.
Go
Faites appel à la fonction bigquery.NewClient() pour créer le client BigQuery.
Java
Utilisez la fonction BigQueryOptions.getDefaultInstance() pour vous servir des options d'authentification par défaut. Faites appel à la fonction BigQueryOptions.getService() pour créer le client BigQuery.
Node.js
Instanciez la classe BigQuery pour créer le client BigQuery.
PHP
Instanciez la classe BigQueryClient pour créer le client BigQuery.
Python
Instanciez la classe bigquery.Client pour créer le client BigQuery.
Ruby
Utilisez la fonction Google::Cloud::Bigquery.new pour créer le client BigQuery.
Interroger un ensemble de données
La requête suivante récupère les questions associées au tag google-bigquery
les plus consultées depuis l'ensemble de données public Stack Overflow.
SELECT CONCAT( 'https://stackoverflow.com/questions/', CAST(id as STRING)) as url, view_count FROM `bigquery-public-data.stackoverflow.posts_questions` WHERE tags like '%google-bigquery%' ORDER BY view_count DESC LIMIT 10
Cette requête utilise la syntaxe SQL standard de Google. Les bibliothèques clientes emploient par défaut la syntaxe SQL standard de Google. Pour changer de dialecte SQL, consultez la page Dialectes BigQuery SQL.
Exécuter la requête
Exécutez la requête suivante à l'aide du client BigQuery authentifié.
C#
Définissez une chaîne de requête, puis faites appel à la fonction client.ExecuteQuery() pour soumettre la requête et obtenir les résultats.
Go
Exécutez la fonction bigquery.Query() pour définir une requête, puis la fonction Query.Read() pour soumettre cette requête et obtenir les résultats.
Java
Définissez la requête avec une instance de QueryJobConfiguration. Démarrez la tâche de requête à l'aide de la méthode BigQuery.create().
Node.js
Utilisez la méthode BigQuery.query() pour lancer la requête.
PHP
Créez une configuration de requête et faites appel à la méthode BigQueryClient.startQuery() pour lancer la requête.
Python
Utilisez la méthode Client.query() pour lancer la requête.
Ruby
Utilisez la fonction Google::Cloud::Bigquery::Project.query pour lancer une requête et attendre les résultats.
En savoir plus sur les requêtes :
- Présentation du processus d'interrogation des données
- Exécuter des requêtes interactives et par lot
- Écrire les résultats de requêtes dans une table permanente
Afficher le résultat de la requête
Affichez les résultats de requête.
C#
Go
Faites appel à la fonction RowIterator.Next() pour charger chaque ligne dans un pointeur de structure.
Java
Itérez QueryResponse pour obtenir toutes les lignes dans les résultats. L'itérateur gère automatiquement la pagination. Chaque FieldList présente les colonnes par index numérique ou nom de colonne.
Node.js
Les résultats de la requête sont renvoyés sous forme de liste de lignes, chaque ligne étant un dictionnaire.
PHP
Appelez la méthode Job.queryResults() pour attendre la fin de la requête. Chaque ligne des résultats de la requête représente un tableau associatif.
Python
Itérez RowIterator pour obtenir toutes les lignes dans les résultats. L'itérateur gère automatiquement la pagination. Chaque ligne présente les colonnes par index numérique, nom de colonne ou bien sous forme d'attributs Python.
Ruby
La classe Google::Cloud::Bigquery::Data présente chaque ligne sous forme de hachage.
En savoir plus sur l'utilisation des tables dans BigQuery :
Code source complet
Le code source complet correspondant à l'exemple est présenté ci-dessous.
C#
Go
Java
Node.js
PHP
Python
Ruby
Comment ça s'est passé ?
Étape suivante
Obtenez davantage d'informations sur les bibliothèques clientes de l'API BigQuery.