WebStorm 2025.2 Help

数据源

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

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

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

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

“数据库”工具窗口中的数据源

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

在 WebStorm 中,您可以创建以下数据源:

  • 数据库数据源 :包含实际数据库连接配置的数据源。

    对于不同的数据库,WebStorm 提供了完全支持和基础支持。 数据库的完全支持包括增强的代码补全与更优的数据对象检索(内省)等功能。 还可使用所有检查、快速修复及其他编码辅助功能,而基础支持仅提供有限功能。

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

  • 数据定义语言(DDL)数据源 :包含数据定义语言语句的 SQL 文件(请参阅 DDL 数据源)。

创建数据源

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

支持的数据库

WebStorm 可连接运行于本地或远程的数据库,无论其位于主机服务器还是云平台上。

要创建数据源并运行与数据库的测试连接,请按照专用主题中提供的说明操作。

完整支持

IDE 完全支持以下数据库:

基本支持

下列数据库提供 基础支持

  • AWS Athena

  • Apache Ignite

  • Apache Spark

  • Databricks

  • Denodo

  • DuckDB

  • Elasticsearch

  • Firebird

  • Google Cloud Spanner

  • Informix

  • InterSystems IRIS

  • Mimer SQL

  • OpenEdge

  • Phoenix

  • Presto

  • SAP HANA

  • SingleStore

  • Tarantool

  • Teradata

  • TiDB

  • Tibero

  • Trino

  • YugabyteDB

DDL 数据源

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

云数据库

WebStorm 还支持以下云数据库:

复制数据源

复制数据源时将保留所有连接设置,包括密码。 数据源只能在同一个项目中复制。

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

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

      在“数据库”工具窗口中复制数据源
    • 数据源和驱动程序 对话框(Shift+Enter )左侧区域,选择要复制的数据源,然后点击工具栏上的 “复制”图标复制副本

      在“数据源和驱动程序”对话框中复制数据源

    或者,选中数据源后按 Ctrl+D

    WebStorm 将创建一个具有相同设置(包括密码)的新数据源。

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

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

删除数据源

您可以通过以下任一方式删除数据源:

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

  • 要在 数据源和驱动程序 对话框中删除数据源,请按照以下步骤操作:

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

      • 数据库 工具窗口的工具栏中,点击 “数据源”图标数据源

      • 按下 Shift+Enter

      打开“数据源和驱动程序”对话框
    2. 在对话框左侧窗格中,选择要删除的数据源,并点击工具栏中的 移除

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

配置数据源显示选项

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

自定义 数据库 工具窗口中对象的视图

  • 若要对数据源进行分组、启用或排序,请点击 “查看选项”图标查看选项 ,位于 数据库 工具窗口的工具栏中,并选择所需选项。

    数据库 工具窗口中,数据库对象树的视图会立即发生变化。

    有关数据库树视图选项的更多信息,请参阅 视图选项

    “数据库”工具窗口中的“查看选项”菜单项

将数据源分组到文件夹中

  • 数据库 工具窗口中,选择所需的数据源并按下 F6。 或者,右键点击某个数据源并选择 移至文件夹

    1. 如果尚未创建任何文件夹,将会看到 新建文件夹 对话框。 在文本字段中输入文件夹名称。 您可以使用正斜杠(/ )来定义嵌套结构。 例如,名称 QA/Quick 将会在 QA 文件夹中创建一个 Quick 文件夹。

      创建用于分组数据源的新文件夹
    2. 如果已存在包含分组数据源的文件夹,则会看到 移至文件夹 对话框。 要创建新文件夹,请选择 新建文件夹。 要将数据源从文件夹中移除,请选择 根文件夹

      将数据源移动到文件夹

    此外,您可以使用 Ctrl+CCtrl+VCtrl+X 在文件夹之间复制、粘贴和剪切数据源。 如果在同一个项目中剪切并粘贴数据源,则数据源将被移动。 无需密码。 但在所有其他情况中需要密码。 剪切操作可通过使用 Ctrl+Z 来撤销。

为数据源分配颜色

为了更好地区分生产环境和测试环境的数据库,您可以为数据源分配颜色。

