BigQuery 用の ODBC ドライバを使用する

BigQuery 用の Open Database Connectivity（ODBC）ドライバを使用すると、Java 以外のアプリケーションを BigQuery に接続して、任意のツールとインフラストラクチャで BigQuery の機能を使用できます。Java アプリケーションを BigQuery に接続するには、BigQuery 用の JDBC ドライバを使用します。

BigQuery 用の ODBC ドライバは、Apache 2.0 ライセンスで使用できます。

始める前に

1. ODBC ドライバとドライバ マネージャーについて理解しておいてください。

2. オペレーティング システムが次の要件を満たしていることを確認します。

   オペレーティング システム	サポートされているアーキテクチャ	最小バージョンと依存関係
   Windows	32 ビット（x86）、64 ビット（x64）	バージョン: Windows 10、Windows Server 2016 以降 依存関係: Microsoft Visual C++ 再頒布可能パッケージ（Visual Studio 2019 または 2022 用）
   macOS	64 ビット（x86_64）、ARM64（Apple シリコン）	バージョン: macOS 12（Monterey）以降 依存関係: ODBC ドライバ マネージャー（unixODBC など）。インストール ディレクトリを DYLD_LIBRARY_PATH に追加してください。
   Linux	64 ビット（x86_64）	バージョン: glibc 2.27 以降（Ubuntu 20.04 LTS 以降、Debian 11 以降など）を含むディストリビューション 依存関係: ODBC ドライバ マネージャー（unixODBC など）。インストール ディレクトリを LD_LIBRARY_PATH に追加してください。

3. BigQuery に対して認証し、次の情報をメモします。この情報は、後で BigQuery 用 ODBC ドライバとの接続を確立するときに使用します。使用する認証方法に対応する情報のみをメモする必要があります。

   認証方法	認証情報	例	接続プロパティ（後で設定）
   標準サービス アカウント	サービス アカウント キー（JSON オブジェクト）	my-sa-key	KeyFilePath
   Workload Identity 連携または Workforce Identity 連携	外部アカウント構成ファイルのオーディエンス プロパティ	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	トークン取得と環境情報ファイル	{"file":"/path/to/file"}	BYOID_CredentialSource
   	ユーザー プロジェクト（Workforce プールの場合のみ）	my_project	BYOID_PoolUserProject
   	STS トークンのタイプ	id_token	BYOID_SubjectTokenType
   	STS トークン交換エンドポイント	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   アプリケーションのデフォルト認証情報	なし	なし	なし

ODBC ドライバをインストールして構成する

BigQuery 用の ODBC ドライバは、Windows オペレーティング システムと Windows 以外のオペレーティング システムのどちらでもインストールして構成できます。

接続を確立する

BigQuery 用 ODBC ドライバを使用してアプリケーションと BigQuery の間に接続を確立するには、接続文字列を特定します。DSN を使用して接続プロパティをすでに構成している場合は、この手順をスキップできます。

接続文字列の形式は次のとおりです。

Driver=ODBC Driver for BigQuery;ProjectId=PROJECT_ID;OAuthType=AUTH_TYPE;AUTH_PROPS;OTHER_PROPS

次のように置き換えます。

• PROJECT_ID: BigQuery プロジェクトの ID。
• AUTH_TYPE: 使用した認証のタイプを指定する数値。次のいずれかを選択します。
  • 0: サービス アカウント認証用
  • 3: アプリケーションのデフォルト認証情報による認証の場合
  • 4: Workload Identity 連携または Workforce Identity 連携の認証の場合
• AUTH_PROPS: BigQuery への認証時にメモした認証情報。property_1=value_1; property_2=value_2;... 形式で指定します。たとえば、サービス アカウントで認証した場合は KeyFilePath=my-sa-key です。
• OTHER_PROPS（省略可）: property_1=value_1; property_2=value_2;... 形式で指定された ODBC ドライバの追加の接続プロパティ。接続プロパティの一覧については、接続プロパティをご覧ください。

接続プロパティ

ODBC ドライバの接続プロパティは、データベースへの接続を確立するときに接続文字列に含める構成パラメータです。BigQuery 用の ODBC ドライバは、次の接続プロパティをサポートしています。

データ型マッピング

BigQuery 用の ODBC ドライバを介してクエリを実行すると、次のデータ型マッピングが行われます。

例

次の例は、ODBC ドライバでパラメータ化クエリと複数ステートメント スクリプトを使用する方法を示しています。

パラメータ化されたクエリ

// 1. Prepare statement
std::string insert_stmt = "INSERT INTO MyTable VALUES (?, ?, ?)";
status = SQLPrepare(hstmt, (SQLCHAR*)insert_stmt.c_str(), SQL_NTS);

// 2. Bind parameters
std::string str_val = "example_string";
long long int_val = 12345;
double float_val = 1.2345;

// Bind string field
status = SQLBindParameter(
    hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_VARCHAR, 50, 0,
    (SQLPOINTER)str_val.c_str(), str_val.size(), NULL);

// Bind integer field
status = SQLBindParameter(
    hstmt, 2, SQL_PARAM_INPUT, SQL_C_UBIGINT, SQL_BIGINT, 0, 0,
    &int_val, 0, NULL);

// Bind float field
status = SQLBindParameter(
    hstmt, 3, SQL_PARAM_INPUT, SQL_C_DOUBLE, SQL_DOUBLE, 0, 0,
    &float_val, 0, NULL);

// 3. Execute statement
status = SQLExecute(hstmt);

複数ステートメント スクリプト

// 1. Prepare and execute the multi-statement script
std::string query =
    "CREATE OR REPLACE TABLE MyTable (StringField STRING, IntegerField INTEGER); "
    "INSERT INTO MyTable VALUES ('example', 123); "
    "SELECT * FROM MyTable;";

status = SQLExecDirect(hstmt, (SQLCHAR*)query.c_str(), SQL_NTS);

// 2. Process results for each statement using SQLMoreResults
do {
    SQLSMALLINT num_cols;
    status = SQLNumResultCols(hstmt, &num_cols);

    if (num_cols > 0) {
        // This is a result-returning statement (e.g., SELECT)
        while (SQLFetch(hstmt) == SQL_SUCCESS) {
            // Process rows...
        }
    } else {
        // This is a non-result statement (e.g., CREATE, INSERT)
        SQLLEN row_count;
        SQLRowCount(hstmt, &row_count);
        // Process affected rows...
    }
} while (SQLMoreResults(hstmt) == SQL_SUCCESS);

料金

BigQuery 用の ODBC ドライバは無料でダウンロードできます。ただし、ドライバを使用する場合は、標準の BigQuery 分析料金が適用されます。

次のステップ

• BigQuery 用の JDBC ドライバの詳細を確認する。
• 他の BigQuery デベロッパー ツールを確認する。