パフォーマンス監査 p99
遅いクエリを特定し、EXPLAIN ANALYZE、インデックス戦略、運用環境で Postgres を無効にする 5 つのアンチパターンを理解します。
最適化する前に測定する#
監査は数字から始まります。 Studio は、エンドポイントおよびクエリによって p50/p95/p99 を公開します。変更の前に 7 日間のベースラインを取得します。
aura db slow-queries および aura db stats CLI コマンドは、リンクされたプロジェクトの pg_stat_statements とデータベース プール/サイズ メトリクスをクエリします。スコープはプロジェクトに限定されます (Studio › データベースとログでも利用可能)。 aura db inspect indexes|tables|locks は、インデックスの使用状況 (未使用のフラグが付いているもの)、テーブルのサイズと無効な行、ブロック ロックをリストします。/raw はシステム カタログを拒否するため、これらの診断を実行できません。
# 最もコストのかかる 10 のクエリ (合計時間)
aura db slow-queries --limit 10
# 接続とデータベースのサイズ (エンドポイントのレイテンシー: Studio › ログ)
aura db stats
リアルタイムの pg_stat_statements#
pg_stat_statements は、すべての新しいプロジェクトにインストールされ、プリロードされます。正規化された各クエリ (リテラル値は保存されません) を mean_exec_time、 calls 、および rowsで集計します。 /raw はそれを直接読み取りません。ビューはクラスター全体です。そのため、プロジェクトのクエリのみを返す上記のコマンド、または Studio › データベースを使用します。
aura db slow-queries --limit 10 --json
aura db inspect indexes # idx_scan = 0 であり、一意/プライマリではない → 未使用
プロのように計画を読む#
プロジェクトのステートメント タイムアウト (10 秒) よりも長く実行されるクエリは、aura db rawの STATEMENT_TIMEOUT (HTTP 504) / « ステートメント タイムアウトによるステートメントのキャンセル » でキャンセルされます。作業を減らすか、分割します。
このプランでは、クエリが遅い理由 を示します。探すべき 4 つのシグナル:
- テーブルの
Seq Scan> 10k 行 → インデックスがありません rows (estimated) ≠ rows (actual)by ±10× → 廃止された統計、analyze table_name- 100k 行以上の
Nested Loop→ ハッシュ結合が優先されますが、WHERE が欠落している可能性があります MaterializeまたはSort Method: external merge→ RAM が使い果たされ、work_memを増やす必要があります
explain (analyze, buffers, format json)
select * from orders
where customer_id = 'abc' and created_at > now() - interval '30 days';
いつ、何を、どのようにして#
- B ツリー (デフォルト): 等価、範囲、順序付け。 80%のケースです。
- GIN: 全文検索、JSONB、テーブル。
using gin (to_tsvector('french', body))。 - GiST: 範囲タイプ、除外制約、類似性検索 (
pg_trgm)。 - HNSW (pgvector): ベクトル検索、 > 100k ベクトル。
- 部分的な: 一般的な条件、論理的な削除の
where deleted_at is null。 - :
include (...)をカバーして、テーブルの検索を回避します。
各インデックスにより、INSERT/UPDATE/DELETE が遅くなります (インデックスあたり最大 5 ~ 15%)。未使用のインデックスを削除します — aura db inspect indexes はそれらをリストします (スキャンされず、一意ではなく、プライマリでもありません)。
本番環境で Postgres を停止させる原因#
- N+1 クエリ — 結合を行うか、ループではなく SDK で
!innerを使用します - OFFSET によるページネーション — 1000 を超える場合は、カーソルベース (
where id > last_seen) を使用します - SELECT * (大きなテーブルの場合) — 必要な列のみをリクエストします
- 長いトランザクション — これらは VACUUM をブロックし、肥大化を引き起こします。 1 秒未満を維持する
- インデックスのない RLS ポリシー — ポリシーで
tenant_id = auth.tenant()を使用する場合、インデックスtenant_id