DuckDB-Wasm

DuckDB ist ein In-Process-SQL-OLAP-Datenbankverwaltungssystem.

DuckDB-Wasm bringt DuckDB dank WebAssembly in jeden Browser.

Duckdb-Wasm spricht fließend Arrow, liest Parquet-, CSV- und JSON-Dateien, die durch Dateisystem-APIs oder HTTP-Anfragen unterstützt werden, und wurde mit Chrome, Firefox, Safari und Node.js getestet. Erfahren Sie mehr über DuckDB-Wasm in unserer VLDB-Publikation oder im aufgezeichneten Vortrag.

Probieren Sie es unter shell.duckdb.org oder die externe Einbettung von DuckDB-Wasm durch Dritte aus, lesen Sie die API-Dokumentation, schauen Sie sich die Web-App-Beispiele an und chatten Sie mit uns auf Discord.

DuckDB und DuckDB-Wasm

DuckDB-Wasm basiert derzeit auf DuckDB v1.1.1.

Relevante Unterschiede:

Der HTTP-Stack unterscheidet sich zwischen nativen und Wasm-Versionen von DuckDB. Am relevantesten sind:
- Anfragen werden immer auf HTTPS aktualisiert
- Für Anfragen ist ein Server erforderlich, der Cross-Origin-Zugriff auf eine bestimmte Ressource ermöglicht
- Die Implementierung des Dateisystems (z. B. S3) ist unterschiedlich und dies kann zu einigen Unterschieden führen
Die Installation der Erweiterung ist verzögert, was bedeutet, dass INSTALL extension_name FROM 'https://repository.endpoint.org'; Verschieben Sie das Abrufen der Erweiterung auf den ersten LOAD extension_name; Anweisung. INSTALL x FROM community; Kurzschriften werden ebenfalls unterstützt.
DuckDB-Wasm-Builds sind für die Download-Geschwindigkeit optimiert. Kernerweiterungen wie Autocomplete, JSON, Parquet und ICU sind normalerweise gebündelte DuckDB-Binärdateien, während sie in duckdb-wasm zur Laufzeit automatisch geladen (einschließlich des Abrufs) werden. Insbesondere funktioniert das automatische Laden auf der Intensivstation nicht in allen Fällen korrekt, explizites LOAD icu; Möglicherweise ist es erforderlich, das gleiche Verhalten zu reproduzieren.
DuckDB-Wasm ist eine Sandbox und bietet möglicherweise nicht das gleiche Maß an Unterstützung für Vorgänge außerhalb des Kerns und Zugriff auf das Dateisystem
Der Standardmodus von DuckDB-Wasm ist Single-Threaded. Multithreading ist derzeit noch experimentell.

Unterstützte DuckDB-Funktionen:

DuckDB-Datenbankdateien können von DuckDB-Wasm gelesen werden.
Datenbankdateien können so einfach zur Verfügung gestellt werden: ATTACH 'https://blobs.duckdb.org/data/test.db'; FROM db.t; Demo
Räumliche Unterstützung über LOAD spatial räumliche Demo
Für DuckDB-Wasm wird eine wachsende Untergruppe von Erweiterungen unterstützt, entweder Kern-, Community- oder externe Erweiterungen
Multithreading funktioniert, ist aber noch experimentell und standardmäßig nicht aktiviert

DuckDB-Wasm und DuckDB-Erweiterung

DuckDB ist erweiterbar und ermöglicht die Delegierung von Funktionen an Erweiterungen.

Kernerweiterungen sind unter https://extensions.duckdb.org und Community-Erweiterungen unter https://community-extensions.duckdb.org verfügbar.

 -- - 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;

Zeigt an, dass h3, icu, parquet, quack und sqlite_scanner geladen wurden.

Sie können die Shell-Demo mit dem Laden von Erweiterungen ausprobieren, aber dafür müssen etwa 3,2 MB komprimierter Wasm-Dateien über das Netzwerk übertragen werden (beim ersten Besuch könnte Caching hilfreich sein).

Die Größe der Erweiterungen variiert unter anderem je nach bereitgestellter Funktionalität oder verwendeter Toolchain.

Aus dem Quellcode erstellen

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

Repository-Struktur

Teilprojekt	Beschreibung	Sprache
duckdb_wasm	Wasm-Bibliothek	C++
@duckdb/duckdb-wasm	Typescript-API	Typoskript
@duckdb/duckdb-wasm-shell	SQL-Shell	Rost
@duckdb/duckdb-wasm-app	GitHub-Seite	Typoskript
@duckdb/react-duckdb	Reagieren Sie auf Hooks	Typoskript