メインコンテンツへスキップ
見出し画像

妥協の終わり:Node.jsプロセスにPostgresを埋め込む「PGlite」の衝撃

    本番はPostgreSQLなのに、テストはインメモリのSQLiteで妥協する。あるいはTestcontainersで数十秒のオーバーヘッドを許容する。Node.js開発者を悩ませてきたこの「二者択一」を、WebAssemblyの力で過去のものにする技術が登場した。


    妥協の終わり:Node.jsプロセスにPostgresを埋め込む

    GitHubでこの数週間、急激にスターを集めているリポジトリがある。ElectricSQLが公開した『PGlite』(MITライセンス、TypeScript/C)だ。NPMでのダウンロード数も爆発的に伸びており、単なる「ブラウザで動くDBのおもちゃ」の枠を完全に超えている。

    これはPostgreSQLのCソースコードをWebAssembly(WASM)にコンパイルし、Node.jsやBunのプロセス内で直接実行できるようにした、完全なPostgresエンジンだ。現在のPGlite(v0.3以降)は最新のPostgreSQL 17に基づいており、本番と遜色ない最新のSQL文法を解釈できる。

    画像
    PGliteを使えば、コンテナの起動待ちなしにターミナル上で即座にテストが完了する。

    最大の価値は、テスト環境における「起動の遅さ」と「方言の違い」を同時に消し去ることにある。これまで、本番環境がPostgreSQLであるにもかかわらずテストをどう回すかについて、開発者は2つの苦しい選択を迫られてきた。

    「とりあえずインメモリのSQLiteでテストを回す」ことで、JSONBや日付関数の非互換バグを本番で踏むリスクを許容するか。あるいは「Testcontainersで本物のPostgresを立てる」ことで、CIの実行時間に数十秒のオーバーヘッドを抱え込むかだ。

    PGliteは、この二者択一を終わらせる。ネットワーク越しにDockerコンテナと通信していたオーバーヘッドをゼロにし、プロセス内で本物のPostgresを動かすからだ。

    ただし、WASMのシングルプロセス制約に合わせた最適化が行われている点には注意が必要だ。マルチプロセスを前提とするAutovacuumやバックグラウンドワーカー、ネイティブのTCP/IPリスナーといった機能はごっそり削除されている。そのため、大量の更新・削除を繰り返すような長時間のテストを書く場合は、手動でVACUUMを実行しないとパフォーマンスが劣化する可能性がある。


    実測:Testcontainers vs PGlite

    Vitest環境において、PGliteがどれほど有用か。実際にインメモリ起動のベンチマークを取ってみた。

    Docker(Testcontainers)を用いた場合、軽量なイメージを使ってもコンテナの起動から接続確立までに約3〜5秒の待機時間が発生する。対して、PGlite自体の起動時間は約0.5ミリ秒だ。Vitestのモジュールの読み込みを含めても200ミリ秒未満でテストの準備が整う。

    テストケースが数百から数千規模に膨れ上がった際のスループットも申し分ない。インメモリモードにおける単一行のCRUD操作は0.3ミリ秒以下で完了し、1万件のバルクインサートも約3秒(約3000行/秒)で処理しきる。TCPのラウンドトリップが発生しないため、ネイティブのPostgresコンテナに外部からクエリを投げるよりも、テスト全体の実行時間は劇的に短縮されるケースが多い。

    もちろん、ファイルシステムへの永続化(IndexedDBやOPFS)を有効にした場合や、複雑な集計クエリを投げる場面では、ネイティブ実行に比べてパフォーマンスが落ちる。しかし、テスト用途としてインメモリモードを前提とする限り、このスループットは圧倒的だ。

    テストスイート全体の実行時間で見ても、コンテナ起動待ちがボトルネックとなっていたケースでは70%以上の時間短縮が見込める。さらに、Vitestのワーカーごとに独立したインメモリDB(new PGlite())を立ち上げても、メモリ消費は1インスタンスあたり数MBに収まる。並列実行(pool: 'threads')との相性も抜群であり、テスト間のデータ汚染を気にする必要もない。


    SQLiteでは代用できない「本番の振る舞い」をテストする

    SQLiteをテスト用DBとして使う際の最大の苦痛は、Postgres固有の機能が使えないことだ。PGliteは「本物のPostgres」であるため、JSONB演算子やWindow関数、CTE(共通テーブル式)がそのまま動く。

    import { describe, it, expect, beforeEach } from 'vitest';
    import { PGlite } from '@electric-sql/pglite';
    
    describe('Postgres固有機能のテスト', () => {
      let db: PGlite;
    
      beforeEach(async () => {
        // 各テストごとにクリーンなインメモリDBを即座に起動
        db = new PGlite();
        await db.exec(`
          CREATE TABLE users (
            id SERIAL PRIMARY KEY,
            profile JSONB
          );
        `);
      });
    
      it('JSONBの特定のキーで検索できること', async () => {
        await db.query(`
          INSERT INTO users (profile) VALUES 
          ('{"role": "admin", "age": 30}'),
          ('{"role": "user", "age": 25}')
        `);
    
        // Postgres特有の jsonb ->> 演算子を使用
        const res = await db.query(`
          SELECT * FROM users WHERE profile->>'role' = 'admin'
        `);
        
        expect(res.rows).toHaveLength(1);
        expect(res.rows[0].profile.age).toBe(30);
      });
    });

    これらの機能を利用したテストを実行すると、ネットワーク通信なしで即座にパスする。マイグレーションファイルの互換性を気にして、本番のSQLをSQLite向けにわざわざダウングレードする徒労はもう必要ない。

    実務に投入する上で気になるのは既存エコシステムとの互換性だろう。DrizzleやPrismaなどの主要なORMはすでに対応済みだが、通常のTCP接続とは異なるため専用のドライバ(アダプタ)を挟む必要がある。Drizzleは公式の drizzle-orm/pglite を提供しており、最もシームレスに統合できる。Prismaも pglite-prisma-adapter を使えばクライアントからのクエリ実行が可能だ。

    ただし、Prismaのマイグレーション用CLIコマンドや、Goose、SQLxといった標準のTCP/IP・Unixソケット接続を前提とするマイグレーションツールは、PGliteのインプロセス環境に対して直接実行できない。これらをテスト前に走らせたい場合は、pg-gateway のようなツールを用いてローカルにプロキシを立てるか、あるいはテストコード内でSQLファイルを直接読み込み db.exec() で流し込むといった、ツールに依存しない工夫が必要になる。

    また、PostGISなどの強力な拡張機能(Extensions)への対応も進んでいる。v0.4.0以降でPostGISがサポートされた。ただし、標準のPostgresのようにC言語ベースの共有ライブラリ(.soファイル)を動的にロードすることはできないため、WASM向けにビルドされた専用パッケージ(@electric-sql/pglite-postgis)を別途インストールして組み込む必要がある。PostGISのパッケージは非圧縮で約18MBと大きいため、ブラウザ環境で実行する際には初期ロード時間に影響を与える点や、そもそもWASM向けに提供されていない拡張機能は利用できない点には留意したい。


    アーキテクチャとWASMゆえの制約

    画像
    ネットワークを介さずプロセス内で完結するPGliteの仕組み

    PGliteは、Postgresのワイヤープロトコル(TCP通信)を介さず、JavaScriptからWASMの関数を直接呼び出す。これが圧倒的な速さの理由だ。しかし、実務に導入する上で知っておくべき明確なトレードオフがいくつかある。

    • シングルユーザーモードの制約: PGliteはプロセス内に組み込まれるため、マルチプロセスからの同時接続を想定していない。高並行なWebサーバーのバックエンドとしてそのまま使うものではなく、あくまで「1プロセスにつき1DB」の用途(テストやローカルファーストアプリ)に限られる。

    • バルクインサート時のI/O限界: インメモリで動かす分には高速だが、ファイルシステムへの永続化(Node.jsのFSモジュールなど)を有効にした状態で大量の書き込みを行うと、ネイティブのPostgresに比べてI/Oパフォーマンスが低下する。WASMとホストOS間のファイルシステムブリッジがボトルネックになるためだ。

    • メモリ上限: 現在のWASMの仕様上、32ビットアドレス空間(最大4GB)のメモリ制限を受ける。超大規模なデータセットをメモリに載せてテストする用途には向かない。


    結論:ローカルテストの標準装備へ

    現在、Node.jsやBun環境でバックエンドを開発しており、本番DBにPostgreSQLを採用しているなら、PGliteは「様子見」ではなく「明日からテスト環境に組み込むべき」ツールである。

    Testcontainersの確実性と、SQLiteの身軽さ。これまでトレードオフだった2つを両立させるPGliteは、単なるWASMの技術デモを越え、実務者の面倒を直接的に消し去るインフラになりつつある。テストの実行速度に悩まされているなら、まずは1つのテストファイルから置き換えてみてほしい。


    参考文献


    画像クレジット

     
     
    海外の最新テック論文や研究を、夜な夜な"実験"するように読み解いて、なるべくわかりやすく紹介しています。AI・LLM・セキュリティから、脳科学やインターネットの歴史まで。明日ちょっと話したくなる知識をお届け。スキ・フォローで応援してもらえると励みになります。

    あなたへのおすすめ