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

---

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

<https://engineer.company/ja/portfolio/designed-a-function-first-postgresql-data-layer/>
