使用适用于 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++ Redistributable for Visual Studio 2019 或 2022
   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 进行身份验证，并记下以下信息，以便稍后在通过 ODBC 驱动程序与 BigQuery 建立连接时使用。您只需记下与您使用的身份验证方法对应的信息。

   身份验证方法	身份验证信息	示例	连接属性（稍后设置）
   标准服务账号	服务账号密钥（JSON 对象）	my-sa-key	KeyFilePath
   工作负载身份联合或员工身份联合	外部账号配置文件中的受众群体属性	//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;ProjectId=PROJECT_ID;OAuthType=AUTH_TYPE;AUTH_PROPS;OTHER_PROPS

替换以下内容：

• PROJECT_ID：BigQuery 项目的 ID。
• AUTH_TYPE：一个数字，用于指定您使用的身份验证类型。选择以下选项之一：
  • 0：用于服务账号身份验证
  • 3：用于应用默认凭据身份验证
  • 4：用于工作负载身份联合或员工身份联合身份验证
• AUTH_PROPS：您在向 BigQuery 进行身份验证时记下的身份验证信息，以 property_1=value_1; property_2=value_2;... 格式列出，例如 KeyFilePath=my-sa-key（如果您使用服务账号进行身份验证）。
• OTHER_PROPS（可选）：ODBC 驱动程序的其他连接属性，以 property_1=value_1; property_2=value_2;... 格式列出。如需查看连接属性的完整列表，请参阅连接属性。

连接属性

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 开发者工具。