DuckDB-Wasm

DuckDB est un système de gestion de base de données SQL OLAP en cours.

DuckDB-Wasm apporte DuckDB à tous les navigateurs grâce à WebAssembly.

Duckdb-Wasm parle couramment Arrow, lit les fichiers Parquet, CSV et JSON soutenus par les API du système de fichiers ou les requêtes HTTP et a été testé avec Chrome, Firefox, Safari et Node.js. Apprenez-en plus sur DuckDB-Wasm grâce à notre publication VLDB ou à la conférence enregistrée.

Essayez-le sur shell.duckdb.org ou sur l'intégration tierce externe de DuckDB-Wasm, lisez la documentation de l'API, consultez les exemples d'applications Web et discutez avec nous sur Discord.

DuckDB et DuckDB-Wasm

DuckDB-Wasm est actuellement basé sur DuckDB v1.1.1.

Différences pertinentes :

La pile HTTP est différente entre les versions natives et Wasm de DuckDB. Les plus pertinents sont :
- Les requêtes sont toujours mises à niveau vers HTTPS
- Les requêtes ont besoin d'un serveur pour autoriser l'accès Cross Origin sur une ressource donnée
- L'implémentation du système de fichiers (par exemple S3) est différente et cela peut entraîner des différences
L'installation de l'extension est paresseuse, ce qui signifie que INSTALL extension_name FROM 'https://repository.endpoint.org'; reporter la récupération de l'extension au premier LOAD extension_name; instruction. INSTALL x FROM community; les raccourcis sont également pris en charge.
Les versions DuckDB-Wasm sont optimisées pour la vitesse de téléchargement. Les extensions principales telles que la saisie semi-automatique, JSON, Parquet et ICU sont généralement des binaires DuckDB regroupés, tandis que dans duckdb-wasm, ils sont chargés automatiquement (y compris leur récupération) au moment de l'exécution. En particulier pour les soins intensifs, le chargement automatique ne fonctionne pas correctement dans tous les cas, LOAD icu; pourrait être nécessaire pour reproduire le même comportement.
DuckDB-Wasm est en bac à sable et n'a peut-être pas le même niveau de prise en charge des opérations hors cœur et de l'accès au système de fichiers.
Le mode par défaut de DuckDB-Wasm est monothread. Le multithreading est encore expérimental pour le moment.

Fonctionnalités DuckDB prises en charge :

Les fichiers des bases de données DuckDB sont compatibles pour être lus à partir de DuckDB-Wasm.
Les fichiers de bases de données peuvent être rendus disponibles aussi simplement que : ATTACH 'https://blobs.duckdb.org/data/test.db'; FROM db.t; démo
Prise en charge spatiale via la démo LOAD spatial
Un sous-ensemble croissant d'extensions, principales, communautaires ou externes, sont pris en charge pour DuckDB-Wasm
Le multithreading fonctionne mais il est encore expérimental et n'est pas activé par défaut

Extension DuckDB-Wasm et DuckDB

DuckDB est extensible et cela permet de déléguer des fonctionnalités à des extensions.

Les extensions principales sont disponibles sur https://extensions.duckdb.org et les extensions communautaires sont disponibles sur 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;

Montrera que h3, icu, parquet, quack et sqlite_scanner ont été chargés.

Vous pouvez essayer la démo Shell avec chargement d'extensions, mais cela nécessite environ 3,2 Mo de fichiers Wasm compressés à transférer sur le réseau (lors de la première visite, la mise en cache peut aider).

La taille des extensions varie en fonction, entre autres choses, des fonctionnalités fournies ou de la chaîne d'outils utilisée.

Construire à partir des sources

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

Structure du référentiel

Sous-projet	Description	Langue
duckdb_wasm	Bibliothèque Wasm	C++
@duckdb/duckdb-wasm	API dactylographiée	Manuscrit
@duckdb/duckdb-wasm-shell	Shell SQL	Rouiller
@duckdb/duckdb-wasm-app	Page GitHub	Manuscrit
@duckdb/réagir-duckdb	Réagir aux crochets	Manuscrit