# PostgreSQL関数中心のデータ層を設計

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行でなく、マイグレーションと関数変更を要する。この摩擦が境界を保つ代償だった。

役割: データベースエンジニア
=> /ja/categories/platform-architecture/ カテゴリー: プラットフォーム設計
=> /ja/categories/backend/ カテゴリー: バックエンド開発
=> /ja/categories/databases/ カテゴリー: データベース
=> /ja/categories/postgresql/ カテゴリー: PostgreSQL
=> /ja/categories/sql/ カテゴリー: SQL
=> /ja/categories/data-governance/ カテゴリー: データガバナンス
=> /ja/categories/security/ カテゴリー: セキュリティ
=> /ja/services/platform-architecture/ サービス: プラットフォーム・ソリューション設計
=> /ja/services/backend-development/ サービス: バックエンド・API開発
=> /ja/services/database-design/ サービス: データベース設計・モデリング
=> /ja/services/data-governance/ サービス: データガバナンス・品質管理

=> https://software.engineer.company/ja/portfolio/designed-a-function-first-postgresql-data-layer/ このページのウェブ版
