专业的

无法连接到数据库

步骤 1. 检查您的网络设置

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

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

ping -a <host_IP>

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

telnet <host_IP> <port_number>

笔记

出于安全原因，DBMS 通常会丢弃所有 telnet 连接。telnet 命令允许您检查端口是否打开用于通信。

步骤 2. 检查您的连接属性

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

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

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

  

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

  

• 密码：用户的密码。

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

  小贩	默认端口
  亚马逊红移	5439
  ApacheDerby	第1527章
  Apache卡桑德拉	9042
  ApacheHive	10000 (Hive Server2) 或 9083 (Hive Metastore)
  Azure SQL 数据库	第1433章
  ClickHouse	8123
  Couchbase 查询查询服务	11210
  Exasol	8563
  Greenplum	5432
  氢2	8082
  HSQL数据库	9001
  IBM Db2 LUW	50000
  玛丽亚数据库	3306
  微软SQL服务器	1433 (TCP)、1434（可能需要 UDP）
  MySQL	3306
  Oracle	1521
  PostgreSQL	5432
  Snowflake	第443章
  SQLite	没有任何
  赛贝斯ASE	5000
  Vertica	5433

  笔记

  您的系统上的实际端口号可能有所不同。与数据库管理员、服务器设置或托管提供商验证您使用的端口号是否正确。

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

步骤3.检查驱动版本

使用 JDBC 驱动程序，您可以与 PyCharm 中的数据库管理系统 (DBMS) 进行交互。每个 DBMS 都需要自己的 JDBC 驱动程序。确保驱动程序版本和 DBMS 版本相互兼容。

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

要打开驱动程序列表，请在 数据库工具窗口（视图 | 工具窗口 | 数据库）中，单击数据源属性图标或按。ShiftEnter

下载驱动并选择驱动版本

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

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

步骤 4. 检查是否需要 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 配置设置，请按打开 IDE 设置并选择“工具”|“ SSH 配置。CtrlAlt0S

要对数据源使用 SSH 隧道，请选中“数据源和驱动程序”对话框 ( )的 SSH/SSL选项卡中的“使用 SSH 隧道”复选框。ShiftEnter

笔记

在大多数情况下，在SSH/SSL选项卡中设置 SSH 配置后，不需要修改常规选项卡设置，因为 PyCharm 将连接到 SSH 隧道的本地端。例外情况是，当您手动创建 SSH 隧道时，在这种情况下，您需要在“常规”选项卡上设置为“主机”。localhost

连接后，当服务器建立与数据库的连接时，SSH 隧道主机名将在具有 SSH 服务器的计算机上解析。

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

使用 SSH 连接到数据库

1. 打开数据源属性。您可以使用以下选项之一打开数据源属性：

   • 在 数据库工具窗口（视图|工具窗口| 数据库）中，单击数据源属性图标。

   • 按。ShiftEnter

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

3. 单击SSH/SSL选项卡并选中使用 SSH 隧道复选框。

4. 单击添加 SSH 配置按钮 ( )。

5. 在SSH对话框中，单击“添加”按钮。

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

7. 在Host、Username和Port字段中，指定您的连接详细信息。

8. 从身份验证类型列表中，您可以选择身份验证方法：

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

   • 密钥对（OpenSSH 或 PuTTY）：通过密钥对使用SSH 身份验证。要应用此身份验证方法，您必须在客户端计算机上拥有私钥并在远程服务器上拥有公钥。PyCharm 支持使用OpenSSH实用程序生成的私钥。

     指定存储私钥的文件的路径，并在相应字段中输入密码（如果有）。要让 PyC​​harm 记住密码，请选中“保存密码”复选框。

   • OpenSSH 配置和身份验证代理：使用管理 SSH 密钥的凭据帮助程序应用程序，例如ssh-agent。

9. 单击“确定”确认新的 SSH 配置设置。

10. 在“数据源和驱动程序”对话框的“本地端口”字段中，指定要从中转发连接的本地端口号。否则，PyCharm 会动态选择端口。

提示

有关使用 SSH 密钥的更多信息，请参阅生成新的 SSH 密钥并将其添加到 ssh-agent教程。

禁用与数据库的 SSH 连接

1. 打开数据源属性。您可以使用以下选项之一打开数据源属性：

   • 在 数据库工具窗口（视图|工具窗口| 数据库）中，单击数据源属性图标。

   • 按。ShiftEnter

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

3. 单击SSH/SSL选项卡并清除使用 SSH 隧道复选框。

4. 单击“应用”。

手动创建 SSH 隧道

使用 PuTTY 创建 SSH 隧道 (Windows)

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

2. 在PuTTY 配置对话框中，导航到连接 | SSH | 授权。

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

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

5. 在 数据库工具窗口（视图 | 工具窗口 | 数据库）中，单击工具栏上的数据源属性图标。

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

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

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

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

10. 要确保与数据源的连接成功，请单击“测试连接”。

使用 Pageant 创建 SSH 隧道 (Windows)

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. 在 数据库工具窗口（视图 | 工具窗口 | 数据库）中，单击工具栏上的数据源属性图标。

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

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

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

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

10. 要确保与数据源的连接成功，请单击“测试连接”。

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

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

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

   ssh-agent

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

   ssh-add ~/.ssh/id_rsa

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

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

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

4. 列出所有添加的键。

   ssh-add -L

5. 在 数据库工具窗口（视图 | 工具窗口 | 数据库）中，单击工具栏上的数据源属性图标。

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

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

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

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

10. 要确保与数据源的连接成功，请单击“测试连接”。

第 5 步：如果您仍需要帮助，请写信给我们

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