コンテンツへスキップ
オーラベースのロゴ
オーラベース

パフォーマンス監査 p99

遅いクエリを特定し、EXPLAIN ANALYZE、インデックス戦略、運用環境で Postgres を無効にする 5 つのアンチパターンを理解します。

ハウツーガイド14 分 読み取りレベル 高度な2026/04/15 に改訂

このページは自動翻訳されました。英語版が正式です。

最適化する前に測定する#

監査は数字から始まります。 Studio は、エンドポイントおよびクエリによって p50/p95/p99 を公開します。変更の前に 7 日間のベースラインを取得します。

情報

aura db slow-queries および aura db stats CLI コマンドは、リンクされたプロジェクトの pg_stat_statements とデータベース プール/サイズ メトリクスをクエリします。スコープはプロジェクトに限定されます (Studio › データベースとログでも利用可能)。 aura db inspect indexes|tables|locks は、インデックスの使用状況 (未使用のフラグが付いているもの)、テーブルのサイズと無効な行、ブロック ロックをリストします。/raw はシステム カタログを拒否するため、これらの診断を実行できません。

clibash
# 最もコストのかかる 10 のクエリ (合計時間)
aura db slow-queries --limit 10

# 接続とデータベースのサイズ (エンドポイントのレイテンシー: Studio › ログ)
aura db stats

リアルタイムの pg_stat_statements#

pg_stat_statements は、すべての新しいプロジェクトにインストールされ、プリロードされます。正規化された各クエリ (リテラル値は保存されません) を mean_exec_time、 calls 、および rowsで集計します。 /raw はそれを直接読み取りません。ビューはクラスター全体です。そのため、プロジェクトのクエリのみを返す上記のコマンド、または Studio › データベースを使用します。

top-10bash
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 を増やす必要があります
debugsql
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 を停止させる原因#

  1. N+1 クエリ — 結合を行うか、ループではなく SDK で !inner を使用します
  2. OFFSET によるページネーション — 1000 を超える場合は、カーソルベース (where id > last_seen) を使用します
  3. SELECT * (大きなテーブルの場合) — 必要な列のみをリクエストします
  4. 長いトランザクション — これらは VACUUM をブロックし、肥大化を引き起こします。 1 秒未満を維持する
  5. インデックスのない RLS ポリシー — ポリシーで tenant_id = auth.tenant()を使用する場合、インデックス tenant_id

さらに進むには#