Cette page explique comment débuter avec les bibliothèques clientes Cloud pour l'API BigQuery. Les bibliothèques clientes facilitent l'accès aux API Google Cloud à l'aide d'un langage compatible. Bien que vous puissiez utiliser directement les API Google Cloud en envoyant des requêtes brutes au serveur, les bibliothèques clientes fournissent des simplifications qui réduisent considérablement la quantité de code à écrire.
Pour en savoir plus sur les bibliothèques clientes Cloud et les anciennes bibliothèques clientes des API Google, consultez la page Présentation des bibliothèques clientes.
Installer la bibliothèque cliente
C#
Install-Package Google.Cloud.BigQuery.V2 -Pre
Pour en savoir plus, consultez la page Configurer un environnement de développement C#.
Go
go get cloud.google.com/go/bigquery
Pour plus d'informations, consultez la page Configurer un environnement de développement Go.
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.
Pour en savoir plus, consultez la page Configurer un environnement de développement Java.
Node.js
npm install --save @google-cloud/bigquery
Pour en savoir plus, consultez la section Configurer un environnement de développement Node.js.
PHP
composer require google/cloud-bigquery
Pour en savoir plus, consultez la page Utiliser PHP sur Google Cloud.
Python
pip install --upgrade google-cloud-bigquery
Pour en savoir plus, consultez la page Configurer un environnement de développement Python.
Ruby
gem install google-cloud-bigquery
Pour en savoir plus, consultez la section Configurer un environnement de développement Ruby.
Configurer l'authentification
Pour authentifier les appels aux API Google Cloud, les bibliothèques clientes sont compatibles avec le service d'Identifiants par défaut de l'application (ADC). Les bibliothèques recherchent des identifiants dans un ensemble d'emplacements définis et les utilisent pour authentifier les requêtes adressées à l'API. Le service ADC vous permet de mettre des identifiants à disposition de votre application dans divers environnements, tels que l'environnement de développement local ou l'environnement de production, sans avoir à modifier le code de votre application.Pour les environnements de production, la façon de configurer le service ADC dépend du service et du contexte. Pour en savoir plus, consultez la page Configurer les identifiants par défaut de l'application.
Pour un environnement de développement local, vous pouvez configurer ADC avec les identifiants associés à votre compte Google :
Installez et initialisez la gcloud CLI.
Lorsque vous initialisez la gcloud CLI, veillez à spécifier un projet Google Cloud dans lequel vous êtes autorisé à accéder aux ressources dont votre application a besoin.
Créez votre fichier d'identifiants :
gcloud auth application-default login
Un écran de connexion s'affiche. Une fois que vous êtes connecté, vos identifiants sont stockés dans le fichier d'identifiants local utilisé par ADC.
Utiliser la bibliothèque cliente
L'exemple suivant montre comment initialiser un client et lancer une requête sur un ensemble de données public de l'API BigQuery.
C#
Go
Java
Node.js
PHP
Python
Ruby
Autres ressources
C#
La liste suivante contient des liens vers davantage de ressources liées à la bibliothèque cliente pour C# :
Go
La liste suivante contient des liens vers d'autres ressources liées à la bibliothèque cliente pour Go :
Java
La liste suivante contient des liens vers d'autres ressources liées à la bibliothèque cliente pour Java :
Node.js
La liste suivante contient des liens vers d'autres ressources liées à la bibliothèque cliente pour Node.js :
PHP
La liste suivante contient des liens vers d'autres ressources liées à la bibliothèque cliente pour PHP :
Python
La liste suivante contient des liens vers d'autres ressources liées à la bibliothèque cliente pour Python :
Ruby
La liste suivante contient des liens vers d'autres ressources liées à la bibliothèque cliente pour Ruby :
Bibliothèques clientes tierces de l'API BigQuery
Outre les bibliothèques clientes acceptées par Google et répertoriées dans les tableaux ci-dessus, un ensemble de bibliothèques tierces est disponible.
Langue | Bibliothèque |
---|---|
Python | pandas-gbq (guide d'utilisation), ibis (tutoriel) |
R | bigrquery, BigQueryR |
Scala | spark-bigquery-connector |
Étape suivante
- Affichez les exemples de code BigQuery disponibles.
- Interroger un ensemble de données public avec les bibliothèques clientes de l'API BigQuery
- Visualisez les données publiques de l'API BigQuery à l'aide d'un notebook Jupyter.
Faites l'essai
Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de BigQuery en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits offerts pour exécuter, tester et déployer des charges de travail.
Profiter d'un essai gratuit de BigQuery