本文へ移動

PostgresからAPIへのJSONパススルーを設計

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

データベースからブラウザーへ直接届くJSON

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

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

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

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

  • 地平線へとまっすぐ延びる道路
    写真: Wuestensohn2000 / Pixabay
  • 道路トンネル内の車
    写真: wal_172619 / Pixabay

この経験をお客様のプロジェクトに

「PostgresからAPIへのJSONパススルーを設計」を、お客様の組織の似た課題を考える出発点にしてください。この実績を支えたサービスを、お客様のプロジェクトにも提供できます。 実際の業務に合った構造を設計し、将来必要になる問いにも答えられるようにします。

サービスを見る お問い合わせ

結果の背景を確かめる

この事例の状況、判断、結果をご覧ください。どの部分がお客様の制約の下でも生かせるか、どこに別の方法が必要かをご相談いただけます。 PostgresからAPIへのJSONパススルーを設計 — データベースからブラウザーへ直接届くJSON

サービスを見る お問い合わせ

より多くの実績の 一つです — そのすべてをこのサイトで公開しています。

どの項目も、状況、課題、実施内容、変化という同じ構成で記載しています。

すべての実績を見る

必要な改善を定める

代表的なデータセット、そこから答えを得たい問い、現在のボトルネックをお知らせください。品質、処理量、復旧の測り方を合意できます。

料金を見る お問い合わせ

APIとデータベースの整合性を無理なく保ちたいですか?

「PostgresからAPIへのJSONパススルーを設計」の判断の背景についてお尋ねください。仕事内容を説明し、お客様のプロジェクトを検討できる担当者が対応します。

サービスを見る
welcome@engineer.company +45 50 10 61 84 デンマーク、コペンハーゲン
PostgreSQL関数が完成したJSONを返し、Go APIがそのまま転送するJSONパススルー構成を設計。中間のアンマーシャリングをなくし、フロントエンドをスキーマ変更から切り離した。のQRコード
このページを持ち歩くhttps://data.engineer.company/ja/portfolio/designed-a-json-passthrough-from-postgres-to-api/