您可以通过数据源设置对话框或上下文菜单进行操作。

  • 设置对话框

    1. 数据源和驱动程序 对话框(Shift+Enter )中,选择要分配颜色的数据源。

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

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

    为数据源分配颜色
  • 上下文菜单

    1. 数据库 工具窗口中,右键点击数据源并导航至 工具 | 设置颜色

    2. 颜色 中,选择要分配的颜色。

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

    正在为数据源分配颜色

为查询控制台和网格分配颜色

代码编辑器和数据编辑器的选项卡可以采用数据源的颜色。

  1. 要将数据源颜色应用于 查询控制台 和数据网格,请右键点击某个数据源并选择 工具 | 设置颜色

  2. 数据库颜色设置 对话框中,选中 在控制台编辑器和网格中 复选框。

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

有关该对话框及选项的更多信息,请参阅 数据库颜色设置对话框

正在为数据源分配颜色

有关该对话框中外观设置的更多信息,请参阅 数据库颜色设置对话框

从工具栏筛选对象

  • 若要选择所需对象,请点击 “查看选项”图标查看选项 ,位于 数据库 工具窗口的工具栏中,然后选择 “筛选器”图标筛选。 在数据库对象列表中选择或取消选择项目以切换对象的可见性。

显示数据源和数据库对象的注释

  • 要启用数据库和表的注释功能,请点击 “查看选项”图标查看选项 ,位于 数据库 工具窗口的工具栏中,并选择 注释

    要为表添加注释,请选择一个表并按下 Ctrl+F6。 在 Comment 文本字段中,添加表描述。

    要为数据库添加注释,请打开数据库设置 Ctrl+Alt+S 并在 Comment 文本字段中添加数据库描述。

    显示数据库和表的注释

使用数据源的全名

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

  • 右键点击 查询控制台 的某个选项卡并选择 缩短标签页标题

在 数据库 工具窗口中查看节点内容

  • 数据库 工具窗口中,点击聚合数据库对象的节点,并按下 F4

    查看节点内容

共享数据源

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

在项目之间共享数据源

在 WebStorm 中,数据源可设置为项目级或全局级。 项目级意味着只能从最初创建该数据源的项目中访问。 在全局级,数据源可供其他项目使用。 默认情况下,数据源设置为项目级。

若要在 IDE 中的不同项目之间共享数据源,需将数据源移动到全局级。

  1. 数据库 工具窗口中,点击工具栏上的 数据源属性按钮数据源属性

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

    或者,点击工具栏上的 “设为全局”图标设为全局

    在“数据源和驱动程序”对话框中将数据源设为全局
  3. 点击 确定 以保存更改并关闭对话框。

若要将数据源恢复为本地级别,请点击取代数据源上 “设为全局”图标设为全局“移动到项目”图标移动到项目

在“数据源和驱动程序”对话框中,全局数据源和项目级别数据源

在 IDE 实例间共享数据源

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

这是因为 WebStorm 没有自己的密码存储机制。 它会使用本机密码管理系统或 KeePass。 若要更改 IDE 保存密码的方式,请在 IDE 设置 Ctrl+Alt+S 中,导航至 外观与行为 | 系统设置 | 密码。 有关在 WebStorm 中存储密码的更多信息,请参阅 密码 主题。

将数据源复制到剪贴板

在 WebStorm 中,您可以将数据源复制到剪贴板。 这样操作时,IDE 会将连接设置复制为 XML 片段。 您可以将该片段粘贴到另一个 IDE 中,在那里创建该数据源的副本。

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

  2. 右键点击所选数据源并导航至 复制/粘贴 | 复制数据源 ,即可将其复制到剪贴板。 或者,按 Ctrl+C

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

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

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

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

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

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

每个 WebStorm 项目中都有一个 dataSources.xml 文件,用于存储该项目中所有数据源的设置。 您可以通过复制此文件,将数据源共享到另一个 IDE 实例。 此外,您也可以将文件置于 VCS 下,以跟踪变更并同步多位用户间的数据源列表。

dataSources.xml 文件存储在 .idea 子目录下,该目录位于 IDE 项目目录 中的专用项目设置目录中。

定位 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年 9月 26日