PyCharm 2025.3 Help

数据源

启用 数据库工具和 SQL 插件

此功能依赖 数据库工具和 SQL 插件，该插件在 PyCharm 中默认随附并启用。 如果相关功能不可用，请确保您未禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置，然后选择 插件。

  2. 打开 已安装 选项卡，找到 数据库工具和 SQL 插件，并选中插件名称旁的复选框。

数据源 是连接配置。 它存储用于建立数据库连接的连接详细信息列表。 例如，主机、端口、数据库名称、驱动程序、SSH 和 SSL 配置设置等。 在数据源设置中，您还可以选择用于 内省 并在 数据库 工具窗口中显示的数据库和架构，并更改连接所用的驱动程序。

您可以在 数据源和驱动程序 对话框（Shift+Enter ）中配置数据源。 要打开该对话框，请在 数据库 工具窗口（视图(V) | 工具窗口 | 数据库 ）的工具栏上点击 数据源属性按钮数据源。

包含 PostgreSQL 数据库连接详细信息的数据源

您可以在 数据库 工具窗口（视图(V) | 工具窗口 | 数据库 ）中查看创建的数据源列表，并在其中浏览。

Database 工具窗口中的数据源

在 PyCharm 项目中，所有数据源的设置都存储在项目目录下的 .idea 子目录中的 dataSources.xml 文件 中。

在 PyCharm 中，您可以创建以下数据源：

  • 数据库数据源 ：包含数据的业务数据库的连接配置。

    对于不同的数据库，PyCharm 提供完整支持和基本支持。 对数据库的完整支持包括增强的代码补全以及更完善的数据库对象检索（内省）等功能。 还提供所有检查、快速修复和其他编码辅助功能，而基本支持仅提供有限的功能。

    有关支持类型的更多信息，请参阅 其他数据库 主题。

  • 数据定义语言（DDL）数据源 ：包含数据定义语言语句的 SQL 文件（请参阅 DDL 数据源）。

创建数据源

要连接数据库并开始使用，请创建一个包含连接详细信息的数据源，并为要连接的数据库指定这些详细信息。

支持的数据库

PyCharm 可以连接到本地或远程运行的数据库，无论是在主机服务器上还是在云平台上。

要创建数据源并对数据库运行测试连接，请按照专门主题中的说明进行操作。

完整支持

该 IDE 为以下数据库提供完整支持：

基本支持

以下数据库提供 基本支持：

  • Amazon Athena

  • Apache Ignite

  • Apache Phoenix

  • Apache Spark

  • Databricks

  • Denodo

  • DuckDB

  • Elasticsearch

  • Firebird

  • Google Cloud Spanner

  • IBM Informix

  • InterSystems IRIS

  • Mimer SQL

  • OpenEdge

  • Presto

  • SAP HANA

  • SingleStore

  • Tarantool

  • Teradata Vantage

  • TiDB

  • TmaxTibero

  • Trino

  • YugabyteDB

DDL 数据源

要创建 DDL 数据源，请按照 DDL 数据源 主题中的说明进行操作。

云数据库

PyCharm 还支持以下云数据库：

数据源的副本

复制数据源会保留所有连接设置，包括密码。 数据源只能在单个项目内复制。

  1. 您可以在 数据库 工具窗口或 数据源和驱动程序 中复制连接配置：

    • 在 数据库 工具窗口中，选择要复制的数据源，右键点击并选择 复制/粘贴 | 创建副本。

      在 Database 工具窗口中复制您的数据源

    • 在 数据源和驱动程序 对话框（Shift+Enter ）的左侧区域，选择要复制的数据源，然后在工具栏上点击 复制图标创建副本。

      在数据源和驱动程序对话框中复制您的数据源

    或者，选择该数据源并按 Ctrl+D。

    PyCharm 将创建一个具有相同设置（包括密码）的新数据源。

  2. 点击 确定 以保存新的数据源并关闭对话框。

数据源和驱动程序对话框中的已复制数据源

删除数据源

