Postgre関数中心のデータ層を設計
34スキーマにまたがる1,275個のストアド関数を持つ、PostgreSQL関数中心のデータ層を設計。すべての読み書きをテーブル直接操作ではなく、データベースで実行権限を付与できる関数経由にした。
2025
状況. 業務ロジックは漏れ出しやすい。APIの一部や、ハンドラー内で実行するSQLに分散し、同じルールが少しずつ異なる2通り、3通りで書かれ、データをどう扱うシステムかを指し示せる場所がなくなる。そこからバグやセキュリティの穴が生じる。
課題. ロジックの置き場を1つにし、すべての読み書きをデータベース経由にして、APIを業務ルールを知らない薄いアダプターに保ち、全体を厳密に制限することを目指した。
行動. 関数中心のデータ層にした。スキーマはidentity、organization、review、message、notificationと他29領域、計34に分け、アプリの全操作を1,275個のPostgreSQL関数経由にし、Goからテーブルへ直接アクセスさせない。データベースでこの境界を強制した。APIのログインロールmarinerにはアプリ関数のEXECUTEとスキーマのUSAGEだけを与え、SELECTもINSERTも直接操作も許さない。一括付与でなく約4,000件の明示的な権限を用いた。関数は、ログインできない別ロールfunction_ownerの所有で、固定search_pathを持つSECURITY DEFINERとして実行する。スーパーユーザーはマイグレーションとcron専用にし、稼働アプリから遠ざけた。
結果. 監査できる1か所にロジックがまとまり、APIは良い意味で薄く単調に保たれた。境界は全員の記憶でなくPostgres自体が守る。APIが侵害されても関数の許さない操作はできない。1,275関数では規律に実際の費用があり、新項目はクエリの1行でなく、マイグレーションと関数変更を要する。この摩擦が境界を保つ代償だった。