1. クエリ実行計画を取り込みます。  
    db01=> SET apg_plan_mgmt.capture_plan_baselines = manual;
    SET
    
  2. EXPLAINによりクエリ実行を実行し、実行計画を確認します。  
    db01=> explain (hashes true)
    db01-> SELECT Sum(delta),
    db01->            Sum(bbalance)
    db01-> FROM   pgbench_history h,
    db01->           pgbench_branches b
    db01-> WHERE  b.bid = h.bid
    db01->        AND b.bid IN ( 1, 2, 3 )
    db01->        AND mtime BETWEEN (SELECT Min(mtime)
    db01(>                           FROM   pgbench_history mn) AND (SELECT Max(mtime)
    db01(>                                                           FROM  pgbench_history mx);
                                         QUERY PLAN
    ------------------------------------------------------------------------------------
     Aggregate  (cost=164.17..164.18 rows=1 width=16)
       InitPlan 1 (returns $0)
         ->  Aggregate  (cost=53.00..53.01 rows=1 width=8)
               ->  Seq Scan on pgbench_history mn  (cost=0.00..49.00 rows=1600 width=8)
       InitPlan 2 (returns $1)
         ->  Aggregate  (cost=53.00..53.01 rows=1 width=8)
               ->  Seq Scan on pgbench_history mx  (cost=0.00..49.00 rows=1600 width=8)
       ->  Nested Loop  (cost=0.00..58.11 rows=8 width=8)
             Join Filter: (h.bid = b.bid)
             ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=8)
                   Filter: (bid = ANY ('{1,2,3}'::integer[]))
             ->  Seq Scan on pgbench_history h  (cost=0.00..57.00 rows=8 width=8)
                   Filter: ((mtime >= $0) AND (mtime <= $1))
     SQL Hash: 1561242727, Plan Hash: 764058456
    
  3. 実行計画取り込み後にクエリ実行計画の取り込みをOFFにします。  
    db01=> SET apg_plan_mgmt.capture_plan_baselines = off;
    SET
    
  4. 取得した実行計画を表示します。  
    db01=> SELECT sql_hash,
    db01->           plan_hash,
    db01->           status,
    db01->           estimated_total_cost "cost",
    db01->           sql_text
    db01-> FROM apg_plan_mgmt.dba_plans;
      sql_hash  | plan_hash |  status  |   cost    |                                       sql_text
    ------------+-----------+----------+-----------+--------------------------------------------------------------------------------------
     1561242727 | 764058456 | Approved | 164.18375 | SELECT Sum(delta),                                                                  +
                |           |          |           |            Sum(bbalance)                                                            +
                |           |          |           | FROM   pgbench_history h,                                                           +
                |           |          |           |           pgbench_branches b                                                        +
                |           |          |           | WHERE  b.bid = h.bid                                                                +
                |           |          |           |        AND b.bid IN ( 1, 2, 3 )                                                     +
                |           |          |           |        AND mtime BETWEEN (SELECT Min(mtime)                                         +
                |           |          |           |                           FROM   pgbench_history mn) AND (SELECT Max(mtime)         +
                |           |          |           |                                                           FROM  pgbench_history mx);
    
  5. QPMで取り込んだ承認済み実行計画を使用する設定に変更します。  
    db01=> SET apg_plan_mgmt.use_plan_baselines = true;
    SET
    
  6. EXPLAINによりクエリ実行を実行し、QPMで固定化した実行計画が採用されていることを確認します。  
    db01=> explain (hashes true)
    db01-> SELECT Sum(delta),
    db01->            Sum(bbalance)
    db01-> FROM   pgbench_history h,
    db01->           pgbench_branches b
    db01-> WHERE  b.bid = h.bid
    db01->        AND b.bid IN ( 1, 2, 3 )
    db01->        AND mtime BETWEEN (SELECT Min(mtime)
    db01(>                           FROM   pgbench_history mn) AND (SELECT Max(mtime)
    db01(>                                                           FROM  pgbench_history mx);
                                         QUERY PLAN
    ------------------------------------------------------------------------------------
     Aggregate  (cost=164.17..164.18 rows=1 width=16)
       InitPlan 1 (returns $0)
         ->  Aggregate  (cost=53.00..53.01 rows=1 width=8)
               ->  Seq Scan on pgbench_history mn  (cost=0.00..49.00 rows=1600 width=8)
       InitPlan 2 (returns $1)
         ->  Aggregate  (cost=53.00..53.01 rows=1 width=8)
               ->  Seq Scan on pgbench_history mx  (cost=0.00..49.00 rows=1600 width=8)
       ->  Nested Loop  (cost=0.00..58.11 rows=8 width=8)
             Join Filter: (h.bid = b.bid)
             ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=8)
                   Filter: (bid = ANY ('{1,2,3}'::integer[]))
             ->  Seq Scan on pgbench_history h  (cost=0.00..57.00 rows=8 width=8)
                   Filter: ((mtime >= $0) AND (mtime <= $1))
     SQL Hash: 1561242727, Plan Hash: 764058456
    
  7. 新しい計画を生成するために、pgbench_historyテーブルの「mtime」列に新しいインデックスを作成します。  
    db01=> create index pgbench_hist_mtime on pgbench_history(mtime);
    CREATE INDEX
    
  8. EXPLAINによりクエリ実行を実行し、QPM が新しい計画を検出した場合でも、承認した実行計画を維持していることを確認します。  
    db01=> explain (hashes true)
    db01-> SELECT Sum(delta),
    db01->            Sum(bbalance)
    db01-> FROM   pgbench_history h,
    db01->           pgbench_branches b
    db01-> WHERE  b.bid = h.bid
    db01->        AND b.bid IN ( 1, 2, 3 )
    db01->        AND mtime BETWEEN (SELECT Min(mtime)
    db01(>                           FROM   pgbench_history mn) AND (SELECT Max(mtime)
    db01(>                                                           FROM  pgbench_history mx);
                                         QUERY PLAN
    ------------------------------------------------------------------------------------
     Aggregate  (cost=164.17..164.18 rows=1 width=16)
       InitPlan 1 (returns $0)
         ->  Aggregate  (cost=53.00..53.01 rows=1 width=8)
               ->  Seq Scan on pgbench_history mn  (cost=0.00..49.00 rows=1600 width=8)
       InitPlan 2 (returns $1)
         ->  Aggregate  (cost=53.00..53.01 rows=1 width=8)
               ->  Seq Scan on pgbench_history mx  (cost=0.00..49.00 rows=1600 width=8)
       ->  Nested Loop  (cost=0.00..58.11 rows=8 width=8)
             Join Filter: (h.bid = b.bid)
             ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=8)
                   Filter: (bid = ANY ('{1,2,3}'::integer[]))
             ->  Seq Scan on pgbench_history h  (cost=0.00..57.00 rows=8 width=8)
                   Filter: ((mtime >= $0) AND (mtime <= $1))
     Note: An Approved plan was used instead of the minimum cost plan.
     SQL Hash: 1561242727, Plan Hash: 764058456, Minimum Cost Plan Hash: -433405076
    
  9. 取得した実行計画を表示し、コストの低い実行計画が作成されているが、8. において承認された実行計画が採用されていることを確認します。  
    db01=> SELECT sql_hash,
    db01->           plan_hash,
    db01->           status,
    db01->           estimated_total_cost "cost",
    db01->           sql_text
    db01-> FROM apg_plan_mgmt.dba_plans;
      sql_hash  | plan_hash  |   status   |       cost       |                                       sql_text
    ------------+------------+------------+------------------+--------------------------------------------------------------------------------------
     1561242727 |  764058456 | Approved   |        164.18375 | SELECT Sum(delta),                                                                  +
                |            |            |                  |            Sum(bbalance)                                                            +
                |            |            |                  | FROM   pgbench_history h,                                                           +
                |            |            |                  |           pgbench_branches b                                                        +
                |            |            |                  | WHERE  b.bid = h.bid                                                                +
                |            |            |                  |        AND b.bid IN ( 1, 2, 3 )                                                     +
                |            |            |                  |        AND mtime BETWEEN (SELECT Min(mtime)                                         +
                |            |            |                  |                           FROM   pgbench_history mn) AND (SELECT Max(mtime)         +
                |            |            |                  |                                                           FROM  pgbench_history mx);
     1561242727 | -433405076 | Unapproved | 6.37206636451638 | SELECT Sum(delta),                                                                  +
                |            |            |                  |            Sum(bbalance)                                                            +
                |            |            |                  | FROM   pgbench_history h,                                                           +
                |            |            |                  |           pgbench_branches b                                                        +
                |            |            |                  | WHERE  b.bid = h.bid                                                                +
                |            |            |                  |        AND b.bid IN ( 1, 2, 3 )                                                     +
                |            |            |                  |        AND mtime BETWEEN (SELECT Min(mtime)                                         +
                |            |            |                  |                           FROM   pgbench_history mn) AND (SELECT Max(mtime)         +
                |            |            |                  |                                                           FROM  pgbench_history mx);
    
  10. コストの低い実行計画を承認  
    db01=> SELECT apg_plan_mgmt.set_plan_status (1561242727, '-433405076', 'Approved');
     set_plan_status
    -----------------
    0
    (1 row)
    
  11. 確認  
    db01=> SELECT sql_hash,
              plan_hash,
              status,
              estimated_total_cost "cost",
              sql_text
    FROM apg_plan_mgmt.dba_plans;
      sql_hash  | plan_hash  |  status  |   cost    |                                                                             sql_text
    ------------+------------+----------+-----------+------------------------------------------------------------------------------------------------------------------------------------------------------------------
     1561242727 |  764058456 | Approved | 164.18375 | SELECT Sum(delta),                                                                                                                                              +
                |            |          |           |            Sum(bbalance)                                                                                                                                        +
                |            |          |           | FROM   pgbench_history h,                                                                                                                                       +
                |            |          |           |           pgbench_branches b                                                                                                                                    +
                |            |          |           | WHERE  b.bid = h.bid                                                                                                                                            +
                |            |          |           |        AND b.bid IN ( 1, 2, 3 )                                                                                                                                 +
                |            |          |           |        AND mtime BETWEEN (SELECT Min(mtime)                                                                                                                     +
                |            |          |           |                           FROM   pgbench_history mn) AND (SELECT Max(mtime)                                                                                     +
                |            |          |           |                                                           FROM  pgbench_history mx);
     1561242727 | -433405076 | Approved |      6.37 | SELECT Sum(delta),                                                                                                                                              +
                |            |          |           |            Sum(bbalance)                                                                                                                                        +
                |            |          |           | FROM   pgbench_history h,                                                                                                                                       +
                |            |          |           |           pgbench_branches b                                                                                                                                    +
                |            |          |           | WHERE  b.bid = h.bid                                                                                                                                            +
                |            |          |           |        AND b.bid IN ( 1, 2, 3 )                                                                                                                                 +
                |            |          |           |        AND mtime BETWEEN (SELECT Min(mtime)                                                                                                                     +
                |            |          |           |                           FROM   pgbench_history mn) AND (SELECT Max(mtime)                                                                                     +
                |            |          |           |                                                           FROM  pgbench_history mx);
    (2 rows)
    
  12. クエリ実行  
    db01=> explain (hashes true)
    db01-> SELECT Sum(delta),
    db01->            Sum(bbalance)
    db01-> FROM   pgbench_history h,
    db01->           pgbench_branches b
    db01-> WHERE  b.bid = h.bid
    db01->        AND b.bid IN ( 1, 2, 3 )
    db01->        AND mtime BETWEEN (SELECT Min(mtime)
    db01(>                           FROM   pgbench_history mn) AND (SELECT Max(mtime)
    db01(>                                                           FROM  pgbench_history mx);
                                                                 QUERY PLAN
    -------------------------------------------------------------------------------------------------------------------------------------
     Aggregate  (cost=6.36..6.37 rows=1 width=16)
       InitPlan 2 (returns $1)
         ->  Result  (cost=0.30..0.31 rows=1 width=8)
               InitPlan 1 (returns $0)
                 ->  Limit  (cost=0.28..0.30 rows=1 width=8)
                       ->  Index Only Scan using pgbench_hist_mtime on pgbench_history mn  (cost=0.28..35.98 rows=1600 width=8)
                             Index Cond: (mtime IS NOT NULL)
       InitPlan 4 (returns $3)
         ->  Result  (cost=0.30..0.31 rows=1 width=8)
               InitPlan 3 (returns $2)
                 ->  Limit  (cost=0.28..0.30 rows=1 width=8)
                       ->  Index Only Scan Backward using pgbench_hist_mtime on pgbench_history mx  (cost=0.28..35.98 rows=1600 width=8)
                             Index Cond: (mtime IS NOT NULL)
       ->  Nested Loop  (cost=0.28..5.70 rows=8 width=8)
             Join Filter: (h.bid = b.bid)
             ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=8)
                   Filter: (bid = ANY ('{1,2,3}'::integer[]))
             ->  Index Scan using pgbench_hist_mtime on pgbench_history h  (cost=0.28..4.59 rows=8 width=8)
                   Index Cond: ((mtime >= $1) AND (mtime <= $3))
     SQL Hash: 1561242727, Plan Hash: -433405076
    (20 rows)

  1. クエリ実行計画の取り込みをOFFにします。  
    db01=> SET apg_plan_mgmt.capture_plan_baselines = off;
    SET
    
  2. クエリを実行します。  
    db01=> EXPLAIN (hashes true)
    db01-> SELECT
    db01->    *
    db01-> FROM
    db01->    pgbench_branches b
    db01->    JOIN
    db01->       pgbench_accounts a
    db01->       ON b.bid = a.bid
    db01-> ORDER BY
    db01->    a.aid;
                                                        QUERY PLAN
    ------------------------------------------------------------------------------------------------------------------
     Nested Loop  (cost=0.59..785331.41 rows=9964671 width=461)
       ->  Index Scan using pgbench_accounts_pkey on pgbench_accounts a  (cost=0.43..537663.60 rows=9964671 width=97)
       ->  Memoize  (cost=0.15..0.17 rows=1 width=364)
             Cache Key: a.bid
             Cache Mode: logical
             ->  Index Scan using pgbench_branches_pkey on pgbench_branches b  (cost=0.14..0.16 rows=1 width=364)
                   Index Cond: (bid = a.bid)
     SQL Hash: 356104612, Plan Hash: 2119829930
    
  3. 実行計画の取り込みむ設定に変更します。  
    db01=> SET apg_plan_mgmt.capture_plan_baselines = manual;
    SET
    
  4. ヒント句による実行計画の固定を行います。  
    db01=> /*+ HashJoin(a b) */  EXPLAIN (hashes true)
    db01-> SELECT
    db01->    *
    db01-> FROM
    db01->    pgbench_branches b
    db01->    JOIN
    db01->       pgbench_accounts a
    db01->       ON b.bid = a.bid
    db01-> ORDER BY
    db01->    a.aid;
    WARNING:  transaction left non-empty SPI stack
    HINT:  Check for missing "SPI_finish" calls.
                                                   QUERY PLAN
    ---------------------------------------------------------------------------------------------------------
     Gather Merge  (cost=2359260.50..3328115.55 rows=8303892 width=461)
       Workers Planned: 2
       ->  Sort  (cost=2358260.48..2368640.34 rows=4151946 width=461)
             Sort Key: a.aid
             ->  Hash Join  (cost=3.25..380752.47 rows=4151946 width=461)
                   Hash Cond: (a.bid = b.bid)
                   ->  Parallel Seq Scan on pgbench_accounts a  (cost=0.00..369388.46 rows=4151946 width=97)
                   ->  Hash  (cost=2.00..2.00 rows=100 width=364)
                         ->  Seq Scan on pgbench_branches b  (cost=0.00..2.00 rows=100 width=364)
     Note: This is not an Approved plan.  No usable Approved plan was found.
     SQL Hash: 356104612, Plan Hash: -58126597
    
  5. 取得した実行計画を表示します。  
    db01=> SELECT sql_hash,
           plan_hash,
           status,
           enabled,
           sql_text
    FROM   apg_plan_mgmt.dba_plans
     Where plan_hash='-58126597';
     sql_hash  | plan_hash |   status   | enabled |         sql_text
    -----------+-----------+------------+---------+---------------------------
     356104612 | -58126597 | Unapproved | t       | SELECT                   +
               |           |            |         |    *                     +
               |           |            |         | FROM                     +
               |           |            |         |    pgbench_branches b    +
               |           |            |         |    JOIN                  +
               |           |            |         |       pgbench_accounts a +
               |           |            |         |       ON b.bid = a.bid   +
               |           |            |         | ORDER BY                 +
               |           |            |         |    a.aid;
    
  6. 同じSQL HASHの別の実行計画を除外し、ヒント句を用いた実行計画を承認します。  
    db01=> SELECT apg_plan_mgmt.set_plan_status (sql_hash, plan_hash, 'Rejected') from apg_plan_mgmt.dba_plans where sql_hash = 356104612;
     set_plan_status
    -----------------
                   0
                   0
    db01=> SELECT apg_plan_mgmt.set_plan_status (356104612, '-58126597', 'Approved');
     set_plan_status
    -----------------
                   0
    
  7. 実行計画の取り込みをOFFにし、QPMで取り込んだ承認済み実行計画を使用する設定に変更します。  
    db01=> SET apg_plan_mgmt.capture_plan_baselines = off;
    SET
    db01=> SET apg_plan_mgmt.use_plan_baselines = true;
    SET
    
  8. ヒント句なしでクエリを実行しても、ヒント句で指定した実行計画が採用されていることを確認します。  
    db01=> EXPLAIN (hashes true)
    db01-> SELECT
    db01->    *
    db01-> FROM
    db01->    pgbench_branches b
    db01->    JOIN
    db01->       pgbench_accounts a
    db01->       ON b.bid = a.bid
    db01-> ORDER BY
    db01->    a.aid;
                                                   QUERY PLAN
    ---------------------------------------------------------------------------------------------------------
     Gather Merge  (cost=2359260.50..3328115.55 rows=8303892 width=461)
       Workers Planned: 2
       ->  Sort  (cost=2358260.48..2368640.34 rows=4151946 width=461)
             Sort Key: a.aid
             ->  Hash Join  (cost=3.25..380752.47 rows=4151946 width=461)
                   Hash Cond: (a.bid = b.bid)
                   ->  Parallel Seq Scan on pgbench_accounts a  (cost=0.00..369388.46 rows=4151946 width=97)
                   ->  Hash  (cost=2.00..2.00 rows=100 width=364)
                         ->  Seq Scan on pgbench_branches b  (cost=0.00..2.00 rows=100 width=364)
     Note: An Approved plan was used instead of the minimum cost plan.
     SQL Hash: 356104612, Plan Hash: -58126597, Minimum Cost Plan Hash: 2119829930
    
  9. もともと取り込まれていた実行計画が採用されず、ヒント句で指定した実行計画が承認されています。  
    db01=> SELECT sql_hash,
           plan_hash,
           status,
           enabled,
           sql_text
    FROM   apg_plan_mgmt.dba_plans
     Where sql_hash=356104612;
     sql_hash  | plan_hash  |  status  | enabled |         sql_text
    -----------+------------+----------+---------+---------------------------
     356104612 |  -58126597 | Approved | t       | SELECT                   +
               |            |          |         |    *                     +
               |            |          |         | FROM                     +
               |            |          |         |    pgbench_branches b    +
               |            |          |         |    JOIN                  +
               |            |          |         |       pgbench_accounts a +
               |            |          |         |       ON b.bid = a.bid   +
               |            |          |         | ORDER BY                 +
               |            |          |         |    a.aid;
     356104612 | 2119829930 | Rejected | t       | SELECT                   +
               |            |          |         |    *                     +
               |            |          |         | FROM                     +
               |            |          |         |    pgbench_branches b    +
               |            |          |         |    JOIN                  +
               |            |          |         |       pgbench_accounts a +
               |            |          |         |       ON b.bid = a.bid   +
               |            |          |         | ORDER BY                 +
               |            |          |         |    a.aid;