官方網站
Git 儲存庫產品說明
Harlequin 是一款專為終端機（Terminal）開發的 SQL 集成開發環境（IDE），被社群譽為「終端機界的 DBeaver」。它基於 Python 的 Textual 框架構建，旨在讓開發者與資料分析師無需離開命令列介面，就能擁有如同 GUI 軟體般的資料庫開發體驗。
不同於傳統 sqlite3 或 psql 僅能顯示純文字結果，Harlequin 提供了一個完整的 TUI（文字使用者介面），包含左側的資料目錄（Data Catalog）、上方的 SQL 編輯器以及下方的互動式結果檢視器。它支援多標籤頁操作，甚至能處理超過一百萬列的查詢結果而不當機。對於經常需要透過 SSH 遠端管理資料庫的系統管理員來說，這是一款極致高效的生產力神器。
核心特色：
- 完整 IDE 體驗：內建語法高亮、SQL 自動補全、程式碼格式化以及多標籤頁編輯器。
- 強大適配器系統：原生支援 DuckDB 與 SQLite，並可透過外掛支援 PostgreSQL, MySQL, BigQuery, Snowflake, ClickHouse 等多種主流資料庫。
- 高效資料瀏覽：支援滑鼠點擊、捲動與選取單元格，並能快速將查詢結果匯出為 CSV, JSON 或 Parquet 格式。
- 低資源佔用：可於任何支援 Python 的終端機執行，無論是 Linux 伺服器、macOS 還是 Windows CMD。
常用指令
Harlequin 的啟動非常靈活，你可以根據要連接的資料庫類型選擇不同的適配器（Adapters）。
啟動與連線
# 開啟當前目錄下的 SQLite 資料庫
harlequin -a sqlite my_database.db
# 連接 DuckDB 並載入 local 或 S3 的檔案
harlequin data.duckdb
# 連接 PostgreSQL (需先安裝 harlequin-postgres 擴充)
harlequin -a postgres -h localhost -U user -p 5432 -d my_db
| 指令參數 | 功能說明 | 範例 |
|---|---|---|
| -a, –adapter | 指定資料庫適配器 (預設為 duckdb) | harlequin -a sqlite |
| -t, –theme | 更改介面主題 (支援數十種配色) | harlequin --theme dracula |
| -f, –show-files | 在目錄中顯示本地檔案系統標籤頁 | harlequin -f . |
| –gen-config | 產生預設的 .harlequin.toml 設定檔 | harlequin --gen-config |
| –limit | 限制結果顯示的最大筆數 | harlequin --limit 1000 |
快速鍵 (TUI 模式)
- Ctrl + Enter：執行當前編輯器中的 SQL 指令。
- Ctrl + J：在資料目錄中將選中的資料表/欄位名稱插入編輯器。
- F10：切換編輯器或結果區域的全螢幕顯示。
- Ctrl + S：儲存當前的 SQL 腳本。
- Ctrl + Q：退出 Harlequin。
操作介面
