Change version to 1.2.1

1.2.0 has a crash bug raised by queries in specific shape involving
complex views and/or SQL functions. Also it can crash when using
Parallel hint.

They are fixed in this version.

Fix a bug of target query retrieval

The previous patch leaves a bug that get_query_string returns a Query
that JumbleQuery doesn't accept. This fixes that bug.

Fix a crash bug on complex views when enable_hint_table is on

The Query that planner receives sometimes irrelevant to
debug_query_string. If enable_hint_table is on, pg_hint_plan_planner
normalizes debug_query_string using query-jumble information created
from the irrelevant Query the can lead to crash. To avoid this
situation, retrieve hints in post_parse_analyze_hook, where
corresponding pairs of a query string and a parsed Query.

Follow the behavioral change of parallel execution

The behavior of parallel planning is changed until 9.6.3, let
expected/ut-W.out to follow that.

Fix a bug of Parallel hint

During manipulation on pathlist of a GatherPath, foreach was mitakenly
used for a loop using list_delete_cell. This leads to a crash with
SEGV.

Provide upgrade path from 1.1.3

pg_hint_plan96-1.2.0 has an upgrade path from 1.1.3. This adds
requires installation sql file and puts pointers to the files in
Makefile and spec file. It is the only upgrade path of pg_hint_plan
1.2.0 since it works only on PG9.6 and versions earlier than 1.1.3
don't support PG9.6.

Don't apply parallel hint on rels that planner considers unsafe.

pg_hint_plan considered had its own decision logic on whether
parallel-safe or not but it is dangerous and unnecessary. Just follow
planner's decision.

Reconsider hinting process

I rethinked the steps of enforcement considering the parallel planning
code. pg_hint_plan_set_rel_pathlist() gets simpler and easier to read
(maybe).

As the result of this patch, some behaviors has been changed.

- False generation of gahter path caused by hinting on the other side
  of joins.

- Scan hints work with Parallel hints. (It's useless for the moment,
  though).

Fix a typo of documentation.

Author: Tatsuro Yamada <yamatattsu@gmail.com>

Don't set_plain_rel_pathlist for other than RTE_RELATION.

pg_hint_plan_set_rel_pathlist can call set_plain_rel_pathlist for
relations other than RTE_RELATION and this results in a crash.

Following a fix in PG9.6.1.

PG9.6.2 gets a fix on planning that affects on the result of
ut-S. ut-S follows that by this fix. As the result ut-S won't success
for 9.6.1 or ealier after this patch.

Fix parallel hint error handling.

Some kind of error of a parallel hint resulted confusing log
output. Addition to that, due to improper assumption of .conf file,
ordinary setup of max_worker_processes caused failure of ut-W. Fixed
them.

Refactor hint application mechamism next step

I removed useless code forgotten to be removed in
add_paths_to_joinrel_wrapper by the previous refactoring. Addition to
that, find_scan_method_hint and find_parallel_hint are found not to
require the third parameter rel, so removed it. Some inadequate tests
are fixed and changed according to change of unclear behaviors.

Improve error handling of Parallel hint

Improve poor error report for Parallel hint.

Fix wrongly lowering max_parallel_workers_per_gather

Number of parallel workers of non-hinted relations is wrongly forced
to be zero even if max_parallel_workers_per_gather is more than
zero. Non-hinted relations get to have max_parallel_workes_per_gather
as set by this fix.

Refactor hint application mechamism

Before we have the new hook set_rel_pathlist_hook, plan enforcment is
performed in two steps, one works only for queries with one relation,
the other works only for joins. Now they are performed once and at
once in set_rel_pathlist_hook. As a byproduct of this refactoring,
index restriction no longer runs for indexes on constraint-excluded
relations and expected/ut-S.out changed a bit.

The major changes by this patch are the followings.

- Remove hook to get_relation_info_hook:
  The function for the hook pg_hint_plan_get_relation_info is removed.

- pg_hint_plan_join_search no longer calls rebuild_scan_path. The
  function and a copied function set_plain_rel_pathlist are removed.

- delete_indexes has been renamed to restrict_indexes, which
  represents the functionality clearer. And the function was
  refactored main for readablity.

- Added several regtests for parallel.

Fix default_version of extension control file

default_version in pg_hint_plan.control was left unchanged on updating
version number. Fixed it.

Edit copyright year

Properly change the state of parallel hints.

The state member of parallel hint is forgotten to be chaned on usage.
This fixes it.

