# 创建使用密钥对身份验证的 Snowflake 数据源

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

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

此功能依赖于 数据库工具和 SQL 插件，该插件默认情况下在 IntelliJ IDEA 中绑定并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 没有 Ultimate 订阅时，数据库工具和 SQL 的功能支持在 IntelliJ IDEA 中受限。

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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

Procedure: 官方文档

* 有关 Snowflake 的完整信息，请参阅 [官方文档](https://docs.snowflake.net/manuals/user-guide.html)。

* [docs.snowflake.com 上的密钥对身份验证和密钥对轮换](https://docs.snowflake.com/en/user-guide/key-pair-auth)

在使用密钥对身份验证连接到 Snowflake 数据库之前，请确保先 [生成密钥文件](https://docs.snowflake.com/en/user-guide/key-pair-auth#configuring-key-pair-authentication)，并将公钥文件提供给系统管理员。

密钥文件准备就绪后，需要在 IntelliJ IDEA 中创建 Snowflake 数据源，并将其配置为使用密钥对身份验证。

Procedure: 创建要与密钥对身份验证搭配使用的 Snowflake 数据源

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

![选择 Snowflake 数据源](https://resources.jetbrains.com/help/img/idea/2026.3/create_new_data_source_snowflake.png)

2. 请检查连接设置区域底部是否有一个   下载缺少的驱动程序文件   链接。 点击此链接下载与数据库交互所需的驱动程序。 如需直接下载链接，请参考 [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)

3. 请指定数据库连接详情。

1.

在   主持人  字段中，输入用于连接到您的 Snowflake 帐户的 URL。 例如，  `myorg-myconnection.snowflakecomputing.com` 。

2.  从   身份验证   下拉列表中选择   身份验证器  。

3.

在   身份验证器  字段中，输入  `snowflake_jwt` 。

4.

在   用户   字段中，输入 Snowflake 用户名。

5.  将   密码   字段留空。

> **Tip:**
> 您可以通过右键点击   密码   字段并选择   设置为空  ，将其设置为空。
>
>
>
> !["设置为空"上下文菜单操作](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_password_set_empty.png)

6.  在   数据库  字段中，输入您要连接的数据库名称。

7.  在   架构   字段中，输入要连接到的架构名称。

8.  在   仓库   字段中，输入您要使用的 Snowflake 计算资源集群名称。

4. 在   数据源和驱动程序   对话框的   SSH/SSL   选项卡上，选中   使用 SSL   复选框。

5. 在   客户端密钥文件c   字段中，点击 ![浏览图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.browse.svg)   浏览  ，导航到您的  `.p8`  私有密钥文件，选择该文件并点击   打开  。

IntelliJ IDEA 支持在 Windows 上的 WSL 中使用私有密钥文件。 为此，请指定私有密钥文件的 WSL 路径。 例如，  `\\wsl$\Ubuntu\home\myuser\snowflake\rsa_key.p8` 。

6. 对于加密的私有密钥文件，请在   客户端密钥密码   字段中输入创建该文件时使用的密码短语。

7. 点击连接详细信息区域底部的   测试连接   链接，以启动与数据库的测试连接。

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

8. 点击   OK   以保存新的数据源。

除了在专用字段中指定连接详细信息之外，也可以在   常规   选项卡的   URL   字段中输入 JDBC URL。 通常使用的 URL 如下：

* 格式: `jdbc:snowflake://<organization_name>-<connection_name>.snowflakecomputing.com/?warehouse=<warehouse_name>&db=<database_name>&schema=<schema_name>&user=<snowflake_username>&private_key_file=<path_to_key_file>`

* 示例： Unix / Linux: `jdbc:snowflake://myorg-myconnection.snowflakecomputing.com/?warehouse=AUTH_WH&db=TESTDB&schema=MYSCHEMA&user=MYUSERNAME&private_key_file=/home/myuser/snowflake/rsa_key.p8` Windows: `jdbc:snowflake://myorg-myconnection.snowflakecomputing.com/?warehouse=AUTH_WH&db=TESTDB&schema=MYSCHEMA&user=MYUSERNAME&private_key_file=С:/Users/myuser/snowflake/rsa_key.p8` WSL: `jdbc:snowflake://myorg-myconnection.snowflakecomputing.com/?warehouse=AUTH_WH&db=TESTDB&schema=MYSCHEMA&user=MYUSERNAME&private_key_file=//wsl$/Ubuntu/home/myuser/snowflake/rsa_key.p8` macOS: `jdbc:snowflake://myorg-myconnection.snowflakecomputing.com/?warehouse=AUTH_WH&db=TESTDB&schema=MYSCHEMA&user=MYUSERNAME&private_key_file=/Users/myuser/snowflake/rsa_key.p8`

在这种情况下，请确保在对话框的   SSH/SSL   选项卡上启用 SSL 连接。 此外，如果需要，请在相应字段中提供密码短语。

* 常规 选项卡 ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_snowflake_key_pair_general.png)

* SSH/SSL 选项卡 ![数据库连接详情](https://resources.jetbrains.com/help/img/idea/2026.3/db_connection_details_snowflake_key_pair_ssh_ssl.png)

