使用适用于 BigQuery 的 ODBC 驱动程序

借助 BigQuery 的 Open Database Connectivity (ODBC) 驱动程序，您可以将非 Java 应用连接到 BigQuery，从而将 BigQuery 功能与首选工具和基础架构结合使用。如需将 Java 应用连接到 BigQuery，请使用 JDBC 驱动程序（适用于 BigQuery）。

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

    身份验证方法 身份验证信息 示例 连接属性（稍后设置）
    标准服务账号 服务账号密钥（JSON 对象） my-sa-key.json KeyFilePath
    服务账号模拟 目标服务账号电子邮件地址 service-account@project.iam.gserviceaccount.com ServiceAccountImpersonationEmail, 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 驱动程序。

Windows

  1. 安装与应用架构对应的驱动程序：

  2. 通过执行以下操作来创建数据源名称 (DSN)：

    1. 在 Windows 开始菜单中，前往 ODBC 数据源，然后选择与客户端应用具有相同位数的版本。
    2. 在 ODBC 数据源管理员页面上，点击驱动程序标签页。
    3. 在已安装的 ODBC 驱动程序列表中，找到 ODBC Driver for BigQuery。
    4. 选择系统 DSN 标签页可为所有用户创建 DSN，选择用户 DSN 标签页可为当前用户创建 DSN。一般建议使用系统 DSN，因为某些应用会使用不同的用户账号加载数据，可能无法检测到其他用户 DSN。
    5. 点击 Add（添加）。
    6. 在