BigQuery 用の ODBC ドライバと JDBC ドライバ

はじめに

Google は Simba と共同で、BigQuery の GoogleSQL を利用する ODBC ドライバと JDBC ドライバを提供しています。

JDBC ドライバと ODBC ドライバの目的は、既存のツールとインフラストラクチャで BigQuery の機能を活用できるようにすることです。高パフォーマンスのストレージの統合や予約の管理など、BigQuery の一部の機能は BigQuery API 経由でのみ利用できます。これらのドライバは BigQuery でのみ使用でき、他のプロダクトやサービスでは使用できません。これらのドライバは、追加のライセンス要件なしで使用できますが、アプリケーションの一部としてドライバを再配布することはできません。

現在の ODBC ドライバ

ODBC リリース 3.0.0.1001

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）
• リリースノート
• インストールと構成のガイド

注意: このリリースには以下の重要な変更があります。

• P12 サービス アカウント キーファイルはサポートされなくなりました。サービス アカウントに依存している場合は、代わりに JSON サービス アカウント キーファイルまたは古い ODBC リリースを使用する必要があります。
• 一部のオペレーティング システム（特に Ubuntu 18.04 と Windows 8.1）のサポートは終了しました。
• macOS バージョン 10.14（32 ビット）と 10.15（32 ビット）のサポートを終了しました。

前述のポイントの詳細については、インストールと構成のガイドをご覧ください。

ODBC リリース 2.5.2.1004

3.x リリースにアップグレードすることをおすすめします。2.5.x リリースはバグ修正と重要なセキュリティ アップデートに対して引き続きサポートされていますが、BigQuery の新機能は 3.x リリースにのみ追加されます。

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）
• リリースノート
• インストールと構成ガイド

注意:帯域外（OOB）認証フローの Google 非推奨を遵守するために、ODBC バージョン2.5.2 では、接続文字列の再認証や再作成が必要になる可能性がある変更が導入されています。これは、ユーザー アカウントのフローが変更され、非推奨の帯域外フローをサポートしなくなったためです。接続ダイアログが更新トークンを自動的に取得するため、確認コードを手動でコピーして貼り付ける必要がなくなりました。Linux と Mac の更新トークン スクリプトが Python に更新されました。詳細については、インストールと設定のガイドをご覧ください。

以前の ODBC バージョン

2.5.0.1001

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.4.6.1015

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.4.5.1014

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.4.3.1012

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.4.1.1009

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.4.0.1002

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.3.5.1009

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.3.3.1005

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

2.3.2.1003

• Windows 32 ビット（msi）
• Windows 64 ビット（msi）
• Linux 32 ビット / 64 ビット（tar.gz）
• macOS（dmg）

現在の JDBC ドライバ

JDBC リリース 1.3.2 1003

• JDBC 4.2 互換
• リリースノート
• インストールと構成ガイド

注意:帯域外（OOB）認証フローの Google 非推奨を遵守するために、JDBC バージョン1.3.2 では、接続文字列の再認証や再作成が必要になる可能性がある変更が導入されています。これは、ユーザー アカウントのフローが変更され、非推奨の帯域外フローをサポートしなくなったためです。詳細については、インストールと設定のガイドをご覧ください。

以前の JDBC バージョン

1.3.0 1001

• JDBC 4.2 互換

1.2.25.1029

• JDBC 4.2 互換

1.2.23.1027

• JDBC 4.2 互換

1.2.22.1026

• JDBC 4.2 互換

1.2.21.1025

• JDBC 4.2 互換

1.2.19.1023

• JDBC 4.2 互換

1.2.18.1022

• JDBC 4.2 互換

1.2.16.1020

• JDBC 4.2 互換

1.2.14.1017

• JDBC 4.2 互換

1.2.1.1001

• JDBC 4.2 互換
• JDBC 4.1 互換

報告されている問題とよくある質問

これらのドライバを使用して、BigQuery と既存の環境間でのデータの取り込みやエクスポートをすることはできますか？

これらのドライバは、BigQuery のクエリ インターフェースを利用しており、BigQuery の大規模な取り込みメカニズムやエクスポート機能を利用する機能は提供しません。

DML を使用して少量の INSERT リクエストを発行することはできますが、DML の制限の影響を受けます。

ドライバは BigQuery のネスト データスキーマと繰り返しデータスキーマをどのように処理しますか？

ネストデータと繰り返しデータ（GoogleSQL では STRUCTS と ARRAYS とも呼ばれる）は、これらの型の BigQuery API からの JSON 出力として表されます。これは、ODBC データモデルにはこのデータを表す適切な方法がないためです。これらの型を操作するクエリを実行できますが、クエリの出力スキーマの型が複雑な場合は、ドライバがそれらを JSON 形式でエンコードして出力します。

注: 繰り返し値の平坦化やレコード内の個別フィールドの選択など、論理ビューを定義することで、このようなデータをよりシンプルに表現できます。このケースでは、値を直接操作できます。値は JSON 表現を使用して表されません。

ドライバはパラメータ化されたクエリをサポートしていますか？

はい、ドライバは位置によるパラメータ化をサポートしています。実行前のクエリの準備段階で検証情報が提供されますが、実行するクエリのパフォーマンスには影響しないことに注意してください。

ドライバは SQL クエリ接頭辞をサポートしていますか？

BigQuery はクエリ接頭辞を使用したレガシー SQL 言語と GoogleSQL 言語の切り替えをサポートしていますが、ドライバはサポートしていません。ドライバは、接続の確立時に使用される SQL モードに関連した特定の状態を維持し、接続の確立時に明示的にオプションを設定します。接続が確立されると SQL モードが固定されるため、ドライバは、クエリ接頭辞を使用した SQL 言語の切り替えをサポートしません。

これらのドライバのサポートを受けるにはどうすればよいですか？

サポート オプションについては、サポートページをご覧ください。

ドライバを介して BigQuery にクエリを実行した場合、どのように課金されますか？

ドライバは無料でダウンロードできます。ドライバを介して実行されるクエリは、ドライバの構成方法に基づいて課金されます。

• デフォルトでは、ドライバから実行されるクエリにクエリの料金が適用されます。ドライバが大規模な結果セットをサポートするように構成されていない場合、クエリ料金のみが適用されます。
• 大規模な結果セットを宛先テーブルに書き込むようにドライバが構成されている場合、クエリの料金に加えてストレージの料金も適用されます。データは 24 時間保存されるため、テーブル結果に 24 時間分のストレージ料金がかかります。
• ドライバから Storage API を呼び出す場合は Storage API の料金が適用されます。この料金は、クエリ結果からのデータの読み取りに適用されますが、クエリでスキャンされたデータには適用されません。Storage API の料金は、大規模な結果セットにのみ適用されます。