跳至主要內容

DuckDB 用戶端

開啟 DuckDB 資料庫,或用 SQL 查詢 Parquet、CSV 和 JSON 檔案,無須執行資料庫伺服器。

概覽

查詢語言
SQL
驅動程式
首次使用時下載
連線方式
檔案
內建引擎
DuckDB 1.5.2
Mac 上的 TablePro 開啟了 DuckDB 資料庫,以 SQL 查詢 Parquet 檔案。

開啟檔案

開啟 .duckdb 或 .ddb 檔案(也可從 Finder 開啟),輸入新路徑建立檔案,或使用 :memory: 建立暫存資料庫。檔案依標頭辨識,而非副檔名。

Parquet、CSV、TSV、JSON 和 NDJSON 可透過 檔案 > 開啟檔案 (File > Open File) 開啟為唯讀檢視表,名稱為 file 及檔案名稱,原始檔案不會被修改。遠端(Quack,實驗性) (Remote (Quack, experimental)) 透過別名連線至 quack_serve 伺服器;首次連線會下載 DuckDB 的 quack 擴充功能。

查詢與編輯

直接查詢檔案,例如 SELECT * FROM 'data.csv'。ATTACH 會將另一個 DuckDB 檔案加入側邊欄,⌘K 可在檔案之間切換,直到下次重新連線為止。EXPLAIN 會繪製為計畫圖。

資料表中的列可以編輯,而資料檔案上的檢視表保持唯讀:要編輯其資料,請在 DuckDB 資料庫中建立資料表。沒有建立或刪除資料庫的操作;要建立檔案,請在連線時輸入新路徑。

共用檔案並備份

TablePro 持有檔案時,duckdb CLI、notebook 或 dbt 都無法開啟它。Release the File Lock After 會在閒置數分鐘後交還檔案,並在下次查詢時重新取得;Open the File Read-Only 讓多個讀取者共用檔案;資料庫 > Release File Lock (Database > Release File Lock) 會立即交還檔案。工作階段持有交易、暫存資料表、附加資料庫或已變更的設定時,釋放會被拒絕並說明原因。

Backup Dump 無須安裝任何工具,因為 DuckDB 會透過已開啟的連線寫入:可寫成日後還原用的 .duckdb 檔案,或寫成含 schema.sql、load.sql 及每個資料表一個 Parquet 檔案的資料夾,pandas、Spark 和 BigQuery 可直接讀取。

本頁介紹 DuckDB 專屬的功能。Safe Mode、AI 助理、MCP 伺服器和 TablePro 的其他功能請見功能頁面。

其他

  • 搬移資料

    匯入 CSV、TSV、JSON、JSONL、XLSX 與 SQL 檔案,並將資料表和結果匯出為 CSV、JSON、SQL、XLSX、Markdown、HTML 與 XML。從 Settings > Plugins 安裝的 Parquet 匯出外掛程式會新增 Parquet 輸出,每個資料表一個檔案。

  • iPhone 與 iPad

    iPhone 與 iPad App 可連線至 DuckDB。

    DuckDB 內建於 App 中。在「檔案」App 中選擇的檔案會在原位置開啟,而不是建立副本;In-Memory 提供暫用資料庫。您可以卡片形式瀏覽資料表,並在 Query 分頁執行 SQL。

    適用於 iPhone 與 iPad 的 TablePro

  • 限制

    • 連線開啟期間,一個 DuckDB 檔案同時只允許一個處理程序寫入。
    • 驅動程式包含核心功能、JSON、Parquet、ICU 和自動完成擴充功能。httpfs 等其他擴充功能會在查詢首次需要時從 DuckDB 下載。
    • 透過 Quack 的遠端連線為實驗性功能。
  • TablePro 使用哪個 DuckDB 版本?

    DuckDB 1.5.2,編譯在驅動程式中,不依賴您已安裝的任何 DuckDB。

  • CSV 檔案應該在 DuckDB 還是 Data Files 視窗中開啟?

    要瀏覽、清理檔案並儲存回去,請使用 Data Files 視窗。要用 SQL 將它與其他檔案或資料表聯結,請以 DuckDB 開啟;檔案在其中保持唯讀。

取得 TablePro

本頁功能全部免費。