您可以通过以下方式之一删除数据源：

  • 要通过其上下文菜单删除数据源，请在 数据库 工具窗口（视图(V) | 工具窗口 | 数据库 ）中，右键点击要删除的数据源并选择 删除数据源。

  • 要在 数据源和驱动程序 对话框中删除数据源，请执行以下步骤：

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

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

      • 按 Shift+Enter。

      打开数据源和驱动程序对话框

    2. 在对话框的左侧区域，选择要删除的数据源，然后在工具栏上点击 移除。

  • 要在 数据源和驱动程序 对话框中通过其上下文菜单删除数据源，请在对话框的左侧区域，右键点击要删除的数据源并选择 移除。

配置数据源的显示选项

您可以在 数据库 工具窗口（视图(V) | 工具窗口 | 数据库 ）中对对象进行分组、指定颜色并筛选对象。

在文件夹中对数据源进行分组

在 PyCharm 中，您可以将数据源移动到新文件夹或现有文件夹。

  • 要将数据源移动到新文件夹，请执行以下操作：

    1. 右键点击该条目并选择 移动 | 到文件夹。 或者，按 F6。

    2. 如果尚不存在任何文件夹，PyCharm 将显示 新建文件夹 对话框。 如果已经存在文件夹，将出现 移动到文件夹 弹出窗口。 在弹出窗口中，选择 新建文件夹。

    3. 在 新建文件夹 对话框中，输入文件夹名称。 您可以使用正斜杠（/ ）来定义嵌套。 例如， QA/Quick 名称将在 QA 文件夹内创建 Quick 文件夹。

    创建新文件夹以对数据源进行分组

  • 要将数据源移动到现有文件夹，请执行以下操作：

    1. 右键点击该条目并选择 移动 | 到文件夹。 或者，按 F6。

    2. 在 移动到文件夹 弹出窗口中，选择目标文件夹。

    将条目移动到文件夹

要撤销操作，请按 Ctrl+Z。

为数据源指定颜色

  1. 在 数据源和驱动程序 对话框（Shift+Enter ）中，选择要指定颜色的数据源。

  2. 点击 名称 字段中的圆圈以选择颜色。

  3. 应用更改并关闭对话框。

有关在数据库树中为数据源和数据库对象指定颜色的更多信息，请参阅 为数据源和数据库对象分配颜色。

为数据源指定颜色

使用数据源的完整名称

默认情况下，会启用 缩短标签页标题 选项。 选项卡标题中的数据源名称会缩短为 36 个字符。

  • 右键点击 查询文件 的一个选项卡，然后选择 缩短标签页标题。

共享数据源

在 PyCharm 中，您可以在单个 IDE 实例内的不同项目之间共享数据源，也可以在不同的 IDE 实例之间共享数据源。 要在项目之间共享数据源，您必须更改其可访问性级别。 要在 IDE 之间共享数据源，您必须复制并粘贴它们，或使用 IDE 设置的导出和导入功能。

在项目之间共享数据源

PyCharm 中的数据源具有两个级别：项目级和全局级。 项目级意味着您只能从最初创建该数据源的项目访问该数据源。 在全局级，数据源可供其他项目使用。 默认情况下，数据源在项目级可用。

要在 IDE 内的不同项目之间共享数据源，您需要将该数据源移动到全局级。

  1. 在 数据库 工具窗口中，在工具栏上点击 数据源属性按钮数据源属性。

  2. 在打开的 数据源和驱动程序 对话框（Shift+Enter ）中，选择要设为全局的数据源，右键点击并选择 设为全局图标设为全局。。

    或者，在工具栏上点击 设为全局图标设为全局。

    在数据源和驱动程序对话框中将数据源设为全局

  3. 点击 确定 以保存更改并关闭对话框。

要将数据源重新设为本地，请点击该数据源上用于替换 设为全局图标设为全局 的 移至项目图标移动到项目。

数据源和驱动程序对话框中的全局级和项目级数据源

在 IDE 实例之间共享数据源

在 PyCharm 中，您可以通过将其设置复制到剪贴板，或使用包含所有项目数据源设置的 XML 文件来共享数据源。 此外，您可以使用 IDE 设置的导出和导入功能来导出和导入该文件。

原因是 PyCharm 没有自己的密码存储。 它要么使用原生密码管理系统，要么使用 KeePass。 要更改 IDE 存储密码的方式，请在 IDE 设置 Ctrl+Alt+S 中，导航到 外观与行为 | 系统设置 | 密码。 有关在 PyCharm 中存储密码的更多信息，请参阅 密码 主题。

