ページ内ナビ
概要
Postgres.jsはNode.js、Deno、Bun、Cloudflare向けのPostgreSQL clientです。ES6 tagged templateを中心にSQLを記述し、interpolation valueをPostgreSQL parameterへ分離してqueryを組み立てます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日:
主な特徴
tagged templateでvalueをparameterへ自動分離する
sql\... ${value} ...\`のvalueは$1`等のplaceholderへ変換され、値はquery textと分離してPostgreSQLへ送られます。dynamic identifierやinsert/update helperも用意されています。
出典:[1]
transaction・cursor・LISTEN/NOTIFY・dynamic queryを一つのAPIで扱う
transaction、cursor/streaming、dynamic query fragment、LISTEN/NOTIFY、custom type等を提供し、薄いclient APIのままPostgreSQL機能へアクセスできます。
出典:[1]
向いている用途
導入前の確認
dynamic identifierとuser inputの境界を区別する
通常のvalue interpolationはparameterizedされますが、table/column名等のidentifierはsql(identifier)等の専用APIで扱います。user入力をidentifierとして無制限に渡さずallowlistで制御してください。
出典:[1]
serverless/edgeではconnection設定とtransaction lifecycleを確認する
packageはNode.js、Deno、Bun、workerd向けexportを提供しますが、実際のPostgreSQL connection上限やproxy/pooler compatibilityはdeployment providerに依存します。v3.4.9はNode 12以上をpackage engineに指定しています。
出典:[3]
参考にした公式資料
- [1]Postgres.js v3.4.9 README(2026-10-06)
- [2]Postgres.js v3.4.9 release(2026-10-06)
- [3]Postgres.js v3.4.9 package metadata(2026-10-06)
編集部からの補足
SQLを明示的に書きながら小さなdriver layerを使いたいbackendに向きます。valueとidentifierの扱いを区別し、serverlessではconnection lifecycleを確認してください。
3ステップで試す
- 1
ソースを取得
git clone --depth 1 https://github.com/porsager/postgres.git - 2
リポジトリへ移動
cd postgres - 3
公式手順を確認
READMEのInstallation / Quick Start / Getting Startedにある公式コマンドを続けて実行してください。
find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit
成長
成長の推移 · 直近30日
8,728 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit(直近30日)
- 0
- Open PR
- 72
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
GitHubのデータGitHubの詳細データを見る
GitHub Topics
- postgresql
- postgres
- database
- nodejs
- driver
- client
- deno
- cockroachdb
- Stars
- 8,728
- Forks
- 382
- Watchers
- 48
- Open Issues
- 252
- Contributors
- 77
- 所有者種別
- User
- 主要言語
- JavaScript
- ライセンス
- Unlicense
- リポジトリ最終更新
- 2026/09/02
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- Pino18,238 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
低overheadなJSON loggingをNode.js backendへ組み込む
JavaScript - npm CLI10,171 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
JavaScriptプロジェクトの依存関係と公開パッケージをコマンドラインで管理する
JavaScript - i18next8,636 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
翻訳キー・複数形・補間・resource loadingをUI frameworkから切り離すi18n core
JavaScript - fake-indexeddb695 Stars
共通タグ 3件 · 共通カテゴリ 1件 · 同じ言語
Node.jsのテストでIndexedDB互換APIをメモリ上に再現する
JavaScript - Electron123,388 Stars
共通タグ 3件 · 共通カテゴリ 1件
ChromiumとNode.jsを同梱し、HTML・CSS・JavaScriptから3 OS向けdesktop appを構築するruntime
C++ - Playwright97,099 Stars
共通タグ 3件 · 共通カテゴリ 1件
Chromium・Firefox・WebKitを一つのAPI/Test runnerで操作し、E2E test・script・agent browser automationを実行する
TypeScript
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。