# 使用密钥对认证创建 Snowflake 数据源

> 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: 官方文档

* 有关 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)，并首先将您的公钥文件提供给系统管理员。

一旦密钥文件准备就绪，您需要在 CLion 中创建一个 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. 在   客户端密钥文件  字段中，点击 ![浏览图标](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.browse.svg)   浏览  ，导航到您的  `.p8` 私钥文件，选择它并点击   打开  。

CLion 支持在 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. 点击   确定  以保存您的新数据源。

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

* Format: `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>`

* 示例： 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)