Rename some functions and refactor code.

Some functions had a bit confusing naming and inconvenient interfaces.
Renamed such functions and refactored the code.

Change version to 1.2.0.

Change version number to 1.2.0 and prepare RPM build envoronment.

Add description of Parallel hint to documentation

Addition to that, documents are refactored.

New hint "Parallel"

Added a new feature to control parallel query execution.

Rename current_hint to current_hint_state

The name current_hint is quite confusing so change the name to less
confusing one.

Fix some syntax and comments.

Some following comma for the last element in enum definition and
incorrect comments are fixed.

Remove an unnecessary Makefile entry for tar file

Remove mistakenly copy'n-pasted description from outside in Makefile.

Edit copyright notices

Support PostgreSQL 9.6 RC1

Edited Makefile and renamed and edited RPM spec file.
Copied functions are updated and follow the changes of internal API.
Modified regressions to pass with 9.6 RC1.

Add RPM spec file forgotten in the previous commit.

Merge pull request #36272 (fujii_masao/pg_hint_plan/master into master).

Use pg_reload_conf() to reload the configuration file in regression test.

Previously the regression test ran pg_ctl reload command for that purpose.
However in the environment where the path to PostgreSQL binaries is not set,
the regression test always failed because pg_ctl could not be found.
To reload the configuration file even in that environment, this commit
changes the regression test so that it uses pg_reload_conf function, instead.

Prepare for 1.1.3/PG95.

The pg_hint_plan version of master branch is left as 1.1.2. This
commit corrects the pg_hint_plan version, and edits RPM building
environment for PostgreSQL 9.5.

Edit copyright years.

Change for new syntax items in 9.5.

Some syntactical elements are added in 9.5. This change reflects it.

Addition to that, deleted unused parts in pg_stat_statements, which
are previously invalidated with #ifdef directives.

Follow a change of error message.

Context message of PL/pgSQL is changed so this commit refrects it to
exted/pg_hint_plan.out.

Followed the changes of 9.5.0 release.

There was some changes in 9.5.0 release affect
pg_hint_plan. set_append_rel_pathlist() no longer sets cheapest path
and it became a business of the caller. So rebuild_scan_path() does
so. core.c gets changed from changing lateral join infrastracture
(acfcd45cacb6df23edba4cb3753a2be594238a99) and a change related to custom path(c2ea2285e978d9289084846a3343cef7d261d880).

Made compatible with 9.5a1

Make make_join_rel.c to catch up to REL9_5_ALPHA2.  Change regtests to
reflect some differences of PostgreSQL's behavior in such like
collapsing of simple VALUES clause, rows estimation and explain
representation of join filter.

Fixed a bug related to SQL statements in PL/pgSQL functions.

At least since 9.1, true query strings of SQL statements executed in
PL/pgSQL functions were found that were not obtained correctly by the
previous implement, it is because that PLpgSQL_stmt variable did not
have proper query string to be read for hints. Instead, it is changed
to read them from the top of error_context_stack in
pg_hint_plan_planner(). This change made a slight difference in
behavior which doesn't affect its work so a part of the regtest was
also changed. And added some regression tests for it.

Catch up the changes of pg_stat_statements.c

The change has nothing to do with pg_hint_plan but it's necessary to
catch it up in order to keep the difference minimal for the ease of
maintenance.

Set additional parameter of set_config_option().

9.5dev added new parameter to set_config_option(). This paramter
should be false in set_config_option_wrapper.

Fix regression test according to the changes of PostgreSQL.

PostgreSQL became to give WARNING for usage of hash indexes. This
change is to follow it.

Prepare for 1.1.2

Remove unnecessary tracker code from documentations.

Added English documentation.

Some fix and addition to the japaneses document.

It lacked the description about joni direction enforcement so added
it. Addition to it, added html language specification and updated
target PostgreSQL versions and OS version.

Fix regression test according to the changes of PostgreSQL.

Row countings of EXPLAIN results seems to be changed. This follows the
change.

Removed a stale comment.

Fix to remove plpgsql query string on non-local exit.

Pl/pgsql query string stored internally squatted after an execution
error then pg_hint_plan afterward read it for hints and ignores really
given ones. This commit makes it erased at the end of transaction.

Fix about unexpectedly living plpgsql query string.

pg_hint_plan forgot to erase plpgsql query strings when it is NOT a
static statement, so it continued to read hints from the remenbered
wrong query string after using dynamic execution of a statement. This
commit makes it to be erased for any types of pl/pgsql statement.

