无法连接到数据库

第 1 步。 检查您的网络设置

数据库可以在本地、在服务器上或在云中运行。 对于服务器和云数据库，您需要网络连接。 要验证连接是否可用，请使用 ping 和 telnet 命令。

使用 ping 命令，您可以确保目标计算机可从源计算机访问。 打开命令行并输入以下命令： ping -a <host_IP> ，其中 -a 是将地址解析为主机名的命令选项（如果可能）。 如果在 ping 命令中使用主机名，则会将主机名解析为 IP 地址。 例如， ping -a example.com 解析为 PING example.com (93.184.216.34)。

使用 telnet 命令，您可以测试到远程计算机的连通性并执行命令。 如果为 telnet 命令指定端口作为参数，您可以测试在给定端口上到远程主机的连通性。 如果连接成功，您会看到如下消息： Connected to <host_IP>。

第 2 步。 检查您的连接属性

每个数据库（MySQL、PostgreSQL、Oracle 或任何其他供应商）都有其自己的连接设置。 大多数数据库包含以下连接设置：

• 主机 ：存储数据库的计算机或其他设备的主机名。 它可以是 IP 地址 127.0.0.1 或域名 localhost 。

• 数据库 ：您要连接的数据库名称。 您可以在数据库服务器的设置中找到数据库名称，或者向数据库管理员咨询。 在某些情况下，可以在数据库命令行中运行查询以查看所有可用数据库的名称。 例如，在 MySQL 中，您可以运行 SHOW DATABASES;。

  

• 用户 ：具有足够权限以对数据库执行操作的用户名。 在数据库命令行中运行查询以查看所有可用数据库的名称。 例如，在 MySQL 中，您可以运行 SHOW GRANTS;。

  

• 密码 ：用户的密码。

• 端口 ：用于标识主机之间连接点的数字。 主机使用端口号来确定必须与哪个应用、服务或进程建立连接。 不同数据库供应商为其数据库使用不同的端口。 以下列表为默认端口号列表。

  供应商	默认端口
  Amazon Redshift	5439
  Apache Derby	1527
  Apache Cassandra	9042
  Apache Hive	10000（Hive Server2）或 9083（Hive Metastore）
  Azure SQL Database	1433
  ClickHouse	8123
  Couchbase Query Service 查询服务	11210
  Exasol	8563
  Greenplum	5432
  H2	8082
  HSQLDB	9001
  IBM Db2 LUW	50000
  MariaDB	3306
  Microsoft SQL Server	1433（TCP），1434（可能需要 UDP）
  MySQL	3306
  Oracle	1521
  PostgreSQL	5432
  Snowflake	443
  SQLite	无
  Sybase ASE	5000
  Vertica	5433

验证所选数据源的连接设置是否正确。 有关创建和更改数据源的更多信息，请参阅 创建数据源 和 会话。

第 3 步。 检查驱动程序版本

借助 JDBC 驱动程序，您可以在 PyCharm 中与数据库管理系统（DBMS）交互。 每个 DBMS 都需要其自身的 JDBC 驱动程序。 请确保驱动程序版本与 DBMS 版本彼此兼容。

在 PyCharm 中，您可以下载所有受支持供应商的驱动程序。 您可以在 驱动程序 列表（）中查看受支持供应商的完整列表。 或者，您可以将自己的驱动程序添加到现有供应商，或为未在 驱动程序 列表中的供应商创建新的驱动程序条目。

要打开 驱动程序 列表，请在 数据库 工具窗口（视图(V) | 工具窗口 | 数据库 ）中，点击 数据源属性 图标 ，或按 Shift+Enter。

下载驱动程序并选择驱动程序版本

要从 JetBrains FTP 服务器下载驱动程序，请在 驱动程序 列表中选择一个供应商，然后在 驱动程序文件 窗格中点击 下载 版本 <version_number> 链接。

要更改驱动程序版本，请在 驱动程序文件 窗格中点击 版本 <version_number> 链接，并选择所需的驱动程序版本。

第 4 步。 （仅限 Windows）检查临时目录路径是否包含非 ASCII 字符

当前，临时目录路径不应包含非 ASCII 字符。 如果包含，您可以通过执行以下任一操作来解决该问题：

