PolarDB:pg_hint_plan

スキャン方式ヒント

スキャン方式ヒントは、存在する場合はエイリアスによって識別される対象テーブルに対して特定のスキャン方式を強制します。

有効な対象：標準テーブル、継承テーブル、非ログテーブル、一時テーブル、システムテーブル

無効な対象：外部テーブル、テーブル関数、定数値ステートメント、共通テーブル式（CTE）、ビュー、サブクエリ

/*+
    SeqScan(t1)
    IndexScan(t2 t2_pkey)
 */
SELECT * FROM table1 t1 JOIN table2 t2 ON (t1.key = t2.key);

結合方式ヒント

結合方式ヒントは、一連のテーブルに対して特定の結合アルゴリズムを強制します。

有効な対象：標準テーブル、継承テーブル、非ログテーブル、一時テーブル、外部テーブル、システムテーブル、テーブル関数、定数値コマンド、CTE

無効な対象：ビュー、サブクエリ

結合順序ヒント

結合順序ヒントは、テーブルが結合される順序を指定します。2 種類の構文形式がサポートされています。

• Leading(t1 t2 t3) — 結合順序のみを指定し、各レベルでの方向を制約しません。

• Leading((t1 t2) t3) — 順序と方向の両方を指定します（ネストされた括弧は結合ペアを示します）。

/*+
    NestLoop(t1 t2)
    MergeJoin(t1 t2 t3)
    Leading(t1 t2 t3)
  */
SELECT * FROM table1 t1
    JOIN table2 t2 ON (t1.key = t2.key)
    JOIN table3 t3 ON (t2.key = t3.key);

この例では、以下のとおりです。

• NestLoop(t1 t2) — t1 と t2 の間でネステッドループ結合を使用します。

• MergeJoin(t1 t2 t3) — (t1, t2) の結合結果と t3 の間でマージ結合を使用します。

• Leading(t1 t2 t3) — 3 つのテーブルを t1 → t2 → t3 の順で結合します。

行数補正ヒント

行数補正ヒントは、結合結果に対してオプティマイザーが使用する行数推定値を上書きします。これは、オプティマイザーの統計情報が不正確な場合に有効です。

/*+ Rows(a b #10) */ SELECT ...; -- 結合結果を正確に 10 行に設定
/*+ Rows(a b +10) */ SELECT ...; -- 推定行数に 10 を加算
/*+ Rows(a b -10) */ SELECT ...; -- 推定行数から 10 を減算
/*+ Rows(a b *10) */ SELECT ...; -- 推定行数を 10 倍に設定

並列実行ヒント

並列実行ヒントは、クエリの並列処理の次数を制御します。

有効な対象：標準テーブル、継承テーブル、非ログテーブル、システムテーブル。ビューの内部テーブルは、実際の名前またはエイリアスで指定できます。

無効な対象：外部テーブル、定数句、CTE、ビュー、サブクエリ

例 1：結合における 2 つのテーブルの並列処理を設定します。

EXPLAIN /*+ Parallel(c1 3 hard) Parallel(c2 5 hard) */
       SELECT c2.a FROM c1 JOIN c2 ON (c1.a = c2.a);

出力：

QUERY PLAN
-------------------------------------------------------------------------------
 Hash Join  (cost=2.86..11406.38 rows=101 width=4)
   Hash Cond: (c1.a = c2.a)
   ->  Gather  (cost=0.00..7652.13 rows=1000101 width=4)
         Workers Planned: 3
         ->  Parallel Seq Scan on c1  (cost=0.00..7652.13 rows=322613 width=4)
   ->  Hash  (cost=1.59..1.59 rows=101 width=4)
         ->  Gather  (cost=0.00..1.59 rows=101 width=4)
               Workers Planned: 5
               ->  Parallel Seq Scan on c2  (cost=0.00..1.59 rows=59 width=4)

例 2：単一テーブル集約の並列処理を設定します。

EXPLAIN /*+ Parallel(tl 5 hard) */ SELECT sum(a) FROM tl;

出力：

QUERY PLAN
-----------------------------------------------------------------------------------
 Finalize Aggregate  (cost=693.02..693.03 rows=1 width=8)
   ->  Gather  (cost=693.00..693.01 rows=5 width=8)
         Workers Planned: 5
         ->  Partial Aggregate  (cost=693.00..693.01 rows=1 width=8)
               ->  Parallel Seq Scan on tl  (cost=0.00..643.00 rows=20000 width=4)

GUC パラメーター ヒント

GUC パラメーター ヒントは、クエリプラン生成時のみ GUC パラメーターの値を変更します。この変更は他のステートメントには影響しません。同一の GUC パラメーターが複数回出現した場合、最後に指定された値が有効になります。

/*+ Set(random_page_cost 2.0) */
SELECT * FROM table1 t1 WHERE key = 'value';