DuckDB-Wasm

DuckDB 是一個進程內 SQL OLAP 資料庫管理系統。

借助 WebAssembly，DuckDB-Wasm 將 DuckDB 引入每個瀏覽器。

Duckdb-Wasm 能流利地使用 Arrow，並讀取由文件系統 API 或 HTTP 請求支援的 Parquet、CSV 和 JSON 文件，並已在 Chrome、Firefox、Safari 和 Node.js 上進行了測試。從我們的 VLDB 出版物或錄製的演講中了解有關 DuckDB-Wasm 的更多資訊。

在 shell.duckdb.org 或 DuckDB-Wasm 的外部第三方嵌入中嘗試一下，閱讀 API 文檔，查看網頁應用程式範例，並在 Discord 上與我們聊天。

DuckDB 和 DuckDB-Wasm

DuckDB-Wasm 目前基於 DuckDB v1.1.1。

相關差異：

DuckDB 的本機版本和 Wasm 版本之間的 HTTP 堆疊有所不同。最相關的是：
- 請求始終升級為 HTTPS
- 請求需要伺服器允許對給定資源的跨來源訪問
- 檔案系統實作（例如 S3）不同，這可能會導致一些差異
擴充安裝是惰性的，這意味著INSTALL extension_name FROM 'https://repository.endpoint.org';延遲取得第一個LOAD extension_name;操作說明。 INSTALL x FROM community;也支援簡寫。
DuckDB-Wasm 建置針對下載速度進行了最佳化。像自動完成、JSON、Parquet 和 ICU 這樣的核心擴充通常是捆綁的 DuckDB 二進位文件，而在 duckdb-wasm 中它們是在運行時自動加載（包括獲取它們）。特別是對於 ICU 自動加載並非在所有情況下都能正常工作，顯式LOAD icu;可能需要重現相同的行為。
DuckDB-Wasm 是沙盒的，對核外操作和檔案系統存取可能沒有相同級別的支持
DuckDB-Wasm 預設模式是單執行緒。多執行緒目前仍處於實驗階段。

支援的 DuckDB 功能：

DuckDB 資料庫檔案相容從 DuckDB-Wasm 讀取。
資料庫檔案的取得方式非常簡單： ATTACH 'https://blobs.duckdb.org/data/test.db'; FROM db.t;示範
透過LOAD spatial空間演示提供空間支持
DuckDB-Wasm 支援越來越多的擴展子集，無論是核心擴展、社區擴展還是外部擴展
多執行緒可以工作，但仍處於實驗階段，預設未啟用

DuckDB-Wasm 和 DuckDB 擴展

DuckDB 是可擴展的，這允許將功能委託給擴充功能。

核心擴充可在 https://extensions.duckdb.org 上獲取，社群擴充功能可在 https://community-extensions.duckdb.org 上取得。

 -- - Excplicitly load extensions
LOAD icu;

-- - Or have them autoloaded when using relevant functions or settings
DESCRIBE FROM read_parquet( ' https://blobs.duckdb.org/stations.parquet ' );  -- (this autoloads JSON)

-- - Or register extensions
INSTALL h3 FROM community;
INSTALL sqlite_scanner FROM ' https://extensions.duckdb.org ' ;
INSTALL quack FROM ' https://community-extensions.duckdb.org ' ;

-- - And then load them
LOAD h3;
LOAD sqlite_scanner;
LOAD quack;

 FROM duckdb_extensions() WHERE loaded;

將顯示 h3、icu、parquet、quack 和 sqlite_scanner 已載入。

您可以嘗試載入擴充功能的 Shell 演示，但這確實需要透過網路傳輸大約 3.2 MB 的壓縮 Wasm 檔案（首次存取時，快取可能會有所幫助）。

擴展大小將根據所提供的功能或使用的工具鏈等因素而變化。

從原始碼構建

git clone https://github.com/duckdb/duckdb-wasm.git
cd duckdb-wasm
git submodule init
git submodule update
make apply_patches
make serve

儲存庫結構

子專案	描述	語言
鴨子資料庫wasm	瓦斯姆圖書館	C++
@duckdb/duckdb-wasm	打字稿API	打字稿
@duckdb/duckdb-wasm-shell	SQL外殼	鏽
@duckdb/duckdb-wasm-app	GitHub 頁面	打字稿
@duckdb/react-duckdb	反應鉤子	打字稿