将数据源复制到剪贴板

在 PyCharm 中，您可以将数据源复制到剪贴板。 执行此操作时，IDE 会将连接设置复制为 XML 片段。 您可以将该片段粘贴到另一款 IDE 中，并在那里创建原始数据源的副本。

  1. 在 数据库 工具窗口中，选择要复制的数据源。

  2. 右键点击所选数据源，并导航到 复制/粘贴 | 复制数据源 以将您的数据源复制到剪贴板。 或者，按 Ctrl+C。

    PyCharm 会复制包含连接设置的 XML 片段。

  3. 切换到目标 IDE，或将该数据源发送给其他用户。

  4. 在目标 IDE 中，打开 数据库 工具窗口。

  5. 在 数据库 工具窗口中，点击 新建图标新建 ，并选择 从剪贴板导入。 或者，右键点击 数据库 工具窗口并选择 复制/粘贴 | 粘贴数据源 （或按 Ctrl+V）。

  6. 在打开的 数据源和驱动程序 对话框（Shift+Enter ）中，输入使用此数据源连接的数据库或架构的密码。

  7. 点击 确定 以保存新的数据源并关闭对话框。

对于每个 PyCharm 项目，都会有一个 dataSources.xml 文件，用于存储该项目所有数据源的设置。 通过复制此文件，您可以将数据源与另一个 IDE 实例共享。 此外，您可以将该文件置于 VCS 下以跟踪更改，并在多个用户之间同步数据源列表。

dataSources.xml 文件存储在 IDE projects directory 中专用项目设置目录的 .idea 子目录下。

定位 dataSources.xml 文件

  1. 在 项目 工具窗口中，展开项目目录和 .idea 目录节点，然后定位 dataSources.xml 文件。

  2. 右键点击 dataSources.xml 文件并选择 在以下位置打开 | <文件浏览器>。

定位 dataSources.xml 文件

您还可以使用 IDE 设置的导出和导入功能，通过 settings.zip 文件导出和导入数据源设置文件。 settings.zip 文件仅包含在全局级可用的数据源。 有关更改级别的更多信息，请参阅 将项目级别更改为全局。

将全局数据源设置导出到 ZIP 存档

  1. 从主菜单中选择 文件(F) | 管理IDE 设置 | 导出设置。

  2. 在 导出设置(E)… 窗口中，点击 不选(N)。

  3. 在 导出设置(E)… 窗口中，选择 数据库: 全局数据源。

  4. 在 导出设置 字段中，指定要存储 settings.zip 文件的目录路径。

alt_export_sata_sources_settings_zip

从 ZIP 存档导入全局数据源设置

  1. 从主菜单中选择 文件(F) | 管理IDE 设置 | 导入设置…。

  2. 在文件浏览器窗口中，定位您导出的 settings.zip 文件，并将其选中。

  3. 在 选择要导入的组件 窗口中，选择 数据库：全局数据源。

  4. 点击 确定。

  5. 在 需要重启 窗口中，点击 确定 以重启您的 IDE。

  6. 打开 数据源和驱动程序 对话框（Shift+Enter ），在数据源属性中输入必要的连接凭据。 如果数据源位于本地或网络驱动器上，请确保该数据源的路径正确。

  7. 为确保成功连接到数据源，请点击 测试连接。

alt_import_sata_sources_settings_zip

提示与技巧

连同密码共享所有连接

  1. 按 Ctrl+Alt+S 打开设置，并导航到 外观与行为 | 系统设置 | 密码。

  2. 选择 在KeePass 中 选项。

  3. 在 数据库 字段中，指定项目存储目录中 KDBX 文件的路径。

  4. 将包含您项目的整个目录复制到另一台计算机。

  5. 在另一台计算机上，按 Ctrl+Alt+S 打开设置，并导航到 外观与行为 | 系统设置 | 密码。

  6. 在 数据库 字段中，输入复制的 KDBX 文件的路径。

  7. 点击 文件(F) | 打开(O)… 并导航到包含已复制项目文件的目录。

最后修改日期： 2025年 12月 2日
连接到数据库Amazon Redshift