Skip to content

Commit b1bd648

Browse files
kr9lyclaude
andcommitted
design: the parser is libpg_query compiled to WebAssembly and run by wazero (the spike holds: longjmp through emscripten's emulation, protobuf output byte-identical to cgo) — no cgo, and one parser module per PostgreSQL version in the same binary, so a declared version is judged by that version's own grammar
Co-Authored-By: Claude Fable 5.1 <[email protected]>
1 parent 8fad9b9 commit b1bd648

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

‎docs/design.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -130,5 +130,5 @@ FETCH(カーソルの列は静的に決まらない)。EXPLAINの実行(em
130130
- TypeScriptフロントエンド。2つ目の言語フロントエンドで「核はSQLしか見ない」構想を検証する。言語非依存で共有するのは`internal/analyze`、`internal/schema`、マイグレーション一式、失敗モード・`One`の証明・境界の規則。言語依存はその言語のデファクトに合わせる: 呼び出し箇所の発見(TypeScript Compiler APIかtsc plugin、ESLintルール)、`R` / `P`相当の型解決(`query<R, P>(sql)`)、PG型とTS型の対応表(pg / postgres.jsが実際に返す型)、ランタイム。最初の設計論点はテンプレート構文で、Goの`text/template`を持ち込まず、`sql\`...\``のタグ付きテンプレートと`${}`の断片で「有限の展開集合」を保つ方法(断片をリテラルの選択肢に限る、など)を決める。MySQLと同じく、`internal/vet`のPG固有型の切り出しが前提。横展開の見立て: 検査の大半(列と型の存在、失敗モード、`One`の証明、境界の規約、インジェクション保証、マイグレーション)はSQL側だけで閉じていてホスト言語の型を見ない。言語ごとに必須なのは「lintの口」「テンプレート定数の取り出し」「ランタイム」の3つで、`R` / `P`の型照合は静的型がある言語で足す層(動的型の言語では実行時の行マッピング検査か、型ヒントがあれば静的に)
131131
- 2-way SQL構文(`/*{{.X}}*/'lit'`)。psqlでそのまま流せるテンプレート。expandとRenderの前段で同じ変換を入れる
132132
- ORMからの移行支援。ORMが発行したSQLを観測して`Query[R, P]`に起こす
133-
- PGのバージョンを`schema.sql`が宣言し(`-- sqlshape: postgres 18`)、アナライザーはその版の規則で判定する。既定は最新のサポート版(宣言はスキーマに1行なので、新版利用者に毎回書かせない)。パーサは常に最新版のlibpg_queryを1本だけリンクし、宣言版より新しい構文はgram.y差分から作った「版ごとに入ったノード種」の表で拒否する(実DBでは構文エラーになるのでエラー、警告ではない)。カタログは版ごとの生成TSVを埋め込み、型規則の版分岐は§10実装内の分岐で差分表を持つ。オラクルとregressコーパスは版別のCIマトリクス。`dump` / `apply`は接続先の`server_version`と宣言版のずれを警告する。サポート窓はPGの5年に合わせるが、まず17と18の2版でこの構造を作り、以後は年1回のメジャーリリース直後に追従する(マイナー版は判定に影響しないので埋め込みPGを上げるだけ)。メジャー間で判定が変わるのは、構文の追加、カタログの追加・オーバーロードによる曖昧化・稀な削除、予約語の追加、ごく稀な型規則の変更
134-
- PGの新バージョンへの追従を機械化する。回帰コーパスの取り込み → 差分 → 修正のループ。上の版指定があれば、追従は「版を1つ足す」作業になる
133+
- PGのバージョンを`schema.sql`が宣言し(`-- sqlshape: postgres 18`)、アナライザーはその版の規則で判定する。既定は最新のサポート版(宣言はスキーマに1行なので、新版利用者に毎回書かせない)。パーサはlibpg_queryをWebAssemblyにビルドしてwazeroで実行する(スパイクで成立: longjmpはemscriptenのエミュレーションで動き、protobuf出力はcgo版とバイト一致、速度は3.6倍遅いが解析全体では誤差)。cgoが消えて`go install`にCツールチェーンが要らなくなり、wasmモジュールは隔離されるので版ごとのパーサを同じバイナリに複数積める。宣言版より新しい構文は、その版の本物の文法が拒否する(gram.y差分の表は要らない)。カタログは版ごとの生成TSVを埋め込み、型規則の版分岐は§10実装内の分岐で差分表を持つ。オラクルとregressコーパスは版別のCIマトリクス。`dump` / `apply`は接続先の`server_version`と宣言版のずれを警告する。サポート窓はPGの5年に合わせるが、まず17と18の2版でこの構造を作り、以後は年1回のメジャーリリース直後に追従する(マイナー版は判定に影響しないので埋め込みPGを上げるだけ)。メジャー間で判定が変わるのは、構文の追加、カタログの追加・オーバーロードによる曖昧化・稀な削除、予約語の追加、ごく稀な型規則の変更
134+
- PGの新バージョンへの追従を機械化する。回帰コーパスの取り込み → 差分 → 修正のループ。上の版指定があれば、追従は「版を1つ足す」作業になる。libpg_queryのリリースを待つ形は変わらない(18は8か月遅れた)。pg_query_goを待つ必要はなくなる

0 commit comments

Comments
 (0)