鸭数据库 wasm

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	反应钩子	打字稿