PostgresからAPIへのJSONパススルーを設計
PostgreSQL関数が完成したJSONを返し、Go
APIがそのまま転送するJSONパススルー構成を設計。中間のアンマーシャリ
ングをなくし、フロントエンドをスキーマ変更から切り離した。
2025

状況.
通常、データベースからブラウザーへは、変換を連ねてデータを渡す。DBが
行を返し、APIが構造体へ読み込み、形を変え、JSONへ再変換して、ようや
く外へ送る。各段階にコードとテストが必要で、APIとDBの認識が食い違う
場所も増える。

課題.
この変換の中継を省くことを考えた。DBが完成した応答を返せば、APIはそ
のまま通し、フロントエンドもGo内の手作業で維持する複製ではなく、DBの
構造に直接依存できる。

行動.
直接通過させる構成にした。PostgreSQL関数が、データのある場所で、SQL
の責任としてJSON応答全体を組み立てる。Goハンドラーはjson.RawMessage
で受け取り、分解も再符号化もせず転送する。小さなQueryJSON補助関数
で、意識して覚えなくてもこの方法が最も簡単な実装になるようにした。従
来の多層APIで増えるDTO、マッパー、応答構造体など、中間の仕組みが不要
になった。

結果.
ハンドラーが大幅に短くなり、特にフロントエンドとGoの結合がなくなっ
た。関数の返す内容を変えれば、ハンドラーを1行も直さず新しい形がクラ
イアントへ届く。可動部分が減り、層間の不一致という種類の問題自体が存
在しなくなった。

カテゴリー:
1プラットフォーム設計	/ja/categories/platform-architecture/	data.engineer.company	70
1バックエンド開発	/ja/categories/backend/	data.engineer.company	70
1API・システム連携	/ja/categories/api/	data.engineer.company	70
1データベース	/ja/categories/databases/	data.engineer.company	70
1PostgreSQL	/ja/categories/postgresql/	data.engineer.company	70
1SQL	/ja/categories/sql/	data.engineer.company	70
1性能改善	/ja/categories/performance/	data.engineer.company	70

サービス:
1プラットフォーム・ソリューション設計	/ja/services/platform-architecture/	data.engineer.company	70
1バックエンド・API開発	/ja/services/backend-development/	data.engineer.company	70
1AIエージェント用ツール・MCPサーバー	/ja/services/ai-tools/	data.engineer.company	70
1データベース設計・モデリング	/ja/services/database-design/	data.engineer.company	70

hこのページのウェブ版	URL:https://data.engineer.company/ja/portfolio/designed-a-json-passthrough-from-postgres-to-api/	data.engineer.company	70
