doc/pg_hint_plan-ja.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD html 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <html lang="ja">
   3 <head>
   4 <title>pg_hint_plan</title>
   5 <!-- Uncoment after the tool has been hosted somewhere.
   6 <link rel="home" title="pg_hint_plan" href="index.html">
   7 -->
   8 <link rel="stylesheet" type="text/css" href="style.css">
   9 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  10 </head>
  11
  12 <body>
  13 <h1 id="pg_hint_plan">pg_hint_plan 1.1.0</h1>
  14 <div class="navigation">
  15   <a href="pg_hint_plan-ja.html">pg_hint_plan</a>
  16 </div>
  17 <hr>
  18
  19 <div class="index">
  20 <ol>
  21 <li><a href="#name">名前</a></li>
  22 <li><a href="#synopsis">概要</a></li>
  23 <li><a href="#description">機能説明</a>
  24 <li><a href="#install">インストール</a></li>
  25 <li><a href="#uninstall">アンインストール</a></li>
  26 <li><a href="#restrictions">使用上の注意と制約</a></li>
  27 <li><a href="#requirement">動作環境</a></li>
  28 <li><a href="#seealso">関連項目</a></li>
  29 <li><a href="hint_list-ja.html">Appendix A. ヒント句一覧</a></li>
  30 </div>
  31
  32 <h2 id="name">名前</h2>
  33 <p>pg_hint_plan -- 実行計画を示すヒントをクエリに指定することで、SQL文やGUCパラメータを変えずに実行計画を制御します。</p>
  34
  35 <h2 id="synopsis">概要</h2>
  36 <p>PostgreSQLのプランナははコストベースでのオプティマイズを行なっており、SQL文と統計情報を元に可能な実行計画のコストを見積もり、最もコストの低い実行計画を選択します。プランナは可能な限りよい実行計画を作成しようとしますが、例えばカラム間の相関関係などは考慮しないため、複雑なクエリでは常に最適なプランを選択するとは限りません。</p>
  37 <p>pg_hint_planを用いると、ヒントでスキャン方式や結合方式を指定することで、SQL文やGUCパラメータを変更することなく実行計画を制御することができます。</p>
  38
  39 <h2 id="description">機能説明</h2>
  40 <p>pg_hint_planの機能について説明するにあたり、まず文中で使用されている用語について説明します。</p>
  41 <table>
  42 <thead>
  43 <tr>
  44 <tr><th>用語</th><th>説明</th></tr>
  45 </tr></thead>
  46 <tbody>
  47 <tr><td>ヒント句</td>
  48   <td>実行計画を制御するための情報です。</td></tr>
  49   <tr><td>ヒント</td>
  50   <td>実行計画を制御したいクエリに適用するヒント句を列挙したものです。</td></tr>
  51 </tbody>
  52 </table>
  53
  54 <h3 id="hint-rule">ヒントの指定方法</h3>
  55 <p>ヒントは二つの方法で指定することができます。</p>
  56 <ul>
  57 <li>コメントでの指定</li>
  58 <p>特殊なSQLブロックコメント内にヒントを記述します。</p>
  59 <li>テーブルでの指定</li>
  60 <p>ヒント用のテーブルにヒントを登録します。</p>
  61 </ul>
  62 <p>特定のアプリケーションではヒントをコメントで指定することができないため、「テーブルでの指定」でヒントを指定します。なお、「コメントでの指定」と異なり、アプリケーションのソースコードに手を入れずに指定するヒントを変更することができます。</p>
  63
  64 <h4 id="hint-comment">コメントでの指定</h4>
  65 <p>指定したいヒントを、実行計画を制御したいクエリの先頭または途中のSQLブロックコメントの中に記述します。</p>
  66 <p>ヒント用コメントと通常のコメントを区別するために、ヒント用のブロックコメントは「<span class="bold">/*+</span>」で始めます。ヒントの対象は、カッコ内にオブジェクト名または別名で指定します。オブジェクト名は、スペース、タブ、または改行のいずれかで区切って指定します。</p>
  67 <p>以下の例では、HashJoinとSeqScanヒント句により、pgbench_accountsテーブルに対するSeq Scanの結果をHash Joinする実行計画が選択されています。なおかつ、Setヒント句によりこのクエリの実行計画を作成する間だけrandom_page_costが2.0に変更されています。</p>
  68 <pre>
  69 postgres=# EXPLAIN (VERBOSE, COSTS)
  70 postgres-# /*+
  71 postgres*#     SeqScan(a)
  72 postgres*#     HashJoin(a b)
  73 postgres*#     Set(random_page_cost 2.0)
  74 postgres*#  */
  75 postgres-# SELECT *
  76 postgres-#   FROM pgbench_accounts a
  77 postgres-#   JOIN pgbench_branches b
  78 postgres-#     ON a.bid = b.bid
  79 postgres-#  ORDER BY a.aid
  80 postgres-#  LIMIT 10;
  81                                              QUERY PLAN
  82 ----------------------------------------------------------------------------------------------------
  83  Limit  (cost=6176.99..6177.01 rows=10 width=461)
  84    Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
  85    ->  Sort  (cost=6176.99..6426.99 rows=100000 width=461)
  86          Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
  87          Sort Key: a.aid
  88          ->  <span class="strong">Hash Join</span>  (cost=1.02..4016.02 rows=100000 width=461)
  89                Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
  90                Hash Cond: (a.bid = b.bid)
  91                ->  <span class="strong">Seq Scan on public.pgbench_accounts a</span>  (cost=0.00..2640.00 rows=100000 width=97)
  92                      Output: a.aid, a.bid, a.abalance, a.filler
  93                ->  Hash  (cost=1.01..1.01 rows=1 width=364)
  94                      Output: b.bid, b.bbalance, b.filler
  95                      ->  Seq Scan on public.pgbench_branches b  (cost=0.00..1.01 rows=1 width=364)
  96                            Output: b.bid, b.bbalance, b.filler
  97 (14 rows)
  98
  99 postgres=#
 100 </pre>
 101
 102 <h4 id="hint-table">テーブルでの指定</h4>
 103 <p>指定したいヒントを、実行計画を制御したいクエリと併せてヒント用のテーブルに登録します。</p>
 104 <p>デフォルトでは無効なので、テーブルで指定したヒントは適用されません。そのため、ヒントをテーブルで指定する場合は、<a href="#hint-GUC">pg_hint_planのGUCパラメータ</a>pg_hint_plan.enable_hint_tableの設定を変更します。</p>
 105 <p>ヒント用のテーブルは「<span class="bold">hint_plan.hints</span>」です。hint_plan.hintsテーブルには、以下の情報を登録します。</p>
 106 <table>
 107 <thead>
 108 <tr>
 109 <tr><th>列名</th><th>説明</th></tr>
 110 </tr></thead>
 111 <tbody>
 112 <tr><td>id</td>
 113   <td>ユーザがヒントを識別するための番号です。連番型ですので、新しいヒントを登録するときにはこの列を指定しないでください。</td></tr>
 114 <tr><td>norm_query_string</td>
 115   <td>実行計画を制御したいクエリを指定します。対象のクエリに定数があるときは、下記の例のように「?」に置き換えます。キーワード間の空白の数が、登録するクエリと実行するクエリで異なると別のSQL文として扱われます。</td></tr>
 116 <tr><td>application_name</td>
 117   <td>ヒント適用対象のアプリケーション名を指定します。下記の例では「psql」から実行されたクエリのみがヒント適用対象となります。全てのアプリケーションにヒントを適用したいときは、空文字列を登録します。アプリケーション名は、セッションの「application_name」GUCパラメータと等しいか判断します。</td></tr>
 118 <tr><td>hints</td>
 119   <td>ヒントを指定します。ヒント以外のもの（SQLコメントなど）を含めないでください。</td></tr>
 120 </tbody>
 121 </table>
 122 <p>ヒントの登録情報を変更する場合は、変更したい登録情報のidを指定して登録情報を更新してください。</br>
 123 ヒントの登録を解除する場合は、解除したい登録情報のidを指定してテーブルから削除してください。</p>
 124 <p>以下の例では、ヒントの登録、ヒント登録情報の変更、ヒントの解除の順に、クエリの実行結果を示しています。
 125 </p>
 126 <pre>
 127 postgres=# INSERT INTO hint_plan.hints(norm_query_string, application_name, hints)
 128 postgres-#     VALUES (
 129 postgres(#         'EXPLAIN (COSTS false) SELECT * FROM t1 WHERE t1.id = ?;',
 130 postgres(#         '',
 131 postgres(#         'SeqScan(t1)'
 132 postgres(#     );
 133 INSERT 0 1
 134 postgres=# UPDATE hint_plan.hints
 135 postgres-#    SET hints = 'IndexScan(t1)'
 136 postgres-#  WHERE id = 1;
 137 UPDATE 1
 138 postgres=# DELETE FROM hint_plan.hints
 139 postgres-#  WHERE id = 1;
 140 DELETE 1
 141 postgres=#
 142 </pre>
 143 <p>なお、ヒントの登録や変更や解除はスーパーユーザでのみ可能です。一般ユーザでヒントの登録や変更や解除を実施したい場合は、スーパーユーザから一般ユーザにhint_plan.hintsテーブルの各権限を付与してください。</p>
 144 <p>以下の例では、hint_plan.hintsテーブルに対してINSERT権限を持たない一般ユーザがヒントの登録を実施しようとしたときの結果を示しています。</p>
 145 <pre>
 146 postgres=> INSERT INTO hint_plan.hints(norm_query_string, application_name, hints)
 147 postgres->     VALUES (
 148 postgres(>         'EXPLAIN (COSTS false) SELECT * FROM t1 WHERE t1.id = ?;',
 149 postgres(>         '',
 150 postgres(>         'SeqScan(t1)'
 151 postgres(>     );
 152 ERROR:  permission denied for relation hints
 153 postgres=>
 154 </pre>
 155 <p>以下の例では、テーブルに登録した「コメントでの指定」の例と同じヒントと、登録したクエリの実行結果を示しています。</p>
 156 <pre>
 157 postgres=# SELECT * FROM hint_plan.hints;
 158  id |     norm_query_string      | application_name |                      hints
 159 ----+----------------------------+------------------+--------------------------------------------------
 160   1 | EXPLAIN (VERBOSE, COSTS)  +| psql             | SeqScan(a)HashJoin(a b)Set(random_page_cost 2.0)
 161     |  SELECT *                 +|                  |
 162     |    FROM pgbench_accounts a+|                  |
 163     |    JOIN pgbench_branches b+|                  |
 164     |      ON a.bid = b.bid     +|                  |
 165     |   ORDER BY a.aid          +|                  |
 166     |   LIMIT ?;                +|                  |
 167     |                            |                  |
 168 ...
 169
 170 postgres=# SET pg_hint_plan.enable_hint_table TO on;
 171 postgres=# EXPLAIN (VERBOSE, COSTS)
 172 postgres-# SELECT *
 173 postgres-#   FROM pgbench_accounts a
 174 postgres-#   JOIN pgbench_branches b
 175 postgres-#     ON a.bid = b.bid
 176 postgres-#  ORDER BY a.aid
 177 postgres-#  LIMIT 10;
 178                                              QUERY PLAN
 179 ----------------------------------------------------------------------------------------------------
 180  Limit  (cost=6176.99..6177.01 rows=10 width=461)
 181    Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
 182    ->  Sort  (cost=6176.99..6426.99 rows=100000 width=461)
 183          Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
 184          Sort Key: a.aid
 185          ->  <span class="strong">Hash Join</span>  (cost=1.02..4016.02 rows=100000 width=461)
 186                Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
 187                Hash Cond: (a.bid = b.bid)
 188                ->  <span class="strong">Seq Scan on public.pgbench_accounts a</span>  (cost=0.00..2640.00 rows=100000 width=97)
 189                      Output: a.aid, a.bid, a.abalance, a.filler
 190                ->  Hash  (cost=1.01..1.01 rows=1 width=364)
 191                      Output: b.bid, b.bbalance, b.filler
 192                      ->  Seq Scan on public.pgbench_branches b  (cost=0.00..1.01 rows=1 width=364)
 193                            Output: b.bid, b.bbalance, b.filler
 194 (14 rows)
 195
 196 postgres=#
 197 </pre>
 198
 199 <div class="tips">
 200 <span class="strong">指定方法の優先度</span>
 201 <p>ヒントをコメントとテーブルの両方で指定した場合、テーブルで指定したヒントが適用され、コメントで指定したヒントは無視されます。</p>
 202 <p>以下の例では、コメントでヒントを指定して実行計画を制御しているクエリに対して、テーブルに空文字列のヒントを登録しています。テーブルで指定したヒントが優先されるので、コメントで指定したヒントを取り消すことができます。</p>
 203 <pre>
 204 postgres=# select * from hint_plan.hints;
 205  id |             norm_query_string              | application_name | hints
 206 ----+--------------------------------------------+------------------+-------
 207   1 | EXPLAIN (VERBOSE, COSTS)                  +| psql             |
 208     | /*+                                       +|                  |
 209     |     HashJoin(a b)                         +|                  |
 210     |     SeqScan(a)                            +|                  |
 211     |  */                                       +|                  |
 212     | SELECT *                                  +|                  |
 213     |   FROM pgbench_accounts a                 +|                  |
 214     |   JOIN pgbench_branches b ON a.bid = b.bid+|                  |
 215     |  ORDER BY a.aid;                           |                  |
 216 ...
 217
 218 postgres=# EXPLAIN (VERBOSE, COSTS)
 219 postgres-# /*+
 220 postgres*#     HashJoin(a b)
 221 postgres*#     SeqScan(a)
 222 postgres*#  */
 223 postgres-# SELECT *
 224 postgres-#   FROM pgbench_accounts a
 225 postgres-#   JOIN pgbench_branches b ON a.bid = b.bid
 226 postgres-#  ORDER BY a.aid;
 227                                                       QUERY PLAN
 228 ----------------------------------------------------------------------------------------------------------------------
 229  <span class="strong">Nested Loop</span>  (cost=0.00..5750.47 rows=100000 width=461)
 230    Output: a.aid, a.bid, a.abalance, a.filler, b.bid, b.bbalance, b.filler, a.aid
 231    Join Filter: (a.bid = b.bid)
 232    ->  <span class="strong">Index Scan using pgbench_accounts_pkey on public.pgbench_accounts a</span>  (cost=0.00..4249.45 rows=100000 width=97)
 233          Output: a.aid, a.bid, a.abalance, a.filler
 234    ->  Materialize  (cost=0.00..1.01 rows=1 width=364)
 235          Output: b.bid, b.bbalance, b.filler
 236          ->  Seq Scan on public.pgbench_branches b  (cost=0.00..1.01 rows=1 width=364)
 237                Output: b.bid, b.bbalance, b.filler
 238 (9 rows)
 239 </pre>
 240 </div>
 241
 242 <h3 id="hint-group">ヒント句のグループ</h3>
 243 <p>pg_hint_planで使えるヒント句の種類は、スキャン方式と結合方式、結合順序、見積もり件数補正、GUCパラメータの5グループです。各グループの具体的なヒント句は、<a href="hint_list-ja.html">ヒント句一覧</a>を参照してください。</p>
 244
 245 <h4>スキャン方式</h4>
 246 <p>あるオブジェクトでどのスキャン方式を選択するかを指定できるヒント句のグループです。「SeqScan」や「IndexScan」などを含みます。</p>
 247 <p>スキャン方式を指定できるオブジェクトは、通常のテーブル、継承テーブル、UNLOGGEDテーブル、一時テーブル、システムカタログです。スキャン方式を指定できないオブジェクトは、外部テーブル、テーブル関数、VALUESコマンド結果、CTE(共通テーブル式)、ビュー、副問い合わせ結果です。</p>
 248 <p>特定のオブジェクトについてあるスキャン方式を選択して欲しい場合は、そのスキャン方式のヒント句と、対象となるオブジェクトの名前を指定します。逆に、特定のオブジェクトについてあるスキャン方式を選択して欲しくない場合は、Noで始まるヒント句を指定します。同じオブジェクトに対して複数のスキャン方式のヒント句を指定した場合は、最後に指定したヒント句が適用されます。</p>
 249
 250 <h4>結合方式</h4>
 251 <p>あるオブジェクトの組み合わせでどの結合方式を選択するかを指定できるヒント句のグループです。「MergeJoin」や「NestLoop」などを含みます。</p>
 252 <p>結合方式を指定できるオブジェクトは、通常のテーブル、継承テーブル、UNLOGGEDテーブル、一時テーブル、外部テーブル、システムカタログ、テーブル関数、VALUESコマンド結果、CTE(共通テーブル式)です。結合方式を指定できないオブジェクトは、ビュー、副問い合わせ結果です。</p>
 253 <p>特定のオブジェクトの組み合わせについてある結合方式を選択して欲しい場合は、その結合方式のヒント句と、対象となる2つ以上のオブジェクトの名前を指定します。逆に、特定のオブジェクトの組み合わせについてある結合方式を選択して欲しくない場合は、Noで始まるヒント句を指定します。同じオブジェクトの組み合わせに対して複数の結合方式のヒント句を指定した場合は、最後に指定したヒント句が適用されます。</p>
 254
 255 <h4>結合順序</h4>
 256 <p>あるオブジェクトの組み合わせでどのような順番で結合するかを指定できるヒント句のグループです。「Leading」のみを含みます。</p>
 257 <p>結合順序を指定できるオブジェクトは結合方式と同じです。</p>
 258 <p>先に結合して欲しいオブジェクトから順にオブジェクト名または別名を指定します。同じ問合せブロックのオブジェクトに対して複数の結合順序のヒント句を指定した場合は、最後に指定したヒント句が適用されます。 </p>
 259 <div class="tips">
 260 <span class="strong"></span>
 261 <p>結合対象のテーブルが3つ以上ある場合、結合方式のヒント句を指定したとしてもコスト見積もりによっては対象のテーブルが直接結合されないことがあります。対象のテーブルが直接結合されない場合は、結合順序のヒント句を併せて指定します。</p>
 262 <p>以下の例では、table1とtable2を直接結合する場合はNested Loopを、table1とtable2とtable3を結合する場合はMerge Joinを指定しています。また、コスト見積もりによってはtable1とtable2が直接結合されない場合を避けるため、table1とtable2を結合してからtable3を結合するようにLeadingヒント句を併用しています。</p>
 263 <pre>
 264 postgres=# /*+
 265 postgres*#     NestLoop(t1 t2)
 266 postgres*#     MergeJoin(t1 t2 t3)
 267 postgres*#     Leading(t1 t2 t3)
 268 postgres*#  */
 269 postgres-# SELECT * FROM table1 t1
 270 postgres-#     JOIN table table2 t2 ON (t1.key = t2.key)
 271 postgres-#     JOIN table table3 t3 ON (t2.key = t3.key);
 272 ...
 273 </pre>
 274 </div>
 275 <h4>結合方向</h4>
 276 <p>上記の結合順序の指定を行なった際にはプランナの都合により結合方向(外部表/内部表もしくは駆動表/被駆動表の別)が期待とは異なるものになる場合があります。このような状況に対して結合方向を固定したい場合はもうひとつの書式を使う必要があります。</p>
 277 <pre>
 278 postgres=# /*+ Leading((t1 (t2 t3))) */ SELECT...
 279 </pre>
 280 <p>この書式では2つの要素を丸括弧で囲ったものがネストする形になっており、一つの括弧内では1つ目の要素が外部/駆動表、2番めの要素が内部/被駆動表として結合されます。</p>
 281 <h4>見積もり件数補正</h4>
 282 <p>あるオブジェクトの結合結果の件数を補正できるヒント句のグループです。「Rows」のみを含みます。</p>
 283 <p>見積もり件数補正対象として指定できるオブジェクトは結合方式と同じです。補正できるのは結合結果の見積もり件数だけで、スキャンの見積もり件数を補正することはできません。</p>
 284 <p>以下の例では、テーブルaとテーブルbの結合結果の件数を、ヒント句で指定した値に補正しています。</p>
 285 <pre>
 286 postgres=# /*+ Rows(a b #10) */
 287 postgres-# EXPLAIN SELECT *
 288 postgres-#    FROM pgbench_branches b
 289 postgres-#    JOIN pgbench_accounts a ON b.bid = a.bid
 290 postgres-#   WHERE aid &lt; 20
 291 postgres-#   ORDER BY a.aid;
 292                                                QUERY PLAN
 293 --------------------------------------------------------------------------------------------------------
 294  Nested Loop  (cost=0.29..9.92 rows=<span class="strong">10</span> width=461)
 295    Join Filter: (b.bid = a.bid)
 296    ->  Index Scan using pgbench_accounts_pkey on pgbench_accounts a  (cost=0.29. .8.62 rows=19 width=97)
 297          Index Cond: (aid &lt; 20)
 298    ->  Materialize  (cost=0.00..1.01 rows=1 width=364)
 299          ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=364)
 300 (6 行)
 301 </pre>
 302
 303 <h4>GUCパラメータ</h4>
 304 <p>そのクエリの実行計画を作成している間だけGUCパラメータを変更できるヒント句のグループです。「Set」のみを含みます。</p>
 305 <p>設定したいGUCパラメータとそのパラメータの値を指定します。指定できるGUCパラメータは<a href="http://www.postgresql.jp/document/current/html/runtime-config-query.html">問い合わせ計画</a>のGUCパラメータのみです。同じGUCパラメータのヒント句を2回以上指定した場合は、最後に指定したヒント句が適用されます。</p>
 306 <div class="tips">
 307 <span class="strong">Setヒント句の制限</span>
 308 <p>Setヒント句に問い合わせ計画のGUCパラメータ以外を指定した場合の動作は保証できません。問い合わせ計画以外のGUCパラメータを指定した場合の例の一つとして、<a href="#hint-GUC">pg_hint_planのGUCパラメータ</a>を指定した場合の動作を、以下に示します。<p>
 309 <ul>
 310 <li>pg_hint_plan.enable_hint、pg_hint_plan.enable_hint_tableをSetヒント句の対象に指定した場合は、無効になります。なお、pg_hint_plan.debug_printをonに設定していると、そのヒント句はログ出力で「適用されたヒント句」として出力されます。</li>
 311 <li>pg_hint_plan.debug_printをSetヒント句の対象に指定した場合は、指定したとおりに適用されます。</li>
 312 <li>pg_hint_plan.parse_messagesをSetヒント句の対象に指定した場合は、構文エラーと一部のSetヒント句のエラーのメッセージはクエリ開始時の設定レベルで出力され、それ以外のメッセージはSetヒント句で指定したレベルで出力されます。</li>
 313 </ul>
 314 </div>
 315
 316 <h3 id="hint-GUC">pg_hint_planのGUCパラメータ</h3>
 317 <p>pg_hint_planの動作を制御するGUCパラメータを以下に記述します。</p>
 318 <table>
 319 <thead>
 320 <tr>
 321 <tr><th>GUCパラメータ</th><th>説明</th><th>デフォルト値</th></tr>
 322 </tr></thead>
 323 <tbody>
 324 <tr><td>pg_hint_plan.enable_hint</td>
 325   <td>pg_hint_planの機能を有効または無効にします。</td><td>on</td></tr>
 326 <tr><td>pg_hint_plan.enable_hint_table</td>
 327   <td>ヒントをテーブルで指定する機能を有効または無効にします。</td><td>off</td></tr>
 328 <tr><td>pg_hint_plan.debug_print</td>
 329   <td>指定したヒントが実行計画生成にどのように影響したかを出力します。メッセージはLOGメッセージレベルで出力されますので、デフォルトではサーバログに出力され、クライアントには渡されません。</td><td>off</td></tr>
 330 <tr><td>pg_hint_plan.parse_messages</td>
 331   <td>指定したヒントを解釈できなかった場合に、どのメッセージ階層でログを出力するかを指定します。有効な値は、debug5、debug4、debug3、debug2、debug1、log、info、notice、warning、またはerrorです。fatalとpanicは指定できません。</td><td>info</td></tr>
 332
 333 </tbody>
 334 </table>
 335 <p>
 336 PostgreSQL 9.1の環境でこれらのパラメータをpostgresql.confファイルで設定するには、<a href="http://www.postgresql.jp/document/9.1/html/runtime-config-custom.html#GUC-CUSTOM-VARIABLE-CLASSES">custom_variable_classes</a>にpg_hint_planを加える必要があります。
 337 典型的な使用例は以下のようになります。
 338 </p>
 339 <pre>
 340 # postgresql.conf
 341 shared_preload_libraries = 'pg_hint_plan'
 342
 343 custom_variable_classes = 'pg_hint_plan'    # 9.2以降は廃止されたため記述不要
 344 pg_hint_plan.parse_messages = 'debug2'
 345 </pre>
 346 <p>
 347 PostgreSQL 9.2以降ではcustom_variable_classesは廃止されているため、pg_hint_planのGUCパラメータを標準のGUCパラメータと同様に記述することができます。
 348 </p>
 349
 350 <h2 id="install">インストール</h2>
 351 <p>pg_hint_planのインストール方法について説明します。</p>
 352
 353 <h3 id="build">ビルド</h3>
 354 <p>pg_hint_planをソースコードからビルドする場合、pg_hint_planのソースを展開したディレクトリでmake → make installの順に実行します。make installはPostgreSQLをインストールしたOSユーザで実行します。なお、pg_hint_planのビルドにはpgxsを使用するので、RPM版のPostgreSQLを使用している環境では、postgresql-devel パッケージが必要です。</p>
 355 <p>以下にビルドの例を示します。</p>
 356 <pre>
 357 $ tar xzvf pg_hint_plan-1.0.0.tar.gz
 358 $ cd pg_hint_plan-1.0.0
 359 $ make
 360 $ su
 361 # make install
 362 </pre>
 363
 364 <h3 id="create-extension">データベースへの登録</h3>
 365 <p>pg_hint_planはPostgreSQLの拡張(EXTENSION)を使用しているので、pg_hint_planを利用するデータベースにスーパーユーザもしくはそのデータベースの所有者で接続してCREATE EXTENSIONコマンドを実行します。</p>
 366 <p>以下にデータベースへの登録の例を示します。 <i>dbname</i>は対象となるデータベース名を意味します。</p>
 367 <pre>
 368 $ psql -d <i>dbname</i> -c "CREATE EXTENSION pg_hint_plan"
 369 </pre>
 370
 371 <h3 id="hint-load">pg_hint_planのロード</h3>
 372 <p>特定のセッションでのみpg_hint_planを使う場合は、以下の例のようにpg_hint_planの共有ライブラリをLOADコマンドでロードします。一般ユーザで利用する場合は$libdir/pluginsにもインストールする必要があるので注意してください。
 373 <pre>
 374 postgres=# LOAD 'pg_hint_plan';
 375 LOAD
 376 postgres=# </pre></p>
 377 <p>全てのセッションでpg_hint_planを有効にするには、shared_preload_libraries GUCパラメータに'pg_hint_plan'を追加してからサーバを再起動します。</p>
 378 <p>注意: pg_hint_planを<a href="#create-extension">データベースに登録</a>せずに、ロード後にSQL文を実行すると以下に示す例のようなエラーとなります。 pg_hint_planを使うときは、データベースへの登録を忘れないように注意してください。</p>
 379 <pre>
 380 postgres=# EXPLAIN SELECT * FROM pgbench_accounts a WHERE aid = 1;
 381 ERROR:  schema "hint_plan" does not exist
 382 LINE 1: SELECT hints   FROM hint_plan.hints  WHERE norm_query_string...
 383                             ^
 384 QUERY:  SELECT hints   FROM hint_plan.hints  WHERE norm_query_string = $1    AND ( application_name = $2     OR application_name = '' )  ORDER BY application_name DESC
 385 postgres=#
 386 </pre>
 387
 388 <h2 id="uninstall">アンインストール</h2>
 389 <p>pg_hint_planをアンインストールするときは、以下の手順を実行します。 <i>dbname</i>は対象となるデータベース名を意味します。</p>
 390 <ol>
 391 <li>pg_hint_planのソースを展開したディレクトリでmake uninstallを実行します。make uninstallはPostgreSQLをインストールしたOSユーザで実行します。</li>
 392 <pre>
 393 $ cd pg_hint_plan-1.0.0
 394 $ su
 395 # make uninstall
 396 </pre>
 397 <li>pg_hint_planを登録したデータベースにスーパーユーザもしくはそのデータベースの所有者で接続して、DROP EXTENSIONコマンドおよびDROP SCHEMAコマンドを実行します。</li>
 398 <pre>
 399 $ psql -d <i>dbname</i> -c "DROP EXTENSION pg_hint_plan"
 400 $ psql -d <i>dbname</i> -c "DROP SCHEMA hint_plan"
 401 </pre>
 402 </ol>
 403
 404 <h2 id="restrictions">使用上の注意と制約</h2>
 405 <p>pg_hint_planを使用する際には、以下の注意と制約があります。</p>
 406 <h3>ヒントの指定方法</h3>
 407 <dl>
 408 <dt>コメント指定でのヒント記述位置</dt>
 409 <dd>ヒントはクエリの先頭または途中に記述できます。ただし、ヒントをクエリの途中に記述する場合、ヒント用のブロックコメントより前に以下の文字<span class="strong">以外</span>が含まれると、「/*+」で始まるコメントでもヒントと見なされず無視されます。
 410 <ul>
 411 <li>空白文字（半角スペース、水平/垂直タブ、改行、フォームフィード、復帰）</li>
 412 <li>アルファベット（大文字/小文字）</li>
 413 <li>数字</li>
 414 <li>アンダースコア</li>
 415 <li>カンマ</li>
 416 <li>開き括弧（(）、閉じ括弧（)）</li>
 417 </ul>
 418 <p>指定したヒントが無視される例を以下に示します。</p>
 419 <ol>
 420 <li>二重引用符（"）がヒント用のブロックコメントより前に含まれている場合</li>
 421 <pre>
 422 postgres=# SELECT bid AS "BID"
 423 postgres-# /*+
 424 postgres*#     SeqScan(b)
 425 postgres*#  */
 426 postgres-#   FROM pgbench_branches b;
 427 ...
 428 </pre>
 429 <li>演算子（>=）がヒント用のブロックコメントより前に含まれている場合</li>
 430 <pre>
 431 postgres=# WITH avg_aid AS (
 432 postgres(#    SELECT avg(aid) FROM pgbench_history h
 433 postgres(#     WHERE delta >= 0
 434 postgres(# )
 435 postgres-# /*+
 436 postgres*#     SeqScan(h)
 437 postgres*#  */
 438 postgres-# SELECT * FROM avg_aid;
 439 ...
 440 </pre>
 441 </ol>
 442 一つのクエリに複数のブロックコメントを記述する場合は、最初のブロックコメントにのみヒントを記述してください。二番目以降のブロックコメントは、ヒントと見なされず無視されます。以下の例では、HashJoin(a b)とSeqScan(a)がヒントと見なされ、IndexScan(a)とMergeJoin(a b)は無視されています。</p>
 443 <pre>
 444 postgres=# /*+
 445 postgres*#     <span class="strong">HashJoin(a b)</span>
 446 postgres*#     <span class="strong">SeqScan(a)</span>
 447 postgres*#  */
 448 postgres-# /*+ IndexScan(a) */
 449 postgres-# EXPLAIN SELECT /*+ MergeJoin(a b) */ *
 450 postgres-#    FROM pgbench_branches b
 451 postgres-#    JOIN pgbench_accounts a ON b.bid = a.bid
 452 postgres-#   ORDER BY a.aid;
 453                                       QUERY PLAN
 454 ---------------------------------------------------------------------------------------
 455  Sort  (cost=31465.84..31715.84 rows=100000 width=197)
 456    Sort Key: a.aid
 457    ->  <span class="strong">Hash Join</span>  (cost=1.02..4016.02 rows=100000 width=197)
 458          Hash Cond: (a.bid = b.bid)
 459          ->  <span class="strong">Seq Scan on pgbench_accounts a</span>  (cost=0.00..2640.00 rows=100000 width=97)
 460          ->  Hash  (cost=1.01..1.01 rows=1 width=100)
 461                ->  Seq Scan on pgbench_branches b  (cost=0.00..1.01 rows=1 width=100)
 462 (7 rows)
 463
 464 postgres=# </pre>
 465 </dd>
 466 <dt>PL/pgSQL中の個別のクエリに対するヒント</dt>
 467 <dd>ヒントは、PL/pgSQLブロック中の各クエリにも指定できます。ただし、以下のような制約があります。
 468 <ul>
 469 <li>指定したヒントが適用されるSQLは以下の通りです。他のSQLにヒントを指定しても適用されません。
 470 <ul>
 471 <li>1行の結果を返す問い合わせ文(SELECT/INSERT/UPDATE/DELETE)</li>
 472 <li>複数行の結果を返す問い合わせ文(RETURN QUERY)</li>
 473 <li>動的SQL文(EXECUTE)</li>
 474 <li>カーソルを開く文(OPEN)</li>
 475 <li>問い合わせの結果を用いる繰り返し文(FOR)</li>
 476 </ul>
 477 </li>
 478 <li>ヒントをコメントで指定する場合は、SELECTなどのSQLキーワードより後に指定してください。ただし、動的SQL文にヒントをコメントで指定しても、そのヒントは適用されません。</li>
 479 </ul>
 480 <p>以下の例では、一つ目のクエリにNoIndexScanを、二つ目のクエリにSeqScanをそれぞれ指定しています。</p>
 481 <pre>
 482 postgres=# CREATE FUNCTION hints_func(integer) RETURNS integer AS $$
 483 postgres$# DECLARE
 484 postgres$#     id  integer;
 485 postgres$#     cnt integer;
 486 postgres$# BEGIN
 487 postgres$#     SELECT /*+<span class="strong">NoIndexScan(a)</span>*/ aid
 488 postgres$#         INTO id FROM pgbench_accounts a WHERE aid = $1;
 489 postgres$#     SELECT /*+<span class="strong">SeqScan(a)</span>*/ count(*)
 490 postgres$#         INTO cnt FROM pgbench_accounts a;
 491 postgres$#     RETURN id + cnt;
 492 postgres$# END;
 493 postgres$# $$ LANGUAGE plpgsql;
 494 </pre>
 495 </dd>
 496 <dt>オブジェクト名の引用符付け</dt>
 497 <dd>ヒントに記述するオブジェクト名や別名が括弧（(、)のいずれか）、二重引用符（"）、空白（スペース、タブ、改行のいずれか）を含む場合は、通常のSQL文で使う場合と同じように二重引用符(")で囲んでください。二重引用符を含むオブジェクト名は、全体を二重引用符で括ったうえで、内部に含む二重引用符を二重引用符でエスケープしてください(例: 「quoted"table"name」→「"quoted""table""name"」)。</dd>
 498 <dt>同一名称テーブルの区別</dt>
 499 <dd>スキーマ違いや同一テーブルの複数回使用などでクエリ中に同一名称のテーブルが複数回出現する場合は、テーブルに別名をつけてそれぞれのテーブルを区別してください。以下の例の1つ目のSQL文では、HashJoin(t1 t1)をヒントに指定したとき、ヒント句対象のオブジェクトが特定できずにエラーになっています。2つ目のSQL文では、各テーブルにptやstという別名をつけているため、実行計画作成時にヒントで指定した通りにHash Joinを選択しています。</p>
 500 <pre>
 501 postgres=# /*+ <span class="strong">HashJoin(t1 t1)</span>*/
 502 postgres-# EXPLAIN SELECT * FROM s1.t1
 503 postgres-# JOIN public.t1 ON (s1.t1.id=public.t1.id);
 504 INFO:  hint syntax error at or near "HashJoin(t1 t1)"
 505 <span class="strong">DETAIL:  Relation name "t1" is ambiguous.</span>
 506                             QUERY PLAN
 507 ------------------------------------------------------------------
 508  Merge Join  (cost=337.49..781.49 rows=28800 width=8)
 509    Merge Cond: (s1.t1.id = public.t1.id)
 510    ->  Sort  (cost=168.75..174.75 rows=2400 width=4)
 511          Sort Key: s1.t1.id
 512          ->  Seq Scan on t1  (cost=0.00..34.00 rows=2400 width=4)
 513    ->  Sort  (cost=168.75..174.75 rows=2400 width=4)
 514          Sort Key: public.t1.id
 515          ->  Seq Scan on t1  (cost=0.00..34.00 rows=2400 width=4)
 516 (8 行)
 517
 518 postgres=# /*+ <span class="strong">HashJoin(pt st)</span> */
 519 postgres-# EXPLAIN SELECT * FROM s1.t1 st
 520 postgres-# JOIN public.t1 pt ON (st.id=pt.id);
 521                              QUERY PLAN
 522 ---------------------------------------------------------------------
 523  <span class="strong">Hash Join</span>  (cost=64.00..1112.00 rows=28800 width=8)
 524    Hash Cond: (st.id = pt.id)
 525    ->  Seq Scan on t1 st  (cost=0.00..34.00 rows=2400 width=4)
 526    ->  Hash  (cost=34.00..34.00 rows=2400 width=4)
 527          ->  Seq Scan on t1 pt  (cost=0.00..34.00 rows=2400 width=4)
 528 (5 行)
 529
 530 postgres=#</pre>
 531 </p>
 532 </dd>
 533 <dt>FROM句にVALUESコマンドを指定した場合の制限</dt>
 534 <dd>FROM句にVALUESコマンドを指定した場合は、ヒント句のオブジェクト名に「*VALUES*」を指定してください。これは、VALUESの結果に別名を指定しても、PostgreSQL本体側で「*VALUES*」に名称が置き換えられるためです。複数のVALUESを使用する場合、この動作によりヒント句の対象を特定できません。よって、実行計画を制御できません。
 535 <pre>
 536 postgres=# /*+ <span class="strong">MergeJoin(a *VALUES*)</span> */
 537 postgres-# EXPLAIN SELECT *
 538 postgres-#    FROM pgbench_accounts a
 539 postgres-#    JOIN (VALUES (1,1),(2,2)) <span class="strong">v</span> (vid, vbalance) ON a.aid = v.vid
 540 postgres-#   ORDER BY a.aid;
 541                                                   QUERY PLAN
 542 ---------------------------------------------------------------------------------------------------------------
 543  <span class="strong">Merge Join</span>  (cost=0.04..4497.33 rows=2 width=105)
 544    Merge Cond: (a.aid = "*VALUES*".column1)
 545    ->  Index Scan using pgbench_accounts_pkey on pgbench_accounts a  (cost=0.00..4247.26 rows=100000 width=97)
 546    ->  Sort  (cost=0.04..0.04 rows=2 width=8)
 547          Sort Key: "*VALUES*".column1
 548          ->  Values Scan on <span class="strong">"*VALUES*"</span>  (cost=0.00..0.03 rows=2 width=8)
 549 (6 行)
 550
 551 postgres=#
 552 </pre>
 553 </dd>
 554 </dl>
 555
 556 <h3>ヒントの適用対象の指定</h3>
 557 <dl>
 558 <dt>クエリに明記されていないテーブルへのヒント句適用</dt>
 559 <dd>ヒント句で指定した名称と一致すれば、ビュー定義や関数内クエリなどに出現するテーブルについても、ヒントを指定したクエリ内と同じようにヒント句が適用されます。このため、ヒント句の適用有無や適用するヒント句をそれぞれのテーブルで変えたい場合は、それぞれ異なる別名を指定してください。</br>
 560 以下の例では、ビュー定義で使われている「t1」という別名をSeqScanヒント句で指定したことで、表スキャンとビュー経由のスキャンの両方でSeq Scanが選択されています。ビュー定義で使用されている「t1」とは別の別名を実表に指定することで、個別にスキャン方式を制御できます。
 561 <pre>
 562 postgres=# CREATE VIEW view1 AS SELECT * FROM table1 <span class="strong">t1</span>;
 563 CREATE TABLE
 564 postgres=# /*+ SeqScan(<span class="strong">t1</span>) */
 565 postgres=# EXPLAIN SELECT * FROM table1 <span class="strong">t1</span> JOIN view1 t2 ON (t1.key = t2.key) WHERE t2.key = 1;
 566                            QUERY PLAN
 567 -----------------------------------------------------------------
 568  Nested Loop  (cost=0.00..358.01 rows=1 width=16)
 569    ->  Seq Scan on table1 <span class="strong">t1</span>  (cost=0.00..179.00 rows=1 width=8)
 570          Filter: (key = 1)
 571    ->  Seq Scan on table1 <span class="strong">t1</span>  (cost=0.00..179.00 rows=1 width=8)
 572          Filter: (key = 1)
 573 (5 rows)
 574
 575 postgres=# /*+ SeqScan(<span class="strong">t3</span>) */
 576 postgres=# EXPLAIN SELECT * FROM table1 <span class="strong">t3</span> JOIN view1 t2 ON (t1.key = t2.key) WHERE t2.key = 1;
 577                                    QUERY PLAN
 578 --------------------------------------------------------------------------------
 579  Nested Loop  (cost=0.00..187.29 rows=1 width=16)
 580    ->  Seq Scan on table1 <span class="strong">t3</span>  (cost=0.00..179.00 rows=1 width=8)
 581          Filter: (key = 1)
 582    ->  Index Scan using foo_pkey on table1 t1  (cost=0.00..8.28 rows=1 width=8)
 583          Index Cond: (key = 1)
 584 (5 rows)
 585
 586 </pre>
 587 </dd>
 588 <dt>継承テーブルに対するヒント句</dt>
 589 <dd>継承テーブルにスキャン方式のヒント句を指定する場合は、オブジェクト名として親テーブルの名称または別名を指定してください。全ての子テーブルに同じスキャン方式を選択します。子テーブルごとに別のスキャン方式を指定することはできません。</dd>
 590 <dt>ビューやルールを使うクエリのヒント</dt>
 591 <dd>ルールを定義したテーブルやビューを複数用いるときに、各ビュー内のテーブルの別名やルール書き換え後のクエリのテーブルの別名が重複した場合は、ヒント句の対象を区別できません。区別する場合は、各ビュー内のテーブルの別名やルール書き換え後のクエリのテーブルの別名を重複させないでください。</dd>
 592 <dt>ルールを使うクエリでのヒントの適用範囲</dt>
 593 <dd>ルールによるクエリ書き換えによってクエリが複数になる場合は、書き換え前のクエリで指定したヒントが全てのクエリで使用されます。ルール内のクエリにヒントを記述しても、そのヒントは適用されません。</dd>
 594 <dt>マルチステートメントでのヒントの適用範囲</dt>
 595 <dd>クエリをマルチステートメントで実行する場合は、ヒントの指定方法によって以下のように注意点が異なります。
 596 <dl>
 597 <dt>コメントでの指定</dt>
 598 <dd>1つ目のクエリで指定したヒントが全てのクエリで使用されます。2つ目以降のクエリに指定したヒントは無視されます。</dd>
 599 <dt>テーブルでの指定</dt>
 600 <dd>ヒントを指定したいクエリの定数部分を？に置き換えてから、全てのクエリを一つにまとめてヒント用テーブルに登録します。ただし、複数の動的クエリをマルチステートメントで実行する場合には対応していません。</dd>
 601 </dl>
 602 </dd>
 603 <dt>副問い合わせ結果をヒントに指定する方法</dt>
 604 <dd>以下の副問い合わせの結果をヒントに指定する場合は、ヒント句のオブジェクト名に「ANY_subquery」を指定してください。
 605 <ul>
 606 <li>IN (SELECT ... { LIMIT | OFFSET 等} ... )</li>
 607 <li>ANY (SELECT ... { LIMIT | OFFSET 等} ...)</li>
 608 <li>SOME (SELECT ... { LIMIT | OFFSET 等} ...)</li>
 609 </ul>
 610 PostgreSQLは、実行計画を生成するときに副問い合わせを上位の問合せに併合することがあります。しかし、上記のような副問い合わせの場合には併合せず、これらの副問い合わせの結果に内部的に「ANY_subquery」という固定名をつけます。以下の例では、その固定名を指定したヒント句の効果でHash Joinを選択しています。
 611 <pre>
 612 postgres=# /*+HashJoin(a1 ANY_subquery)*/
 613 postgres=# EXPLAIN SELECT *
 614 postgres=#    FROM pgbench_accounts a1
 615 postgres=#   WHERE aid IN (SELECT bid FROM pgbench_accounts a2 LIMIT 10);
 616                                          QUERY PLAN
 617
 618 ---------------------------------------------------------------------------------------------
 619  Hash Semi Join  (cost=0.49..2903.00 rows=1 width=97)
 620    Hash Cond: (a1.aid = a2.bid)
 621    ->  Seq Scan on pgbench_accounts a1  (cost=0.00..2640.00 rows=100000 width=97)
 622    ->  Hash  (cost=0.36..0.36 rows=10 width=4)
 623          ->  Limit  (cost=0.00..0.26 rows=10 width=4)
 624                ->  Seq Scan on pgbench_accounts a2  (cost=0.00..2640.00 rows=100000 width=4)
 625 (6 rows)
 626
 627 postgres=#
 628 </pre>
 629 一つのクエリで上記のような副問い合わせを複数使用している場合は、「ANY_subquery」と指定しても対象を特定できないため、ヒント句はエラーとなり無視されます。</br>
 630 </dd>
 631 <dt>IndexOnlyScanヒント句の指定(PostgreSQL 9.2以降)</dt>
 632 <dd>ヒント句の対象となるテーブルにIndex Only Scanが可能なインデックスとIndex Only Scanが不可能なインデックスが存在する場合、Index Only Scanが可能なインデックスをテーブルと併せてIndexOnlyScanヒント句に指定しないとIndex Scanが選択されることがあります。</dd>
 633 <dt>NoIndexScanヒント句の注意点(PostgreSQL 9.2以降)</dt>
 634 <dd>PostgreSQL 9.2以降でNoIndexScanヒント句を指定した場合は、Index ScanだけでなくIndex Only Scanも選択されません。</dd>
 635 </dl>
 636
 637 <h3>ヒント指定エラーの扱い</h3>
 638 <dt>構文エラー</dt>
 639 <dd>ヒント句の記述に構文上の誤りがあった場合、pg_hint_planは誤った記述より前のヒント句のみ有効とし、誤った記述以降のヒント句を無視してクエリを実行します。誤りの内容はpg_hint_plan.parse_messagesで指定したレベルでサーバログに記録されます。
 640 <ul>
 641 <li>ヒント句名を間違っている。</li>
 642 <li>オブジェクト指定を正しく括弧で囲っていない。</li>
 643 <li>オブジェクト名を空白で区切っていない。</li>
 644 </ul>
 645 </dd>
 646 <dt>オブジェクト指定エラー</dt>
 647 <dd>pg_hint_planは、ヒント句対象のオブジェクト指定に誤りがあった場合、pg_hint_planは不正なヒント句のみを無視し、それ以外のヒント句を使ってクエリを実行します。誤りの内容はpg_hint_plan.parse_messagesで指定したレベルでサーバログに記録されます。誤ったオブジェクト指定の例を以下に示します。
 648 <ul>
 649 <li>クエリ中に同じ名称のテーブル名または別名のテーブルがあり、それに対してヒント句を指定した。</li>
 650 <li>結合方式や結合順序のヒント句に同じオブジェクト名を複数回指定した。</li>
 651 </ul>
 652 </dd>
 653 <div class="tips">
 654 <span class="strong">構文エラーとオブジェクト指定エラーが同時に起こった場合</span>
 655 <p>構文エラーより前のヒント句の中から、オブジェクト指定エラーでないヒント句を適用します。</p>
 656 </div><br>
 657 <dt>指定するヒント句の種類の重複</dt>
 658 <dd>同じオブジェクトに対して同じグループのヒント句を重複して指定した場合は、各グループで最後に指定したヒント句を使用します。</dd>
 659 <dt>ネストしたブロックコメント</dt>
 660 <dd>pg_hint_planでは、ヒントを指定したブロックコメントにネストしたブロックコメントを含めることができません。ネストしたブロックコメントを含めた場合は、誤った記述に関する情報を出力しますがエラー終了しません。ヒントを無視してクエリを実行します。</dd>
 661 <dt>メッセージの出力レベル</dt>
 662 <dd>ヒントに誤りがあった場合に出力されるメッセージのレベルは、基本的にはpg_hint_plan.parse_messagesに指定したレベルです。ただし、ヒント句に指定したオブジェクトの長さが識別子の最大長(デフォルトでは63バイト)を超えた際に切り詰めた場合は、NOTICEで出力します。</dd>
 663
 664 <h3>機能制限</h3>
 665 <dt>標準のGUCパラメータの影響</dt>
 666 <dd>FROMリストの数がfrom_collapse_limitの設定値以上の場合、またはFROMリストの数がjoin_collapse_limitの設定値より大きい場合は、結合順序のヒント句が無視されます。また、FROMリストの数がgeqo_thresholdの設定値以上の場合は、結合順序のヒント句、および結合方式のヒント句が無視されます。ヒント句が使われるようにするには、これらのGUCパラメータの値を大きくしてください。</dd>
 667 <dt>ヒント句で制御できないケース</dt>
 668 <dd>pg_hint_planでは、PostgreSQLのプランナが候補としてあげる事ができない実行計画をヒント句に指定しても、その実行計画を生成することはできません。PostgreSQLのプランナが候補としてあげる事ができない実行計画の例を以下に示します。
 669 <ul>
 670 <li>FULL OUTER JOINではNested Loopは、プランナが実行計画の候補として扱いません。</li>
 671 <li>WHERE句やJOIN条件などに指定していない列のみを含むインデックスは、プランナが実行計画の候補として扱いません。</li>
 672 <li>検索条件にctidを指定しない場合はTid Scanは、プランナが実行計画の候補として扱いません。</li>
 673 </ul>
 674 </dd>
 675 <dt>ECPGにおける制限</dt>
 676 <dd>ECPGで実装したアプリケーションから発行するクエリにヒントをコメントで指定した場合、実行計画を制御できません。これは、CプリプロセッサがCコードに変換するタイミングで、全てのブロックコメントを取り除いてしまうためです。ただし、C言語文字列に格納したクエリをEXECUTEコマンドで実行する動的SQLの場合は、コメントでヒントを指定しても実行計画を制御できます。</dd>
 677 <dt>ヒントによるフィンガープリントの変化</dt>
 678 <dd>SQLコメントでヒントを指定した場合、SQL文フィンガープリントベースのクエリキャッシュなどでは、ヒントが異なれば別のSQL文として扱われます。pg_stat_statementも9.1では別クエリとして集計しますが、9.2ではクエリ集約機能によりコメントが除去されるので、コメントで指定したヒントのみが異なるクエリは同じクエリとして扱われます。</dd>
 679
 680 </dl>
 681
 682 <h2 id="requirement">動作環境</h2>
 683 <dl>
 684 <dt>PostgreSQL</dt>
 685   <dd>バージョン 9.1, 9.2, 9.3, 9.4</dd>
 686 <dt>動作確認済みOS</dt>
 687   <dd>RHEL 6.5</dd>
 688 </dl>
 689
 690 <h2 id="seealso">関連項目</h2>
 691 <h3 id="postgresql_document">PostgreSQLドキュメント</h3>
 692 <a href="http://www.postgresql.jp/document/current/html/sql-explain.html">EXPLAIN</a>
 693 <a href="http://www.postgresql.jp/document/current/html/sql-set.html">SET</a>
 694 <a href="http://www.postgresql.jp/document/current/html/runtime-config.html">サーバの設定</a>
 695 <hr>
 696
 697 <div class="navigation">
 698   <a href="pg_hint_plan-ja.html">pg_hint_plan</a>
 699 </div>
 700
 701 <p class="footer">Copyright (c) 2012-2014, NIPPON TELEGRAPH AND TELEPHONE CORPORATION</p>
 702
 703 <!--
 704 <script type="text/javascript">
 705 var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 706 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
 707 </script><script src="pg_statsinfo-ja_files/ga.js" type="text/javascript"></script>
 708 <script type="text/javascript">
 709 try{
 710 var pageTracker = _gat._getTracker("UA-10244036-6");
 711 pageTracker._trackPageview();
 712 } catch(err) {}
 713 </script>
 714 -->
 715 </body>
 716 </html>