pglite
可嵌入的 Postgres,具備即時、反應式綁定。
pglite 是什麼?
可嵌入的 Postgres,具備即時、反應式綁定。。注意:原文summary與tagline相同,但為避免重複句號,此處保留一個句號。
pglite 概覽
這是什麼
PGlite 是將 PostgreSQL 編譯為 WebAssembly 並封裝成 TypeScript 客戶端函式庫的專案。它讓你能在瀏覽器、Node.js、Bun 和 Deno 中執行 Postgres,無需安裝其他依賴。該函式庫壓縮後約 3 MB,並支援 pgvector 和 PostGIS 等擴充套件。與先前的瀏覽器版 Postgres 不同,PGlite 不使用 Linux 虛擬機器,而是直接以 WebAssembly 執行 Postgres。
主要功能
- 可在瀏覽器、Node.js、Bun 和 Deno 中執行 Postgres,無需額外依賴。
- 壓縮後僅約 3 MB。
- 支援 pgvector、PostGIS 等 Postgres 擴充套件。
- 可作為暫存記憶體資料庫,或持久化至檔案系統(Node/Bun/Deno)或 indexedDB(瀏覽器)。
- 純 WebAssembly 實作,無需 Linux 虛擬機器。
- 自 v0.5.13 起提供與
pg(node-postgres)模組相容的連線物件。
使用情境
用於建構直接在瀏覽器或無伺服器環境中執行 Postgres 的反應式、即時、本地優先應用程式。也可作為 Node.js、Bun 或 Deno 的嵌入式資料庫,適合測試、開發或離線優先場景,在這些場景中完整安裝 Postgres 並不實際。
快速開始
安裝套件:
npm install @electric-sql/pglite
建立記憶體資料庫並執行查詢:
import { PGlite } from "@electric-sql/pglite";
const db = new PGlite();
await db.query("select 'Hello world' as message;");
// -> { rows: [ { message: "Hello world" } ] }
若要持久化,請傳入路徑(Node/Bun/Deno)或 indexedDB URI(瀏覽器):
const db = new PGlite("./path/to/pgdata"); // 檔案系統
const db = new PGlite("idb://my-pgdata"); // 瀏覽器 indexedDB
授權與價格
採用 Apache License 2.0 與 PostgreSQL License 雙重授權。開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。