• 打开 Windows 控制面板，并导航到 设置 | 时间和语言 | 语言 | 管理语言设置 ，或在 Windows 10 中导航到 设置 | 时间和语言 | 语言和区域 | 管理语言设置。 在 用于非 Unicode 程序的语言 部分，将语言更改为您的本地语言。

• 要使 Java 使用仅包含 ASCII 字符的其他临时目录路径，请在 IDE 中转到 帮助 | 编辑自定义 VM 选项 ，并将 -Djava.io.tmpdir=<ASCII_characters_only_temp_directory_path> 添加到 pycharm.vmoptions 文件。

第 5 步。 检查是否需要使用 SSH 或 SSL 进行连接

为了使与数据库的连接更加安全，某些服务要求使用 SSH 或 SSL。

SSH

Secure Shell 或 SSH 是用于加密客户端与服务器之间连接的网络协议。

在 PyCharm 中，您可以通过以下方式之一创建 SSH 连接：

• 使用 PyCharm 的 SSH 隧道。 IDE 将使用您设置的 SSH 配置创建 SSH 隧道。

• 使用 PuTTy、Pageant 或 ssh-client 手动创建 SSH 隧道。

PyCharm SSH 隧道

PyCharm 可以根据您设置的 SSH 配置创建 SSH 隧道。 要访问 SSH 配置设置，请按 Ctrl+Alt+S 打开设置，然后选择 工具 | SSH 配置。

要将 SSH 隧道用于该数据源，请在 数据源和驱动程序 对话框（Shift+Enter ）的 SSH/SSL 选项卡中选中 使用 SSH 隧道 复选框。

创建的所有 SSH 连接会在项目中的所有数据源之间共享。 如果您不希望在项目之间共享连接，请在 SSH 连接设置中选中 仅对此项目可见 复选框。

使用 SSH 连接到数据库

1. 通过以下任一方式打开数据源属性：

   • 在 数据库 工具窗口的工具栏上，点击 数据源。

   • 按 Shift+Enter。

   

2. 选择您要为其设置 SSH 连接的数据源。

3. 点击 SSH/SSL 选项卡，并选中 使用SSH 隧道(H) 复选框。

4. 点击 添加SSH 配置。

5. 在 SSH 配置 对话框中，点击 添加 按钮。

6. 如果您不希望在项目之间共享该配置，请选中 仅对此项目可见 复选框。

7. 在 主机 和 端口 字段中，指定您的连接详细信息。

8. 在 用户名(U) 字段中输入您的用户名。

9. 在本教程中，我们使用加密的私钥文件和公钥文件进行身份验证。 在 身份验证类型(Y) 列表中，您可以选择一种身份验证方法：

   • 密码 ：使用密码访问主机。 要在 PyCharm 中保存该密码，请选中 保存密码 复选框。

   • 密钥对(OpenSSH 或 PuTTY) ：使用密钥对进行 SSH 身份验证。 要应用此身份验证方法，客户端计算机上必须有私钥，远程服务器上必须有公钥。 PyCharm 支持使用 OpenSSH 实用程序生成的私钥。

     指定存放您 私钥 的文件路径，并在相应字段中输入密码短语（如果有）。 要让 PyCharm 记住该密码短语，请选中 保存密码短语(E) 复选框。

   • OpenSSH 配置和身份验证代理 ：使用管理您的 SSH 密钥的凭据助手应用程序，例如 ssh-agent 或 Pageant（仅限 Windows）。

10. 点击 测试连接 以运行测试连接。

11. 在 SSH 配置 对话框中，点击 确定 以确认新的 SSH 配置设置。

12. 在 数据源和驱动程序 对话框的 本地端口 字段中，指定用于转发连接的本地端口号。 否则，PyCharm 将动态选择端口。

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

    

14. 点击 确定 以创建数据源。

示例

有关通过 SSH 连接到数据库的示例，请参阅 通过 SSH 连接到数据库 主题。

禁用到数据库的 SSH 连接

1. 通过以下任一方式打开数据源属性：

   • 在 数据库 工具窗口的工具栏上，点击 数据源。

   • 按 Shift+Enter。

   

