6. 查詢結果
6.1 結果表格:排序、欄位顯示/隱藏、欄寬調整
查詢完成後,結果會以表格形式呈現在編輯器下方。你可以:
- 排序: 點擊任一欄位標題,即可對該欄位進行升序 / 降序排列。排序在前端執行,僅影響目前顯示的資料。
- 隱藏 / 顯示欄位: 點擊工具列的 Columns 按鈕,勾選或取消勾選要顯示的欄位。
- 調整欄寬: 拖曳欄位標題之間的分隔線,調整欄位寬度。
- 快速複製: 工具列在 Columns 左側提供 Copy for Excel/Spreadsheet(見 §6.5)。完整檔案匯出仍用 Export(§9)。
結果區使用與應用程式一致的捲軸樣式,長結果捲動時視覺與其他面板統一。
6.2 分頁瀏覽
結果面板底部提供翻頁控制:
- 使用 第一頁 / 上一頁 / 下一頁 / 最後一頁 按鈕切換頁面。
- 從下拉選單選擇每頁顯示筆數:20 / 40 / 60 / 80 / 100。
- 底部會顯示目前顯示的筆數範圍(例如「顯示第 1–20 筆」)。
6.3 執行時間與筆數統計
工具列會顯示:
- 總筆數: 查詢結果的總行數。
- 執行時間: 查詢花費的時間。
注意: 畫面預覽最多顯示 500 筆資料。如果查詢結果超過 500 筆,你仍然可以透過匯出功能取得完整資料。
6.4 查詢錯誤顯示
當 SQL 查詢執行失敗時,錯誤訊息會直接顯示在結果面板中,取代原有的結果表格:
- 錯誤區塊以紅色邊框與淡紅色背景呈現,搭配警示圖標(⚠),錯誤訊息以等寬字體顯示完整報錯內容。
- 錯誤狀態下,工具列的 Badge 會顯示 「Query Error」,Copy for Excel/Spreadsheet、Columns 與 Export 按鈕會被停用。
- 分頁控制在錯誤狀態下會自動隱藏。
錯誤自動清除: 當你重新執行查詢時,結果面板會立即從錯誤態切換為「執行中」狀態(顯示旋轉動畫與 "Query executing..." 文字)。若新查詢成功,面板恢復為正常結果表格;若再次失敗,則顯示新的錯誤訊息。若你改以工具列中止結束查詢,畫面不會進入上述「Query Error」錯誤態。
Tab 獨立性: 每個分頁的錯誤狀態是獨立的。Tab A 報錯後切換到 Tab B(正常狀態),再切回 Tab A 時,錯誤訊息仍會保留顯示。
提示: 查詢錯誤資訊會同時傳送給 AI 助手(詳見 12.6 節),AI 可以直接看到你的報錯內容與觸發的 SQL 語句,無需你手動複製貼上,即可協助你修正查詢。
6.5 快速複製到試算表(Copy for Excel/Spreadsheet)
結果面板工具列(Columns 左側)提供一鍵複製,方便把目前畫面上的結果貼進 Excel、Google Sheets 等試算表,而不必先匯出檔案。
| 項目 | 行為 |
|---|---|
| Tooltip | Copy for Excel/Spreadsheet |
| 複製範圍 | 前端目前可見資料(套用欄位隱藏與排序),最多 500 列;不受當前分頁大小限制 |
| 格式 | 含標題列的 TSV(Tab 分隔)+ UTF-8 BOM,貼上即可分欄 |
| 成功反饋 | 圖示短暫變為勾選(約 0.5 秒)後恢復;成功時不彈 Toast |
| 停用 | 查詢執行中、查詢錯誤、或無結果列時 |
完整結果或需檔案落地時,請改用工具列 Export(§9)。Report 表格另有 Copy for Excel(§11.5.2),與本節 Result Panel 按鈕是不同入口。
[圖片] 結果面板:表格、排序指示、欄位控制按鈕、翻頁控制與統計資訊