stored-procedures

ストアドプロシージャと関数

目次

• 概要
• 使用する場面
• クイックスタート
• リファレンスガイド
• ベストプラクティス

概要

ビジネスロジック、データ検証、パフォーマンスの最適化に使用するストアドプロシージャ、関数、トリガーを実装します。プロシージャの設計、エラー処理、パフォーマンスに関する考慮事項を扱います。

使用する場面

• ビジネスロジックのカプセル化
• 複雑な複数ステップの処理
• データ検証と制約
• 監査証跡の維持
• パフォーマンスの最適化
• アプリケーション間でのコード再利用
• トリガーベースの自動化

クイックスタート

PostgreSQL - スカラー関数：

-- Create function returning single value
CREATE OR REPLACE FUNCTION calculate_order_total(
  p_subtotal DECIMAL,
  p_tax_rate DECIMAL,
  p_shipping DECIMAL
)
RETURNS DECIMAL AS $$
BEGIN
  RETURN ROUND((p_subtotal * (1 + p_tax_rate) + p_shipping)::NUMERIC, 2);
END;
$$ LANGUAGE plpgsql IMMUTABLE;

-- Use in queries
SELECT id, subtotal, calculate_order_total(subtotal, 0.08, 10) as total
FROM orders;

-- Or in application code
SELECT * FROM orders
WHERE calculate_order_total(subtotal, 0.08, 10) > 100;

リファレンスガイド

詳細な実装については、references/ ディレクトリを参照してください。

ガイド	内容
シンプルな関数	シンプルな関数
ストアドプロシージャ	ストアドプロシージャ
シンプルなプロシージャ	シンプルなプロシージャ
エラー処理を伴う複雑なプロシージャ	エラー処理を伴う複雑なプロシージャ
PostgreSQL トリガー	PostgreSQL トリガー
MySQL トリガー	MySQL トリガー

ベストプラクティス

✅ 推奨事項

• 確立されたパターンと規約に従う
• 読みやすく、保守しやすいコードを書く
• 適切なドキュメントを追加する
• デプロイ前に十分にテストする

❌ 避けるべきこと

• テストや検証を省略する
• エラー処理を無視する
• 設定値をハードコードする