DuckDB-Wasm

DuckDB é um sistema de gerenciamento de banco de dados SQL OLAP em processo.

DuckDB-Wasm traz DuckDB para todos os navegadores graças ao WebAssembly.

Duckdb-Wasm fala Arrow fluentemente, lê arquivos Parquet, CSV e JSON apoiados por APIs de sistema de arquivos ou solicitações HTTP e foi testado com Chrome, Firefox, Safari e Node.js. Saiba mais sobre DuckDB-Wasm em nossa publicação VLDB ou na palestra gravada.

Experimente em shell.duckdb.org ou incorporação externa de terceiros do DuckDB-Wasm, leia a documentação da API, confira os exemplos de aplicativos da web e converse conosco no Discord.

DuckDB e DuckDB-Wasm

DuckDB-Wasm é atualmente baseado em DuckDB v1.1.1.

Diferenças relevantes:

A pilha HTTP é diferente entre as versões nativa e Wasm do DuckDB. Os mais relevantes são:
- As solicitações são sempre atualizadas para HTTPS
- As solicitações precisam do servidor para permitir acesso Cross Origin em um determinado recurso
- A implementação do sistema de arquivos (por exemplo, S3) é diferente e isso pode causar algumas diferenças
A instalação da extensão é lenta, o que significa que INSTALL extension_name FROM 'https://repository.endpoint.org'; adiar a busca da extensão para o primeiro LOAD extension_name; instrução. INSTALL x FROM community; taquigrafias também são suportadas.
As compilações DuckDB-Wasm são otimizadas para velocidade de download. Extensões principais como preenchimento automático, JSON, Parquet e ICU geralmente são binários DuckDB agrupados, enquanto no duckdb-wasm eles são carregados automaticamente (incluindo sua busca) em tempo de execução. Em particular para o carregamento automático da UTI, não funciona corretamente em todos os casos, LOAD icu; pode ser necessário para reproduzir o mesmo comportamento.
DuckDB-Wasm está em sandbox e pode não ter o mesmo nível de suporte para operações fora do núcleo e acesso ao sistema de arquivos
O modo padrão do DuckDB-Wasm é de thread único. O multithreading ainda é experimental no momento.

Recursos suportados do DuckDB:

Os arquivos de banco de dados DuckDB são compatíveis para serem lidos no DuckDB-Wasm.
Os arquivos de bancos de dados podem ser disponibilizados de forma simples como: ATTACH 'https://blobs.duckdb.org/data/test.db'; FROM db.t; demonstração
Suporte espacial via demonstração espacial LOAD spatial
Um subconjunto crescente de extensões, sejam elas principais, comunitárias ou externas, são suportadas pelo DuckDB-Wasm
Multithreading funciona, mas ainda é experimental e por padrão não está habilitado

Extensão DuckDB-Wasm e DuckDB

DuckDB é extensível e permite delegar funcionalidades a extensões.

As extensões principais estão disponíveis em https://extensions.duckdb.org, e as extensões da comunidade estão disponíveis em 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;

Mostrará que h3, icu, parquet, quack e sqlite_scanner foram carregados.

Você pode experimentar a demonstração do Shell com carregamento de extensões, mas isso exige que cerca de 3,2 MB de arquivos Wasm compactados sejam transferidos pela rede (na primeira visita, o cache pode ajudar).

Os tamanhos das extensões variam dependendo, entre outras coisas, da funcionalidade fornecida ou do conjunto de ferramentas usado.

Construir a partir da fonte

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

Estrutura do Repositório

Subprojeto	Descrição	Linguagem
patodb_wasm	Biblioteca Wasm	C++
@duckdb/duckdb-wasm	API de texto digitado	Texto datilografado
@duckdb/duckdb-wasm-shell	Concha SQL	Ferrugem
@duckdb/duckdb-wasm-app	Página GitHub	Texto datilografado
@duckdb/react-duckdb	Ganchos de reação	Texto datilografado