このページでは、BigQuery API の Cloud クライアント ライブラリの使用を開始する方法を説明します。クライアント ライブラリを使用すると、サポートされている言語で Google Cloud APIs に簡単にアクセスできます。サーバーにリクエストを送信して Google Cloud APIs を直接利用することもできますが、クライアント ライブラリを使用すると、記述するコードの量を大幅に削減できます。
Cloud クライアント ライブラリと以前の Google API クライアント ライブラリの詳細については、クライアント ライブラリの説明をご覧ください。
クライアント ライブラリをインストールする
C#
Install-Package Google.Cloud.BigQuery.V2 -Pre
詳細については、C# 開発環境の設定をご覧ください。
Go
go get cloud.google.com/go/bigquery
詳細については、Go 開発環境の設定をご覧ください。
Java
If you are using Maven, add
the following to your pom.xml
file. For more information about
BOMs, see The Google Cloud Platform Libraries BOM.
If you are using Gradle, add the following to your dependencies:
If you are using sbt, add the following to your dependencies:
If you're using Visual Studio Code, IntelliJ, or Eclipse, you can add client libraries to your project using the following IDE plugins:
The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.
詳細については、Java 開発環境の設定をご覧ください。
Node.js
npm install --save @google-cloud/bigquery
詳細については、Node.js 開発環境の設定をご覧ください。
PHP
composer require google/cloud-bigquery
詳細については、Google Cloud での PHP の使用をご覧ください。
Python
pip install --upgrade google-cloud-bigquery
詳細については、Python 開発環境の設定をご覧ください。
Ruby
gem install google-cloud-bigquery
詳細については、Ruby 開発環境の設定をご覧ください。
認証を設定する
Google Cloud APIs の呼び出しを認証するために、クライアント ライブラリではアプリケーションのデフォルト認証情報(ADC)がサポートされています。このライブラリは、一連の定義済みのロケーションの中から認証情報を探し、その認証情報を使用して API へのリクエストを認証します。ADC を使用すると、アプリケーション コードを変更することなく、ローカルでの開発や本番環境など、さまざまな環境のアプリケーションで認証情報を使用できるようになります。本番環境では、ADC の設定方法はサービスとコンテキストによって異なります。詳細については、アプリケーションのデフォルト認証情報を設定するをご覧ください。
ローカル開発環境では、Google アカウントに関連付けられている認証情報を使用して ADC を設定できます。
-
gcloud CLI を初期化するときは、アプリケーションに必要なリソースにアクセスする権限がある Google Cloud プロジェクトを指定してください。
認証情報ファイルを作成します。
gcloud auth application-default login
ログイン画面が表示されます。ログインすると、ADC で使用されるローカル認証情報ファイルに認証情報が保存されます。
クライアント ライブラリの使用
次の例は、クライアントを初期化し、BigQuery API 一般公開データセットに対してクエリを実行する方法を示しています。
C#
Go
Java
Node.js
PHP
Python
Ruby
補足資料
C#
次のリストは、C# のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Go
次のリストは、Go のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Java
次のリストは、Java のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Node.js
次のリストは、Node.js のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
PHP
次のリストは、PHP のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Python
次のリストは、Python のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
Ruby
次のリストは、Ruby のクライアント ライブラリに関連するその他のリソースへのリンクを示します。
サードパーティの BigQuery API クライアント ライブラリ
上記の表の Google がサポートするライブラリに加えて、サードパーティが提供する一連のライブラリも使用できます。
言語 | ライブラリ |
---|---|
Python | pandas-gbq(使用ガイド)、ibis(チュートリアル) |
R | bigrquery、BigQueryR |
Scala | spark-bigquery-connector |
次のステップ
- 利用可能な BigQuery コードサンプルを確認する。
- BigQuery API クライアント ライブラリを使用して一般公開データセットに対してクエリを実行する
- Jupyter ノートブックを使用して BigQuery API の一般公開データを可視化する。
使ってみる
Google Cloud を初めて使用される方は、アカウントを作成して、実際のシナリオでの BigQuery のパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
BigQuery の無料トライアル