# 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行も直さず新しい形がクライアントへ届く。可動部分が減り、層間の不一致という種類の問題自体が存在しなくなった。

役割: プラットフォームアーキテクト
=> /ja/categories/platform-architecture/ カテゴリー: プラットフォーム設計
=> /ja/categories/backend/ カテゴリー: バックエンド開発
=> /ja/categories/api/ カテゴリー: API・システム連携
=> /ja/categories/databases/ カテゴリー: データベース
=> /ja/categories/postgresql/ カテゴリー: PostgreSQL
=> /ja/categories/sql/ カテゴリー: SQL
=> /ja/categories/performance/ カテゴリー: 性能改善
=> /ja/services/platform-architecture/ サービス: プラットフォーム・ソリューション設計
=> /ja/services/backend-development/ サービス: バックエンド・API開発
=> /ja/services/ai-tools/ サービス: AIエージェント用ツール・MCPサーバー
=> /ja/services/database-design/ サービス: データベース設計・モデリング

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