# Google BigQuery

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

Procedure: 启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件，该插件在 CLion 中默认捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。

1. 按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  数据库工具和 SQL  插件并点击   Enable  。

Procedure: 官方文档

* 有关 Google BigQuery 的完整信息，请参阅 [官方文档](https://cloud.google.com/bigquery/docs)。

### 开始之前

本主题介绍了如何为 [连接](connecting-to-a-database.html)到您的 Google BigQuery 数据库在 CLion 中创建数据源，并运行测试连接的一般步骤。 假设您已经拥有必要的连接详细信息，并且数据库已启动并运行。

要了解您的 DBMS 软件，请参阅其 [官方文档](#official_information_links)。

### 先决条件

|  身份验证方法  |  先决条件  |
| --- | --- |
|  Google 服务账户  |      * 项目 ID    * 服务帐户电子邮件标识符    * 包含私钥的 JSON 文件    |
|  访问和刷新令牌  |      * 访问和刷新令牌    * 客户端 ID    * 客户端密钥    |

Procedure: 连接到 Google BigQuery 数据库

要连接到数据库，请创建一个数据源以存储您的连接详细信息。

1. 选择您要创建的数据源。 您可以通过以下一种方式完成此操作：

* 在主菜单中，前往 `文件｜新建｜数据源​` 并选择 Google BigQuery 。

* 在 数据库 工具窗口中，点击工具栏上的 ![新图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 新建 。 导航到 数据源 并选择 Google BigQuery 。

![创建一个新的数据源](https://resources.jetbrains.com/help/img/idea/2026.3/create_new_data_source.png)

2. 在   通用   标签的   数据源与驱动程序   对话框右侧窗格中，指定驱动程序和连接类型。

1.

在   驱动程序   列表中，保持默认驱动程序选项，除非您的连接需要其他驱动程序。

2.

从   连接类型   列表中根据您拥有的连接详细信息选择连接类型：

* 默认 ：通过使用 主机 、 端口 、 项目 ID 、 默认数据集 和 URL 进行连接。

* URL only ：仅使用 URL 连接。

对于   URL only   [连接类型](data-sources-and-drivers-dialog.html#connection_type)，您输入的 JDBC URL 会被原样使用，包括数据库凭据。

> **Note:**
> 对于   URL only   连接类型，JDBC URL 将以纯文本形式存储，并且也可以在 [IDE 日志文件](troubleshooting-materials.html#locate-ide-log) 和 [数据源信息](managing-data-sources.html#share-data-sources-between-different-ide-instances) 中查看。

对于其他连接类型，JDBC URL 被分解为连接详情。 您可以分别指定它们并使用自动生成的 URL，也可以直接在相应字段中输入 URL。

![数据源和驱动程序对话框的一般选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_general_tab.png)

3. 请检查连接设置区域底部是否有一个   下载缺失的驱动程序文件  链接。 点击此链接下载与数据库交互所需的驱动程序。 如需直接下载链接，请参阅 [JetBrains JDBC drivers](https://www.jetbrains.com/zh-cn/datagrip/jdbc-drivers/)页面。

![下载缺失的驱动文件链接](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_download_missing_drivers_link.png)

下载的 JDBC 驱动程序的位置是 [CLion 配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)。

您还可以使用自己的数据库驱动程序，而不是提供的驱动程序。 有关使用驱动程序连接到数据库的更多信息，请参阅 [将用户驱动程序添加到现有连接](jdbc-drivers.html#configure_a_jdbc_driver_for_an_existing_data_source)。

如果没有   下载缺失的驱动程序文件  链接，那么您已经拥有了所需的驱动程序。

4. 请指定数据库连接详细信息。 或者，将 JDBC URL 粘贴到   URL   字段中。

默认:

1.  在   主机   字段中输入您的服务器地址。

2.

在   端口  字段中，键入 Google BigQuery 的端口。 默认端口为 443。

> **Note:**
> 在您的系统上，实际端口号可能会有所不同。 请确认您与数据库管理员、服务器设置或托管服务提供商使用正确的端口号。

3.

从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 提供以下选项：

* Google Service Account ：通过使用 Google 服务帐户的电子邮件地址和服务帐户的私钥文件的完整路径。 有关创建数据源的教程，请参阅 [Google BigQuery 数据源：Google 服务帐户](connect-to-bigquery.html#google-service-account)。

* Google 用户帐户 ：通过提供您的 Google 用户帐户凭证连接到服务器。 每次连接到数据库时，此方法都需要认证。 有关数据源创建的教程，请参阅 [Google BigQuery 数据源：Google 用户帐户](connect-to-bigquery.html#google-user-account)。

* 访问 和刷新令牌 ：通过使用已从 Google Authorization 服务器 生成的访问或刷新令牌。 刷新令牌还需要您的 client ID 和您的 client secret。 如需了解有关令牌的更多信息，请参阅 [在 developers.google.com 上使用 OAuth 2.0 访问 Google API](https://developers.google.com/identity/protocols/OAuth2)。 有关数据源创建教程，请参阅 [Google BigQuery 数据源：访问和刷新令牌（OAuth 2.0）](connect-to-bigquery.html#connecting-with-access-and-refresh-tokens-oauth-2-0)。

* 应用默认凭据 ：通过使用通过 应用默认凭据 (ADC) 获取的凭据。 有关 ADC 及其获取方式的更多信息，请参阅 [cloud.google.com 上的服务帐户身份验证](https://cloud.google.com/docs/authentication/production)。 如需数据源创建教程，请参阅 [Google BigQuery数据源：应用默认凭据](connect-to-bigquery.html#application-default-credentials)。

* 无认证 ：无需认证。

4.  在   项目 ID  字段中，输入您的项目的唯一标识符。

5.

根据选择的身份验证方法，指定以下连接设置：

Google Service Account
: * 服务帐户邮箱 ：您的 Google 服务账号电子邮件地址。
:
: * 密钥文件 ：服务帐户的私钥文件完整路径。

访问 和刷新令牌
: * 访问令牌},{ ：您的访问令牌。
:
: * 刷新令牌 ：您的刷新令牌。
:
: * 客户端 ID ：您的客户 ID。
:
: * 客户端密钥 ：您的客户端密钥。

应用默认凭据
: * 服务帐户密钥文件 ：服务帐户的私钥文件完整路径。

6.  在   默认数据集  字段中，指定您要连接的默认数据集的名称。

7.

在   URL  字段中，CLion使用其他连接设置的值自动生成JDBC URL。

如果您需要使用包含某些附加设置的 JDBC URL，请将其粘贴到   URL  字段中。 使用的一般 URL 如下：

* 格式： `jdbc:bigquery://https://<host_address>:<port_number>;DefaultDataset=<dataset_name>`

* 示例： `jdbc:bigquery://https://www.googleapis.com/bigquery/v2:443;DefaultDataset=myDataset`

有关 URL 格式的更多信息，请参阅 [Google BigQuery 官方文档](https://storage.googleapis.com/simba-bq-release/jdbc/Simba%20Google%20BigQuery%20JDBC%20Connector%20Install%20and%20Configuration%20Guide.pdf)。

![数据库连接详细信息](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_bigquery_default.png)

URL only:

1.

从   身份验证   下拉列表中，选择您想要用于验证连接的身份验证方法。 提供以下选项：

* Google Service Account ：通过使用 Google 服务帐户的电子邮件地址和服务帐户的私钥文件的完整路径。 有关创建数据源的教程，请参阅 [Google BigQuery 数据源：Google 服务帐户](connect-to-bigquery.html#google-service-account)。

* Google 用户帐户 ：通过提供您的 Google 用户帐户凭证连接到服务器。 每次连接到数据库时，此方法都需要认证。 有关数据源创建的教程，请参阅 [Google BigQuery 数据源：Google 用户帐户](connect-to-bigquery.html#google-user-account)。

* 访问 和刷新令牌 ：通过使用已从 Google Authorization 服务器 生成的访问或刷新令牌。 刷新令牌还需要您的 client ID 和您的 client secret。 如需了解有关令牌的更多信息，请参阅 [在 developers.google.com 上使用 OAuth 2.0 访问 Google API](https://developers.google.com/identity/protocols/OAuth2)。 有关数据源创建教程，请参阅 [Google BigQuery 数据源：访问和刷新令牌（OAuth 2.0）](connect-to-bigquery.html#connecting-with-access-and-refresh-tokens-oauth-2-0)。

* 应用默认凭据 ：通过使用通过 应用默认凭据 (ADC) 获取的凭据。 有关 ADC 及其获取方式的更多信息，请参阅 [cloud.google.com 上的服务帐户身份验证](https://cloud.google.com/docs/authentication/production)。 如需数据源创建教程，请参阅 [Google BigQuery数据源：应用默认凭据](connect-to-bigquery.html#application-default-credentials)。

* 无认证 ：无需认证。

2.  在   项目 ID  字段中，输入您的项目的唯一标识符。

3.

根据选择的身份验证方法，指定以下连接设置：

Google Service Account
: * 服务帐户邮箱 ：您的 Google 服务账号电子邮件地址。
:
: * 密钥文件 ：服务帐户的私钥文件完整路径。

访问 和刷新令牌
: * 访问令牌},{ ：您的访问令牌。
:
: * 刷新令牌 ：您的刷新令牌。
:
: * 客户端 ID ：您的客户 ID。
:
: * 客户端密钥 ：您的客户端密钥。

应用默认凭据
: * 服务帐户密钥文件 ：服务帐户的私钥文件完整路径。

4.

在   URL  字段中，CLion使用其他连接设置的值自动生成JDBC URL。

如果您需要使用包含某些附加设置的 JDBC URL，请将其粘贴到   URL  字段中。 使用的一般 URL 如下：

* 格式： `jdbc:bigquery://https://<host_address>:<port_number>;DefaultDataset=<dataset_name>`

* 示例： `jdbc:bigquery://https://www.googleapis.com/bigquery/v2:443;DefaultDataset=myDataset`

有关 URL 格式的更多信息，请参阅 [Google BigQuery 官方文档](https://storage.googleapis.com/simba-bq-release/jdbc/Simba%20Google%20BigQuery%20JDBC%20Connector%20Install%20and%20Configuration%20Guide.pdf)。

> **Warning:**
> 对于   URL only  连接类型，   URL  字段内容以纯文本形式存储，并且也会存储在 [IDE 日志文件](troubleshooting-materials.html#locate-ide-log)和 [数据源设置文件](managing-data-sources.html#locate_the_datasources_xml_file)中。
>
>
>
> 请使用指定的字段提供您的敏感连接详细信息，而不是将它们放入   URL   字段中。

![数据库连接详细信息](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_bigquery_urlonly.png)

有关   通用   和   数据源与驱动程序   对话框其他选项卡（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）上的连接设置和属性的参考信息，请参阅 [连接设置和 DBMS 特定属性](#reference)。

5. 确保可以使用提供的详细信息建立数据库连接。 为此，请点击连接详细信息部分底部的   测试连接   链接。

![测试连接链接](https://resources.jetbrains.com/help/img/idea/2026.3/db_test_connection_link.png)

如果您遇到任何连接问题，请参考 [无法连接到数据库](connectivity-problems.html)页面。

6. （可选）默认情况下，仅默认项目和数据集会被检查并可供使用。 如果您还想使用其他项目和数据集，请在   架构  选项卡中选择它们以进行检查。

![数据源和驱动程序对话框中的 Schemas 选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_schemas_tab.png)

7. 点击   确定   创建数据源。

8. 在   数据库   工具窗口中找到您的新数据源。

* 有关 数据库 工具窗口的更多信息，请参阅相应的 [参考主题](database-tool-window.html)。 > **Tip:** > 要在新数据源节点下查看更多项目和数据集，请点击 M 中的 N 按钮并选择您需要的项目和数据集。 CLion 将进行内省并显示它们。 > > > > ![在数据库工具窗口中选择要内省和显示的数据库和架构](https://resources.jetbrains.com/help/img/idea/2026.3/connection_flow_show_databases_and_schemas.png)

* 有关在 CLion 中使用数据库对象的更多信息，请参阅 [数据库对象](database-objects.html)。

* 要编写并运行查询，请点击数据源并按下 `F4` (Windows), `⌘ ↓` (macOS), `F4` (IntelliJ IDEA Classic (macOS)), `F4` (macOS System Shortcuts), `F4` (XWin), `F4` (GNOME), `F4` (KDE), `F4` (Emacs), `F4` (Sublime Text), `F4` (Sublime Text (macOS)), `⌘ ↓` (Xcode), `F4` (Visual Studio), `⌘ ↓` (Visual Studio (macOS)), `F4` (ReSharper), `⌘ ↓` (ReSharper (macOS)), `F4` (QtCreator), `F4` (QtCreator (macOS)), `F4` (NetBeans), `F12` (Eclipse), `F3` (Eclipse (macOS))，以打开默认的 [查询控制台](query-consoles.html)。

* 要查看和编辑数据库对象的数据，双击该对象并打开 [数据编辑器对话框](data-editor-and-viewer.html)。

## 连接设置和 DBMS 特定属性

### 连接设置

有关   数据源与驱动程序   对话框（ `Shift+Enter` (Windows), `⌘ I` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Shift+Enter` (Sublime Text), `⌘ I` (Sublime Text (macOS)), `⌘ I` (Xcode), `Shift+Enter` (Visual Studio), `⌘ I` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⌘ I` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `Shift+Enter` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⌘ I` (Eclipse (macOS))）中   通用   及其他选项卡上的连接设置（例如，   主机  、   端口   等）的参考信息，请参见 [数据源](data-sources-and-drivers-dialog.html#db)。

### 数据库管理系统特定属性

#### 常规选项卡

|  项  |  描述  |  身份验证方法  |
| --- | --- | --- |
|  项目 ID  |     项目的唯一标识符。     |      * Google Service Account    * Google 用户帐户    * 访问 和刷新令牌    * 应用默认凭据    |
|  服务帐户邮箱  |     Google 服务帐户电子邮件地址。     |    Google Service Account    |
|  密钥文件和服务账号密钥文件  |     服务帐户私钥文件的完整路径。     |      * Google Service Account    * 应用默认凭据    |
|  访问令牌},{  |     生成的访问令牌。     |    访问 和刷新令牌    |
|  刷新令牌  |     生成的刷新令牌。     |
|  客户端 ID  |     生成的 Google 客户端 ID。     |
|  客户端密钥  |     生成的 Google 客户端密钥。     |
|  默认数据集  |     默认数据集的名称。     |      * Google Service Account    * Google 用户帐户    * 访问 和刷新令牌    * 应用默认凭据    |

## See also

### 参考

[数据源及其元素](database-tool-window.html#icons-for-data-sources-and-their-elements) [数据源和驱动程序对话框](data-sources-and-drivers-dialog.html)

### 工具窗口

[数据库工具窗口](database-tool-window.html)

