#DQL
標記為 #DQL · 9 篇文章
- DQL 明明沒寫錯，卻一筆都查不到？因為那個 form 少了 dql mode
上一篇是用 unid 拿單一份文件。真正常見的是「符合條件的一批」——所有未完成的 todo、某區的所有客戶。DRAPI 給兩條路：GET /lists/{view} 讀一個 view/folder，或 POST /query 跑 DQL。DQL 還支援參數化查詢（?VAR + variables，防注入）。但有個接續上一篇的坑：一個 form 若沒有 dql mode，DQL 就完全看不到它。這篇把兩條查詢路徑、分頁、mode 陷阱與 DQL 存取控制講清楚。DRAPI 系列第五篇。
2026.08.23 - 在 Java 裡跑 DQL：DominoQuery 與 QueryResultsProcessor
站上的 DQL 三部曲教你寫查詢，但那是從 LotusScript 或 console 跑的。搬到 Java，DQL 走兩個類別：DominoQuery 負責編譯、調校、執行，QueryResultsProcessor 負責排序、彙總、跨庫 join、輸出 JSON。還有一個容易錯的地方——這兩個都從 Database 取得，不是 Session。這篇拆解 Java 端怎麼把 DQL 跑起來。
2026.08.09 - DQL 跳「Domino Query 執行時錯誤」怎麼辦：三層診斷階梯
一個 DQL 查詢失敗，你看到「Domino Query 執行時錯誤:」後面接一大串文字。一篇讀懂這個訊息的實測報告：你在 Err 裡找到的 4854 對診斷毫無用處（每個 DQL 失敗都回它），答案永遠在「詳細原因」那一行。涵蓋四段訊息結構、三層階梯（catalog / view 沒建 / partial TIMEDATE）、讓查詢時好時壞的 design catalog 半殘、以及「0 筆且無錯誤」的排查清單。
2026.07.21 - DQL view 日期直欄查詢：型別與時區怎麼無聲吃掉你的結果（三個成因）
「直欄轉成日期反而有些抓得到有些沒抓到，蠻怪的。」一篇實測報告：一個 DQL view 直欄日期查詢結果不一致，拆開來發現有三個獨立成因。DQL 從不自動轉型（所以直欄的輸出型別要跟查詢詞相符）、底層欄位存了文字與日期混型、而 @dt 不帶時區位移就是 UTC——它會在不改變總筆數的情況下弄壞邊界文件。兩個解法皆實測 6/6 全中。
2026.07.20 - FTSearch / db.Search / DQL：Domino 三種搜尋機制怎麼選
Domino 14 之後、文件搜尋有三條技術路徑：FTSearch（文字索引）、db.Search（@Formula 全表掃描）、DQL（V12 引入、結構化 query、走 design catalog 跟 NIF 索引）。本文用一張多維對比表 + 一棵決策樹整理三者的差異 — index 需求、語法、效能、即時性、回傳順序、可組合性 — 並深入講 Domino 14 開始 DQL 支援 `@FTSearch()` term 把全文檢索整合進結構化 query 的意義。三個實戰場景（一次性查詢 / scheduled agent / 高頻 REST API）對應建議路徑、附 cross-link 整個搜尋系列跟 DQL 三部曲。
2026.05.29 - DQL Production-Ready：Catalog 維運、權限、與 sessionAsSigner
把 DQL 上 production 真正會撞牆的兩個問題：Design Catalog 怎麼自動維護（包含全新 NSF 的 bootstrap、設計變更後的 incremental refresh），以及為什麼一般使用者跑會噴「您沒有權限執行此作業」——以及對應的 sessionAsSigner / scheduled agent 解法。本文整理實測 Domino 12 驗證過的最終 pattern + Java production-ready 範例。
2026.05.03 - DQL 踩雷集：寫 query 時 6 個官方文件不會明說的細節
Domino Query Language（DQL）的語法表面像 SQL，但實戰起來有一整套 Notes 特有的踩雷點 —— view selection 會默默限縮結果範圍、`'view'.column` 的 column 不是文件欄位名而是直欄程式名稱、比較運算子兩邊要空白、view 名稱含反斜線要 escape、`@formula` 內是獨立的 Formula Language parser、字串日期欄位要 `@TextToTime`。本篇用實測錯誤訊息對照逐個說明。
2026.05.01 - NotesQueryResultsProcessor 入門：DQL 之後的下一步
NQRP 是 Domino V12 引入的 LotusScript 類別，讓你把 DQL（或任何 NotesDocumentCollection）的結果重新排序、分類、加欄位、輸出成 JSON 或暫存 view。本文整理建立流程、所有方法簽名、官方範例與安全用法。
2026.04.28 - DQL 入門：用 SQL 風格的語法操作 Notes 文件
Domino Query Language（DQL）讓你用近 SQL 的語法直接查詢 Notes 文件，免再為每種查詢條件設計 view。本文是「DQL 三部曲」系列的 Part 1：介紹 DQL 的設計初衷、第一個 query 怎麼寫、從 LotusScript / Java / REST API 怎麼呼叫，以及常用語法速查。寫 query 結果不如預期的細節在 Part 2，上 production 的 catalog 維運與權限在 Part 3。
2026.04.28