注釋提示

pg_hint_plan的注釋以/*+開頭，以*/結(jié)束。提示語句包括提示名和接下來括號包裹的參數(shù)，以空格作為分界。為了可讀性，每一個提示語句都可以重新?lián)Q行。

示例

HashJoin作為連接方法，并且使用序列掃描SeqScan來掃描表pgbench_accounts。

 /*+
    HashJoin(a b)
    SeqScan(a)
  */
 EXPLAIN SELECT *
    FROM pgbench_branches b
    JOIN pgbench_accounts a ON b.bid = a.bid
   ORDER BY a.aid;

返回如下結(jié)果：

                                      QUERY PLAN
---------------------------------------------------------------------------------------
 Sort  (cost=31465.84..31715.84 rows=100000 width=197)
   Sort Key: a.aid
   ->  Hash Join  (cost=1.02..4016.02 rows=100000 width=197)
         Hash Cond: (a.bid = b.bid)
         ->  Seq Scan on pgbench_accounts a  (cost=0.00..2640.00 rows=100000 width=97)
         ->  Hash  (cost=1.01..1.01 rows=1 width=100)
               ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=100)
(7 rows)

提示表

雖然可以使用注釋提示的方式對SQL語句進(jìn)行提示，但是當(dāng)SQL語句不可編輯時，這種提示方式就很不方便。對于這種情況，可以將提示放在一張?zhí)厥獾谋韍int_plan.hints中。這個表包含了下列字段。

示例命令如下：

INSERT INTO hint_plan.hints(norm_query_string, application_name, hints)
    VALUES (
        'EXPLAIN (COSTS false) SELECT * FROM t1 WHERE t1.id = ?;',
        '',
        'SeqScan(t1)'
    );
INSERT 0 1
postgres=# UPDATE hint_plan.hints
postgres-#    SET hints = 'IndexScan(t1)'
postgres-#  WHERE id = 1;
UPDATE 1
postgres=# DELETE FROM hint_plan.hints
postgres-#  WHERE id = 1;
DELETE 1

提示類型

根據(jù)提示短語影響執(zhí)行計劃的方式，可以分為如下六類：

• 掃描方法提示

  掃描方法提示對目標(biāo)表強(qiáng)制執(zhí)行特定的掃描方法。pg_hint_plan通過表格的別名（如果存在的話）來識別目標(biāo)表。掃描方法是SeqScan、IndexScan、NoSeqScan等。

  掃描提示對普通表、繼承表、無日志表、臨時表和系統(tǒng)表有效，對外部表、表函數(shù)、常量值語句、通用表達(dá)式、視圖和子查詢無效。

  示例命令如下：

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

• 連接方法提示

  連接方法提示強(qiáng)制指定相關(guān)表格聚合在一起的方法。

  連接方法提示對普通表 、繼承表、無日志表、臨時表、外部表、系統(tǒng)表、表函數(shù)、常量值命令和通用表達(dá)式有效，對視圖和子查詢無效。

• 連接順序提示

  連接順序提示指定兩個或多個表的連接順序。這里有兩種強(qiáng)制指定方法：

  • 強(qiáng)制執(zhí)行特定的連接順序，但不限制每個連接級別的方向。

  • 強(qiáng)制連接方向。

  示例命令如下：

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

• 行號糾正提示

  行號糾正提示會糾正由于計劃器限制而導(dǎo)致的行號錯誤。

  示例命令如下：

  /*+ Rows(a b #10) */ SELECT... ;     //設(shè)置連接結(jié)果的行號為10。
  /*+ Rows(a b +10) */ SELECT... ;     //行號增加10。
  /*+ Rows(a b -10) */ SELECT... ;     //行號減去10。
  /*+ Rows(a b *10) */ SELECT... ;     //將行號擴(kuò)大至原來的10倍。

• 并行執(zhí)行提示

  并行提示會指定并行的執(zhí)行計劃。

  并行執(zhí)行提示對普通表、繼承表、無日志表和系統(tǒng)表有效，對外部表、常量從句、通用表達(dá)式、視圖和子查詢無效。視圖的內(nèi)部表可以通過其真實名稱或別名指定目標(biāo)對象。

  下面兩個示例說明在每個表上執(zhí)行查詢的方式不同：

  • 方式一

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

    返回如下結(jié)果：

                                      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)

  • 方式二

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

    返回如下結(jié)果：

                                        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)

• 設(shè)置臨時GUC參數(shù)

  在計劃的時候臨時改變GUC參數(shù)。執(zhí)行計劃中的GUC參數(shù)會有預(yù)期的效果，除非提示語句與其他計劃沖突。同樣的GUC參數(shù)設(shè)置以最后一次為準(zhǔn)。

  示例命令如下：

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

所有提示支持的格式如下表。

更多pg_hint_plan的介紹請參見PostgreSQL官方文檔。