使用 BigQuery 的 ODBC 驅動程式

BigQuery 的開放式資料庫連線 (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 以上版本 相依性：適用於 Visual Studio 2019 或 2022 的 Microsoft Visual C++ 可轉散發套件
   macOS	64 位元 (x86_64)、ARM64 (Apple Silicon)	版本：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.json	KeyFilePath
   服務帳戶模擬	目標服務帳戶電子郵件地址	service-account@project.iam.gserviceaccount.com	ServiceAccountImpersonationEmail, KeyFilePath
   Workload Identity Federation 或 Workforce Identity Federation	外部帳戶設定檔的目標對象屬性	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	權杖擷取和環境資訊檔案	{"file":"/path/to/file"}	BYOID_CredentialSource
   	使用者專案 (僅限工作團隊集區)	my_project	BYOID_PoolUserProject
   	STS 權杖類型	id_token	BYOID_SubjectTokenType
   	STS 權杖交換端點	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   應用程式預設憑證	無	不適用	不適用

安裝及設定 ODBC 驅動程式

您可以使用 Windows 或非 Windows 作業系統，安裝及設定 BigQuery 的 ODBC 驅動程式。

建立連線

如要使用 BigQuery 的 ODBC 驅動程式，在應用程式與 BigQuery 之間建立連線，請找出連線字串。如果您已透過 DSN 設定連線屬性，可以略過這個步驟。

連線字串的格式如下：

Driver=ODBC Driver for BigQuery;Catalog=PROJECT_ID;OAuthMechanism=AUTH_TYPE;AUTH_PROPS;OTHER_PROPS

更改下列內容：

• PROJECT_ID：BigQuery 專案的 ID。
• AUTH_TYPE：指定您使用的驗證類型。選取下列其中一個選項：
  • 0：用於服務帳戶驗證
  • 3：用於應用程式預設憑證驗證
  • 4：適用於 Workload Identity Federation 或 Workforce Identity Federation 驗證
• AUTH_PROPS：您向 BigQuery 驗證身分時記下的驗證資訊，格式為 property_1=value_1; property_2=value_2;...，例如 KeyFilePath=my-sa-key.json (如果您使用服務帳戶驗證身分)。
• OTHER_PROPS (選用)：ODBC 驅動程式的其他連線屬性，以 property_1=value_1; property_2=value_2;... 格式列出。如需連線屬性的完整清單，請參閱「連線屬性」。

連線屬性

ODBC 驅動程式連線屬性是設定參數，您可以在建立資料庫連線時，將這些參數納入連線字串。BigQuery 的 ODBC 驅動程式支援下列連線屬性。

資料類型對應

透過 BigQuery 的 ODBC 驅動程式執行查詢時，系統會進行下列資料類型對應：

記錄和驅動程式設定

如要設定全驅動程式選項 (例如記錄和字元編碼)，請按照下列步驟操作：

驅動程式記錄層級

驅動程式支援記錄層級 0 到 3。建議先從 LogLevel=3 (INFO) 開始排解問題。

驅動程式層級的設定屬性 (非 Windows)

您可以在 googlebigqueryodbc.ini 的 [Driver] 區段中設定下列屬性：

範例

下列範例說明如何搭配 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 開發人員工具。