
从2025.3版本开始DataGrip 以及其他带有数据库支持的 JetBrains IDE 将不再使用「查询控制台query console」这个名称。从现在起将改用「查询文件query file」因为控制台本质上一直就是文件现在终于让 UI 与事实保持一致。还优化了整个工作流程让操作更简单、更直观也更统一。1 历史回顾为啥当初有「控制台」概念JetBrains 第一次在 IntelliJ IDEA 中加入数据库功能时大多 Java 开发者都是通过终端操作数据库。为了尽快在 IDE 中复现这种工作方式JetBrains 为用户提供了一个可以临时编写 SQL 的区域——这个临时 SQL 文件就被称为控制台console。多年来IDE 每个项目只提供一个默认控制台似乎也够用。但随时间推移用户提出更多需求如希望能创建多个控制台、能选择数据库或 schema以及希望能通过 UI 更方便切换上下文。2 存在的问题控制台本质就是脚本文件与其他数据库工具提供的脚本文件类似但有一些让人困惑的地方不属于项目结构。控制台文件存在于项目结构之外虽然用户其实是在项目中工作。不容易找到。它们被保存在一个隐蔽的文件夹中和临时文件 scratch files在一起这让很多人创建了控制台却找不到保存位置。由于 DataGrip 会自动保存控制台文件内容不会丢失但这也让定位变得更困难。因为不会弹出「保存」提示用户经常一头雾水找不到自己创建的控制台也无法轻松切换上下文上下文切换麻烦。无法通过 UI 修改控制台的 SQL 方言、数据源或 schema。如果想让它像普通文件一样工作就得手动保存或迁移名称让人误解。「查询控制台」这个词并不能准确表达它的功能新用户经常因此感到困惑总的来说控制台的理念不错但在实际使用中却不够方便——是时候做出改变了。3 变更内容经过反复思考最终做最自然选择把控制台与文件合并。现在查询操作完全基于文件形式查询文件query files会显示在项目中更容易找到也更方便管理。具体变化如下想对数据库执行查询时可像以前一样从数据源或其对象的右键菜单创建查询文件。新文件会命名为Query_[N].sql命名规则可在「设置」中自定义。默认情况下查询文件保存在项目文件夹下的queries文件夹。该文件夹可在「文件Files」工具窗口中查看。也可在「设置」中更改保存路径选择的自定义文件夹也会在工具窗口中显示。现在绑定了数据库上下文的文件会显示一个类似数据源的图标而不再是之前的通用数据库图标更易区分查询文件。以前控制台的限制全部取消现可重新绑定查询文件、修改 SQL 方言或数据源并像操作普通项目文件一样使用它。数据库资源管理器工具栏上的「跳转到查询控制台Jump to Query Console」按钮已更名为「跳转到查询文件Jump to Query File」并换上了新图标。它现在会列出与当前数据源相关的所有查询文件。升级到新版 DataGrip 时会出现迁移对话框帮助你将所有旧控制台迁移为查询文件并引导你适应新的工作流程。在临时文件与控制台Scratches and Consoles下的旧Database Consoles文件夹会暂时保留一个版本周期之后将被彻底移除。4 FAQ现有控制台会丢失吗不会。会将它们安全地转换为.sql文件并保存在原位置以确保安全。还能保持原来的行为吗技术上可以但仅限于旧项目并且只在下一个版本周期内有效。每次重启 IDE 时仍会出现迁移提示框不过你可以选择「不再显示」。对于新项目只会启用新逻辑。全局数据源global data sources的控制台会怎样在迁移对话框中你可为这类数据源指定单独的迁移文件夹。这个文件夹会保存到设置中并作为今后全局数据源查询文件的默认位置。要在 IDE 中访问这些文件需要将该文件夹手动挂载到具体项目中。其他 JetBrains IDE 也会这样吗会但目前仅在 DataGrip EAP 中发布。其他带数据库功能的 JetBrains IDE 会自动将查询文件迁移到项目下.idea子文件夹中这个文件夹通常会被.gitignore忽略。