DuckDB-Wasm

DuckDB adalah Sistem Manajemen Basis Data SQL OLAP yang sedang dalam proses.

DuckDB-Wasm menghadirkan DuckDB ke setiap browser berkat WebAssembly.

Duckdb-Wasm berbicara Arrow dengan lancar, membaca file Parket, CSV, dan JSON yang didukung oleh API Sistem File atau permintaan HTTP dan telah diuji dengan Chrome, Firefox, Safari, dan Node.js. Pelajari lebih lanjut tentang DuckDB-Wasm dari publikasi VLDB kami atau rekaman pembicaraan.

Cobalah di shell.duckdb.org atau penyematan DuckDB-Wasm pihak ketiga eksternal, baca dokumentasi API, lihat contoh aplikasi web, dan mengobrol dengan kami di Discord.

DuckDB dan DuckDB-Wasm

DuckDB-Wasm saat ini didasarkan pada DuckDB v1.1.1.

Perbedaan yang relevan:

Tumpukan HTTP berbeda antara DuckDB versi asli dan Wasm. Yang paling relevan adalah:
- Permintaan selalu ditingkatkan ke HTTPS
- Permintaan memerlukan server untuk mengizinkan akses Cross Origin pada sumber daya tertentu
- Implementasi sistem file (mis. S3) berbeda dan ini mungkin menyebabkan beberapa perbedaan
Pemasangan ekstensi lambat, artinya INSTALL extension_name FROM 'https://repository.endpoint.org'; tunda pengambilan ekstensi ke LOAD extension_name; petunjuk. INSTALL x FROM community; tulisan singkat juga didukung.
Build DuckDB-Wasm dioptimalkan untuk kecepatan pengunduhan. Ekstensi inti seperti pelengkapan otomatis, JSON, Parket, dan ICU biasanya merupakan paket binari DuckDB, sedangkan di duckdb-wasm, ekstensi tersebut dimuat secara otomatis (termasuk mengambilnya) saat runtime. Khususnya untuk pemuatan otomatis ICU tidak berfungsi dengan benar di semua kasus, eksplisit LOAD icu; mungkin diperlukan untuk mereproduksi perilaku yang sama.
DuckDB-Wasm di-sandbox dan mungkin tidak memiliki tingkat dukungan yang sama untuk operasi di luar inti dan akses ke sistem file
Mode default DuckDB-Wasm adalah utas tunggal. Multithreading saat ini masih bersifat eksperimental.

Fitur DuckDB yang didukung:

File database DuckDB kompatibel untuk dibaca dari DuckDB-Wasm.
File database dapat disediakan sesederhana: ATTACH 'https://blobs.duckdb.org/data/test.db'; FROM db.t; demo
Dukungan spasial melalui demo LOAD spatial
Semakin banyak ekstensi, baik inti, komunitas, atau eksternal, yang didukung untuk DuckDB-Wasm
Multithreading berfungsi tetapi masih eksperimental dan secara default tidak diaktifkan

Ekstensi DuckDB-Wasm dan DuckDB

DuckDB dapat diperluas dan memungkinkan untuk mendelegasikan fungsionalitas ke ekstensi.

Ekstensi inti tersedia di https://extensions.duckdb.org, dan ekstensi komunitas tersedia di 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;

Akan menunjukkan bahwa h3, icu, parket, quack dan sqlite_scanner telah dimuat.

Anda dapat mencoba demo Shell dengan memuat ekstensi tetapi ini memerlukan sekitar 3,2 MB file Wasm terkompresi untuk ditransfer melalui jaringan (pada kunjungan pertama, caching mungkin membantu).

Ukuran ekstensi akan bervariasi, antara lain bergantung pada fungsionalitas yang disediakan atau rangkaian alat yang digunakan.

Bangun dari sumber

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

Struktur Repositori

Subproyek	Keterangan	Bahasa
bebekdb_wasm	Perpustakaan Wasma	C++
@duckdb/duckdb-wasm	API skrip ketikan	naskah ketikan
@duckdb/duckdb-wasm-shell	cangkang SQL	Karat
@duckdb/duckdb-wasm-app	Halaman GitHub	naskah ketikan
@duckdb/reaksi-duckdb	Kait Reaksi	naskah ketikan