2. 选择您要更改连接设置的数据源配置文件。

3. 点击 SSH/SSL 选项卡，并清除 使用SSH 隧道(H) 复选框。

4. 点击 应用。

手动创建 SSH 隧道

使用 PuTTY（Windows）创建 SSH 隧道

1. 下载并运行最新版本的 PuTTY SSH 和 Telnet 客户端（从 https://www.putty.org/ 下载该客户端）。

2. 在 PuTTY 配置 对话框中，导航到 连接 | SSH | 身份验证。

3. 在 用于身份验证的私钥文件 字段中，指定您的私钥文件路径，并点击 打开。

4. 在命令行窗口中，指定您用于 SSH 隧道的用户名，并按 Enter。 不要关闭命令行窗口。

5. 在 数据库 工具窗口 ，点击 数据源属性 图标 on the toolbar.

6. 选择您要更改连接设置的数据源配置文件。

7. 点击 SSH/SSL 选项卡，并选中 使用 SSH 隧道 复选框。

8. 从 身份验证类型 列表中，选择 OpenSSH 配置和身份验证代理。

9. 在 代理主机、 代理用户 和 端口 字段中，指定连接详细信息。

10. 要确保到数据源的连接成功，点击 测试连接。

使用 Pageant（Windows）创建 SSH 隧道

Pageant 是 PuTTY、PSCP、PSFTP 和 Plink 的 SSH 身份验证代理。 Pageant 会存储您的私钥，并在其运行期间，为 PuTTY 或 PyCharm 等其他工具提供已解锁的私钥。 您可以在 Windows 任务栏中找到 Pageant 图标。

1. 下载最新版本的 Pageant（从 https://www.putty.org/ 下载该客户端）。

2. 在 Windows 任务栏中，右键点击 Pageant 图标并选择 添加密钥。

3. 在 选择私钥文件 对话框中，导航到私钥文件（PPK 文件），并点击 打开。

4. （可选）输入私钥密码短语，并按 Enter。

5. 在 数据库 工具窗口 ，点击 数据源属性 图标 on the toolbar.

6. 选择您要更改连接设置的数据源配置文件。

7. 点击 SSH/SSL 选项卡，并选中 使用 SSH 隧道 复选框。

8. 从 身份验证类型 列表中，选择 OpenSSH 配置和身份验证代理。

9. 在 代理主机、 代理用户 和 端口 字段中，指定连接详细信息。

10. 要确保到数据源的连接成功，点击 测试连接。

使用 ssh-agent（macOS 和 Linux）创建 SSH 隧道

在命令行中运行所有用于 ssh-agent 的命令。

1. 确保 ssh-agent 正在运行。

   ssh-agent

2. 将您的密钥添加到代理（在以下示例中，密钥路径为 ~/.ssh/id_rsa ）。

   ssh-add ~/.ssh/id_rsa

3. （可选）在 macOS 上，您可以将 -K 选项添加到 ssh-add 命令中，以将密码短语存储在钥匙串中。 在 macOS Sierra 及更高版本中，您需要在 ~/.ssh/ 中创建 config 文件，内容如下：

   Host * UseKeychain yes AddKeysToAgent yes IdentityFile ~/.ssh/id_rsa

   如果在 .ssh 目录中还有其他私钥，请为每个密钥添加一行 IdentityFile。 例如，如果第二个密钥名为 id_ed25519 ，请为第二个私钥另行添加一行 IdentityFile ~/.ssh/id_ed25519。

4. 列出所有已添加的密钥。

   ssh-add -L

5. 在 数据库 工具窗口 ，点击 数据源属性 图标 on the toolbar.

6. 选择您要更改连接设置的数据源配置文件。

7. 点击 SSH/SSL 选项卡，并选中 使用 SSH 隧道 复选框。

8. 从 身份验证类型 列表中，选择 OpenSSH 配置和身份验证代理。

9. 在 代理主机、 代理用户 和 端口 字段中，指定连接详细信息。

10. 要确保到数据源的连接成功，点击 测试连接。

第 6 步。 如果您仍然需要帮助，请写信给我们

有关其他故障排除来源的更多信息，请参阅 PyCharm 故障排除。