duckdb wasm

DuckDB-Wasm

DuckDB는 처리 중인 SQL OLAP 데이터베이스 관리 시스템입니다.

DuckDB-Wasm은 WebAssembly 덕분에 모든 브라우저에 DuckDB를 제공합니다.

Duckdb-Wasm은 Arrow를 유창하게 구사하고 파일 시스템 API 또는 HTTP 요청으로 지원되는 Parquet, CSV 및 JSON 파일을 읽으며 Chrome, Firefox, Safari 및 Node.js에서 테스트되었습니다. VLDB 간행물이나 녹음된 대화에서 DuckDB-Wasm에 대해 자세히 알아보세요.

shell.duckdb.org 또는 DuckDB-Wasm의 외부 제3자 삽입에서 사용해 보고, API 문서를 읽고, 웹 앱 예제를 확인하고, Discord에서 채팅해 보세요.

DuckDB 및 DuckDB-Wasm

DuckDB-Wasm은 현재 DuckDB v1.1.1을 기반으로 합니다.

관련 차이점:

• HTTP 스택은 DuckDB의 기본 버전과 Wasm 버전 간에 다릅니다. 가장 관련성이 높은 것은 다음과 같습니다.
  • 요청은 항상 HTTPS로 업그레이드됩니다.
  • 요청에는 특정 리소스에 대한 Cross Origin 액세스를 허용하는 서버가 필요합니다.
  • 파일 시스템 구현(예: 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.2MB의 압축된 Wasm 파일이 필요합니다(처음 방문 시 캐싱이 도움이 될 수 있음).

확장 크기는 무엇보다도 제공된 기능이나 사용된 도구 모음에 따라 달라집니다.

소스에서 빌드

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

저장소 구조

하위 프로젝트	설명	언어
duckdb_wasm	와즘 도서관	C++
@duckdb/duckdb-wasm	타입스크립트 API	타이프스크립트
@duckdb/duckdb-wasm-쉘	SQL 쉘	녹
@duckdb/duckdb-wasm-app	GitHub 페이지	타이프스크립트
@duckdb/반응-duckdb	반응 후크	타이프스크립트