# 遅い処理をRiverジョブキューへ移行

時間のかかる処理をリクエスト経路からRiverジョブキューへ移し、15個のワーカーモジュール、8件の定期タスク、20件のpg_cronジョブにより、背後の作業が続く間も応答を返せるようにした。

2025

状況. メール、検索インデックス再構築、文書生成、順位再計算などは、利用者を待たせながら行うべき仕事ではなかった。リクエスト内では求めていない処理の待機表示を見せ、goroutineなら、デプロイ中の再起動で、実行予定だった記録もなく消えてしまう。

課題. 再起動に耐え、失敗を再試行し、未実行を確認できる、永続的なバックグラウンド処理の置き場が必要だった。

行動. 主にPostgreSQL内にキューを持つことからRiverを選んだ。DBはすでに記録の正本なので、ジョブと対象行を一緒にコミット・ロールバックでき、別の基盤を運用して理解する必要がない。15のワーカーモジュールと8定期タスクを設けた。その下では20個のpg_cronジョブが、パーティション削除、ソルト更新、集約更新など、DB自身に適した保守を担う。気になるほど遅い作業を、このどちらかへ移した。

結果. リクエストは早く返り、遅い作業も完了し、未完了なら再試行と履歴が残る。専用ブローカーでなくPostgresに置くのは意図的な限界であり、無限には伸びず、一定量では不適切になる。いずれにせよDBが制約となる基盤では、使わない余力より可動部分を1つ減らすことに価値を置いた。

役割: バックエンドエンジニア
=> /ja/categories/backend/ カテゴリー: バックエンド開発
=> /ja/categories/databases/ カテゴリー: データベース
=> /ja/categories/postgresql/ カテゴリー: PostgreSQL
=> /ja/categories/automation/ カテゴリー: 自動化・CI/CD
=> /ja/categories/reliability/ カテゴリー: 信頼性・バックアップ
=> /ja/categories/performance/ カテゴリー: 性能改善
=> /ja/services/backend-development/ サービス: バックエンド・API開発
=> /ja/services/ai-tools/ サービス: AIエージェント用ツール・MCPサーバー
=> /ja/services/database-design/ サービス: データベース設計・モデリング
=> /ja/services/site-reliability/ サービス: サイト信頼性・監視

=> https://platform.engineer.company/ja/portfolio/moved-slow-work-onto-a-river-job-queue/ このページのウェブ版
