使用不同的身份验证方法创建 Google BigQuery 数据源
启用 数据库工具和 SQL 插件
此功能依赖于 数据库工具和 SQL 插件，该插件在 PyCharm 中默认已捆绑并启用。 如果相关功能不可用，请确保您未禁用该插件。
按 Ctrl+Alt+S 打开设置，然后选择 。
打开 已安装 选项卡，找到 数据库工具和 SQL 插件，并选中插件名称旁的复选框。
官方文档
有关 Google BigQuery 的完整信息，请参阅 官方文档。
Google BigQuery 是基于 REST 的 Web 服务，可让您在大型数据集上运行复杂的 SQL 分析查询。
要创建 Google BigQuery 数据源并测试连接，您可以使用以下方法：
Google 用户帐号
使用 Google 用户帐号进行授权时，您需要在 Web 浏览器中接收授权代码。
连接到 Google BigQuery
要连接到数据库，请创建一个数据源以存储您的连接详细信息。
选择您要创建的数据源。 您可以使用以下方式之一：
在主菜单中，转到 并选择 Google BigQuery。
在 数据库 工具窗口中，点击工具栏上的
新建。 导航到 数据源 并选择 Google BigQuery。
检查连接设置区域底部是否有 下载缺失的驱动程序文件 链接。 点击此链接以下载与数据库交互所需的驱动程序。 有关直接下载链接，请参阅 JetBrains JDBC 驱动程序 页面。
下载的 JDBC 驱动程序的位置为 PyCharm 配置目录。
您也可以使用自己的数据库驱动程序，而不是提供的驱动程序。 有关使用您自己的驱动程序连接到数据库的详细信息，请参阅 将用户驱动程序添加到现有连接。
如果没有 下载缺失的驱动程序文件 链接，则表示您已具有所需的驱动程序。
在 身份验证 列表中，选择 Google 用户帐号。
在 项目ID 字段中，输入项目 ID。
通常，它是服务帐号电子邮件中位于 at 符号（
@）之后的部分。 例如，bigqueryproject-322409。 有关项目 ID 的格式，请参阅 创建服务帐号的官方说明。在 需要授权代码 对话框中，剪切该 URL，将其粘贴到 Web 浏览器的地址栏中，然后按 Enter 以访问该 URL。
在您的 Google 帐号中授权访问您的 Google BigQuery 应用程序。
复制从 Google 收到的授权代码，将其粘贴到 需要授权代码 对话框中，然后点击 确定。
确保可以使用提供的详细信息建立数据库连接。 为此，请点击连接详细信息部分底部的 测试连接 链接。
如果遇到任何连接问题，请参阅 无法连接到数据库 页面。
（可选）默认情况下，仅默认项目和数据集会被内省并可供使用。 如果还要使用其他项目和数据集，请在 架构 选项卡中选择它们以进行内省。
点击 确定 以创建数据源。
在 数据库 工具窗口中找到您的新数据源。
应用默认凭据
对于授权，Google BigQuery 驱动程序使用来自特殊凭据文件的数据—服务帐号密钥文件。 默认情况下，文件路径为 ~/.config/gcloud/application_default_credentials.json 。
您可以使用 GOOGLE_APPLICATION_CREDENTIALS 环境变量为凭据文件设置自定义位置。 或者，在 服务帐户密钥文件 字段中设置凭据文件的路径。
要为连接生成服务帐号密钥文件，您需要创建一个 Google Cloud Platform 服务帐号。
步骤 1。 获取凭据文件
按照 官方说明 创建服务帐号。
在向导的 为此服务账号授予项目访问权限 步骤，为此服务帐号选择角色。
例如，要获得只读访问权限，请在 Google BigQuery 菜单中选择 Google BigQuery 数据查看者、 Google BigQuery 作业用户 和 Google BigQuery 用户。 或者，选择 以获得访问项目内所有资源的权限。
有关角色和权限的更多信息，请参阅 Predefined roles and permissions at cloud.google.com。
按照 官方说明 生成并下载服务帐号密钥文件。
步骤 2。 连接到 Google BigQuery
要连接到数据库，请创建一个数据源以存储您的连接详细信息。
选择您要创建的数据源。 您可以使用以下方式之一：
在主菜单中，转到 并选择 Google BigQuery。
在 数据库 工具窗口中，点击工具栏上的
新建。 导航到 数据源 并选择 Google BigQuery。
检查连接设置区域底部是否有 下载缺失的驱动程序文件 链接。 点击此链接以下载与数据库交互所需的驱动程序。 有关直接下载链接，请参阅 JetBrains JDBC 驱动程序 页面。
下载的 JDBC 驱动程序的位置为 PyCharm 配置目录。
您也可以使用自己的数据库驱动程序，而不是提供的驱动程序。 有关使用您自己的驱动程序连接到数据库的详细信息，请参阅 将用户驱动程序添加到现有连接。
如果没有 下载缺失的驱动程序文件 链接，则表示您已具有所需的驱动程序。
在 身份验证 列表中，选择 应用程序默认凭据。
在 服务帐户密钥文件 字段中，输入您在 Step 1. Obtain credentials.
确保可以使用提供的详细信息建立数据库连接。 为此，请点击连接详细信息部分底部的 测试连接 链接。
如果遇到任何连接问题，请参阅 无法连接到数据库 页面。
（可选）默认情况下，仅默认项目和数据集会被内省并可供使用。 如果还要使用其他项目和数据集，请在 架构 选项卡中选择它们以进行内省。
点击 确定 以创建数据源。
在 数据库 工具窗口中找到您的新数据源。
Google 服务帐号
对于授权，Google BigQuery 驱动程序使用来自特殊凭据文件的数据—服务帐号密钥文件。 默认情况下，文件路径为 ~/.config/gcloud/application_default_credentials.json 。
您可以使用 GOOGLE_APPLICATION_CREDENTIALS 环境变量为凭据文件设置自定义位置。 或者，在 密钥文件 字段中设置凭据文件的路径。
要为连接生成服务帐号密钥文件，您需要创建一个 Google Cloud Platform 服务帐号。
步骤 1。 获取凭据文件
按照 官方说明 创建服务帐号。
在向导的 为此服务账号授予项目访问权限 步骤，为此服务帐号选择角色。
例如，要获得只读访问权限，请在 Google BigQuery 菜单中选择 Google BigQuery 数据查看者、 Google BigQuery 作业用户 和 Google BigQuery 用户。 或者，选择 以获得访问项目内所有资源的权限。
有关角色和权限的更多信息，请参阅 Predefined roles and permissions at cloud.google.com。
按照 官方说明 生成并下载服务帐号密钥文件。
步骤 2。 连接到 Google BigQuery
要连接到数据库，请创建一个数据源以存储您的连接详细信息。
选择您要创建的数据源。 您可以使用以下方式之一：
在主菜单中，转到 并选择 Google BigQuery。
在 数据库 工具窗口中，点击工具栏上的
新建。 导航到 数据源 并选择 Google BigQuery。
检查连接设置区域底部是否有 下载缺失的驱动程序文件 链接。 点击此链接以下载与数据库交互所需的驱动程序。 有关直接下载链接，请参阅 JetBrains JDBC 驱动程序 页面。
下载的 JDBC 驱动程序的位置为 PyCharm 配置目录。
您也可以使用自己的数据库驱动程序，而不是提供的驱动程序。 有关使用您自己的驱动程序连接到数据库的详细信息，请参阅 将用户驱动程序添加到现有连接。
如果没有 下载缺失的驱动程序文件 链接，则表示您已具有所需的驱动程序。
在 身份验证 列表中，选择 Google 服务帐号。
在 服务帐户电子邮件 字段中，输入服务帐号的名称。
您可以在 Google Cloud Platform 的 服务账号 页面（ ）上以 电子邮件 的形式找到服务帐号的名称。 有关创建服务帐号的名称格式的更多信息，请参阅 官方说明。 服务帐号的名称应如下所示：
intellij-ide@bigqueryproject-322409.iam.gserviceaccount.com。在 项目ID 字段中，输入项目 ID。
通常，它是服务帐号电子邮件中位于 at 符号（
@）之后的部分。 例如，bigqueryproject-322409。 有关项目 ID 的格式，请参阅 创建服务帐号的官方说明。在 密钥文件 字段中，输入您在 Step 1. Obtain credentials.
确保可以使用提供的详细信息建立数据库连接。 为此，请点击连接详细信息部分底部的 测试连接 链接。
如果遇到任何连接问题，请参阅 无法连接到数据库 页面。
（可选）默认情况下，仅默认项目和数据集会被内省并可供使用。 如果还要使用其他项目和数据集，请在 架构 选项卡中选择它们以进行内省。
点击 确定 以创建数据源。
在 数据库 工具窗口中找到您的新数据源。
访问令牌和刷新令牌（OAuth 2.0）
要使用 访问令牌和刷新令牌 身份验证方法连接到 Google BigQuery 数据库，需要以下凭据：客户端 ID 和客户端密钥、刷新令牌和访问令牌。
当您使用 OAuth 2.0 进行身份验证时，您的用户在用户同意屏幕上同意呈现给他们的条款后会完成身份验证。 OAuth 同意屏幕是一个对话框，用于显示谁请求访问用户的数据以及该数据的类型的通知。
在生成客户端 ID 和客户端密钥之前，您需要配置 OAuth 同意屏幕。
步骤 1。 获取凭据
按照 官方说明 创建 OAuth 同意屏幕。
有关用户同意的更多信息，请参阅 the User consent section at support.google.com
按照 官方说明 获取客户端 ID 和客户端密钥。
对于 URI，请使用以下地址：
https://developers.google.com/oauthplayground在 已创建 OAuth 客户端 窗口中找到您的客户端 ID 和客户端密钥。 或者，您可以点击已创建的 OAuth 客户端 ID 配置，并在此处获取您的凭据。
有了客户端 ID 和客户端密钥，您即可生成授权代码和令牌。 为此，请执行以下步骤：
在单独的浏览器选项卡中打开 the OAuth 2.0 Playground。
点击 OAuth 2.0 配置 图标，选中 使用您自己的 OAuth 凭据 复选框。
在 OAuth 客户端 ID 和 OAuth 客户端密钥 字段中，粘贴您的客户端 ID 和客户端密钥。
在 OAuth 2.0 配置 窗口中，点击 关闭。
在 步骤 1。 选择并授权 API 的向导中，选择 。
点击 授权 API。
在浏览器中按照向导操作，并向应用授予权限。
在 步骤 2 用授权代码换取令牌 上，点击 用授权代码换取令牌。
复制收到的刷新令牌和访问令牌。
步骤 2。 连接到 Google BigQuery
要连接到数据库，请创建一个数据源以存储您的连接详细信息。
选择您要创建的数据源。 您可以使用以下方式之一：
在主菜单中，转到 并选择 Google BigQuery。
在 数据库 工具窗口中，点击工具栏上的
新建。 导航到 数据源 并选择 Google BigQuery。
检查连接设置区域底部是否有 下载缺失的驱动程序文件 链接。 点击此链接以下载与数据库交互所需的驱动程序。 有关直接下载链接，请参阅 JetBrains JDBC 驱动程序 页面。
下载的 JDBC 驱动程序的位置为 PyCharm 配置目录。
您也可以使用自己的数据库驱动程序，而不是提供的驱动程序。 有关使用您自己的驱动程序连接到数据库的详细信息，请参阅 将用户驱动程序添加到现有连接。
如果没有 下载缺失的驱动程序文件 链接，则表示您已具有所需的驱动程序。
在 身份验证 列表中，选择 访问和刷新令牌。
在 项目ID 字段中，输入项目 ID。
通常，它是服务帐号电子邮件中位于 at 符号（
@）之后的部分。 例如，bigqueryproject-322409。 有关项目 ID 的格式，请参阅 创建服务帐号的官方说明。在 访问令牌 字段中，粘贴 您的访问令牌。
在 刷新令牌 字段中，粘贴 您的刷新令牌。
在 客户端ID 字段中，粘贴 您的客户端 ID。
在 客户端密钥 字段中，粘贴 您的客户端密钥。
确保可以使用提供的详细信息建立数据库连接。 为此，请点击连接详细信息部分底部的 测试连接 链接。
如果遇到任何连接问题，请参阅 无法连接到数据库 页面。
（可选）默认情况下，仅默认项目和数据集会被内省并可供使用。 如果还要使用其他项目和数据集，请在 架构 选项卡中选择它们以进行内省。
点击 确定 以创建数据源。
在 数据库 工具窗口中找到您的新数据源。
