本文已收錄在Github，關注我，緊跟本系列專欄文章，咱們下篇再續！
- 🚀 魔都架構師 | 全網30W技術追隨者
- 🔧 大廠分佈式系統/數據中台實戰專家
- 🏆 主導交易系統百萬級流量調優 & 車聯網平台架構
- 🧠 AIGC應用開發先行者 | 區塊鏈落地實踐者
- 🌍 以技術驅動創新，我們的征途是改變世界！
- 👉 實戰乾貨：編程嚴選網
0 前言
從 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 忽略。
5 接下來
在 2025.3 版本週期的後續更新中，將為數據庫資源管理器添加一個新的 Query Files 節點。點擊後可直接查看與當前數據源關聯的所有查詢文件，進一步提升可發現性。