Enhance debug output.

Added new debug output levels detailed and verbose. These let you see
more verbose information about what pg_hint_plan does internally.

Revert "Add new join method hint "NestLoop_NM" which means force nested loop"

This reverts commit 7f6e3ce1326751c36676653ef1e81893296860b6.

Add new join method hint "NestLoop_NM" which means force nested loop
but inhibit materialize of the inner relation.

Fix a bug that index restriction by name doesn't work for UPDATEs on
inheritance parent.

Inheritance planner doesn't claim for the inheritance parent relation,
so pg_hint_plan_get_relation_info cannot have the chance to prepare
the index spec information for chlid relations. This change make the
function to try to find parent relation even if it is called for the
children with inhparent == false from the first.

Remove unused struct member.

RPM automation

Change verision to 1.1.1. Change target version to 9.4.

Make codes copied from PostgreSQL catch up to 9.4

Interim support for 9.4beta2. pg_stat_statements.c is replaced with the latest version. Regtests are rearranged and stabilized.

Merge branch 'master' into PG93

リグレッションテストを出力メッセージの変更に対応させた。

hint_reportの出力メッセージを大文字始まりで統一した。

コメントやメッセージを修正した。

コピーライトを更新した

Rowsで外部ファイルを扱う試験を環境に依存しないようにした。

外部ファイルのアドレスを特定の文字列に置き換えることで、環境に依存
しないようにした。

Rows関連試験の予測結果を、全試験を流した場合のものに変更した。

Rowsヒント句のメッセージ出力(R-3-6-*)の試験を追加した。

Rowsヒント句の同じテーブル組合せ(R-3-5-*)の試験を追加した。

Rowsヒント句の継承テーブル関連(R-3-4-*)の試験を追加した。

Rowsヒント句の比率指定(R-3-3-*)の試験を追加した。

Rowsヒント句の増減値指定(R-3-2-*)の試験を追加した。

Rowsヒント句の絶対値指定(R-3-1-*)の試験を追加した。

bug fix #3

R-2-4-*の試験とR-2-5-*の試験を追加した。

Rowsヒント句のRULEまたはVIEWの試験(R-2-3-*)を追加した。

バグ修正にそって試験および予想結果を修正した。

bug fix #2

件数補正のときに、全ての結合パスにおいて部分集合となってしまい、他
のRowsヒント句適用後に見積もり件数を再計算してしまった。。

理由
  Rowsヒント句に存在しないテーブル組合せを指定すると、pg_hint_plan
  内部で空のテーブル集合として扱っていたため。

Rowsヒント句の件数の書式に関する記述を事実から要請に変更した。

試験R-1-6-7の予測結果を正しい形に修正した。

1ブロックあたりのテーブル数(R-2-2-*)の試験を追加した。

ただし、不合格

複数の問合せブロックに関する試験(R-2-1-*)を追加した。

ただし、不合格

core.cの各関数をPG93向けに更新した。

マニュアルにRowsヒント句の仕様の一部と具体例を挿入した。

記入内容
・Rowsヒント句の補正の件数や倍率をstrtodで補正していること。
理由
・16進数でも指定可能なため。

Rowsヒント句の引数の条件(R-1-*)の試験を追加した。

機能試験表との試験番号のずれをなおした。

スキャン方式試験の予測結果がSQLの変更に沿っていなかったため修正した

スキャン方式試験のコメントが一部不適切だったため修正した。

スキャン方式試験の番号のずれを修正した。

Fix test numbers.

PG9.3でのコスト値の変動を反映。

PG92ブランチで追加したコメントに追従。

Rowsヒントの追加に伴いリグレッションテスト項目の予想結果を追加。

9.2版からのコピーなので、細かいコスト値は正確ではない。

PG92との差分から生成したパッチを適用。

ただし、PG9.3対応として加えた修正はそのまま残した。

Add *.o to ignore file list.

specファイル中の依存ファイル名を修正した。

RPM版インストール時の依存ファイル名に誤りがあったため

Copyrightの未更新部分を更新した。

コピーライトと一部の流用関数に更新漏れがあったため、修正した。

スキャン方式の試験番号やタイトルが不適切だったため修正した。

元のクエリの実行計画の変化に伴い、結合順序の試験の予測結果を修正した。

元のクエリの実行計画の変化に伴い、結合方式の試験の予測結果を修正した。

pg_hint_plan動作確認試験の予測結果をPG93の動作に合わせて変更した。