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

カテゴリー:
1プラットフォーム設計	/ja/categories/platform-architecture/	engineer.company	70
1バックエンド開発	/ja/categories/backend/	engineer.company	70
1データベース	/ja/categories/databases/	engineer.company	70
1PostgreSQL	/ja/categories/postgresql/	engineer.company	70
1SQL	/ja/categories/sql/	engineer.company	70
1データガバナンス	/ja/categories/data-governance/	engineer.company	70
1セキュリティ	/ja/categories/security/	engineer.company	70

サービス:
1プラットフォーム・ソリューション設計	/ja/services/platform-architecture/	engineer.company	70
1バックエンド・API開発	/ja/services/backend-development/	engineer.company	70
1データベース設計・モデリング	/ja/services/database-design/	engineer.company	70
1データガバナンス・品質管理	/ja/services/data-governance/	engineer.company	70

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