pg_hint_plan - en to ja translation catalogue (36 entries)

en: The hint table
ja: ヒントテーブル

en: Hints are described in a comment in a special form in the above section. This is inconvenient in the case where queries cannot be edited. In the case hints can be placed in a special table named `"hint_plan.hints"`. The table consists of the following columns.
ja: 前のセクションではヒントは特別な形式のコメント内に記載されています。これはクエリを編集できない場合には不便です。このような場合には `"hint_plan.hints"` という名前の特別なテーブルにヒントを置くことができます。このテーブルは以下のカラムで構成されています。

en: column
ja: 列名

en: description
ja: 説明

en: Unique number to identify a row for a hint.<br>This column is filled automatically by sequence.
ja: ユーザがヒントの行を識別するためのユニークな番号です。連番型ですので新しいヒントを登録するときには、この列を指定しないでください。

en: A pattern matches to the query to be hinted.<br>Constants in the query have to be replace with '?' as in the following example.<br>White space is significant in the pattern.
ja: 実行計画を制御したいクエリを指定します。対象のクエリに定数があるときは、下記の例のように「?」に置き換えます。キーワード間の空白の数が、登録するクエリと実行するクエリで異なると別のSQL文として扱われます。

en: The value of `application_name` of sessions to apply the hint.<br>The hint in the example below applies to sessions connected from psql.<br>An empty string means sessions of any `application_name`.
ja: ヒントの適用対象のアプリケーション名を指定します。下記の例ではpsqlから実行されたクエリのみがヒントの適用対象となります。全てのアプリケーションにヒントを適用したいときは、空文字列を登録します。アプリケーション名は、セッションの`application_name`GUCパラメータと等しいか判断します。

en: Hint phrase.<br>This must be a series of hints excluding surrounding comment marks.
ja: ヒント句を指定します。コメントの記号を除いた内容のみを登録します。

en: The following example shows how to operate with the hint table.
ja: 以下の例はヒント テーブルの操作方法を示しています。

en: The hint table is owned by the creator user and having the default privileges at the time of creation. during `CREATE EXTENSION`. Table hints are prioritized over comment hits.
ja: ヒントテーブルは作成者が所有し、作成時のデフォルトの権限を持ちます。テーブルによるヒント（テーブルヒント）はコメントによるヒント（コメントヒント）よりも優先されます。

en: The types of hints
ja: ヒントの種類

en: Hinting phrases are classified into six types based on what kind of object and how they can affect planning. Scanning methods, join methods, joining order, row number correction, parallel query, and GUC setting. You will see the lists of hint phrases of each type in [Hint list](#hint-list).
ja: ヒント句はどの対象にどのような影響をプランニングに与えるかに基づいて６種類に分類されます。種類はスキャン方法・結合方法・結合順序・見積り行数補正・並列実行の設定・GUCパラメータです。具体的なヒント句は、[ヒント一覧](#hint_list)を参照してください。

en: Hints for scan methods
ja: スキャン方法

en: Scan method hints enforce specific scanning method on the target table. `pg_hint_plan` recognizes the target table by alias names if any. They are `SeqScan`, `IndexScan` and so on in this kind of hint.
ja: スキャン方法のヒントは、対象のテーブルに対して特定のスキャン方法を強制するものです。`pg_hint_plan`は対象のテーブルに別名が存在する場合、別名で認識します。この種類のヒントには`SeqScan`や`IndexScan`などを含みます。

en: Scan hints are effective on ordinary tables, inheritance tables, UNLOGGED tables, temporary tables and system catalogs. External (foreign) tables, table functions, VALUES clause, CTEs, views and subquiries are not affected.
ja: スキャン方法のヒントは、通常のテーブル・継承テーブル・UNLOGGEDテーブル・一時テーブル・システムカタログに効果があります。外部テーブル・テーブル関数・VALUES句・CTE・ビュー・副問い合わせには影響を与えません。

en: Hints for join methods
ja: 結合方法

en: Join method hints enforce the join methods of the joins involving specified tables.
ja: 結合方法のヒントは、指定したテーブルを含む結合の結合方法を強制するものです。

en: This can affect on joins only on ordinary tables, inheritance tables, UNLOGGED tables, temporary tables, external (foreign) tables, system catalogs, table functions, VALUES command results and CTEs are allowed to be in the parameter list. But joins on views and sub query are not affected.
ja: これは、通常のテーブル・継承テーブル・UNLOGGEDテーブル・一時テーブル・外部テーブル・システムカタログ・テーブル関数・VALUESコマンド結果、およびパラメータリストに含めることが許可されているCTEの結合にのみ影響を与えます。しかし、ビュー・副問い合わせの結合には影響を与えません。

en: Hint for joining order
ja: 結合順序

en: This hint "Leading" enforces the order of join on two or more tables. There are two ways of enforcing. One is enforcing specific order of joining but not restricting direction at each join level. Another enfoces join direction additionaly. Details are seen in the [hint list](#hint-list) table.
ja: `Leading`ヒントは、2つ以上のテーブルの結合順序を強制するものです。強制には2つの方法があります。1つは特定の結合順序を強制し各結合レベルでは方向を制限しない方法です。もう1つは結合の方向を追加で指定するものです。詳細は[ヒント一覧](#hint-list)で確認できます。

en: Hint for row number correction
ja: 行数補正

en: This hint "Rows" corrects row number misestimation of joins that comes from restrictions of the planner.
ja: `Rows`ヒントは、プランナの制限に起因する結合の見積り行数誤りを修正します。

en: Hint for parallel plan
ja: 並列実行

en: This hint `Parallel` enforces parallel execution configuration on scans. The third parameter specifies the strength of enfocement. `soft` means that `pg_hint_plan` only changes `max_parallel_worker_per_gather` and leave all others to planner. `hard` changes other planner parameters so as to forcibly apply the number. This can affect on ordinary tables, inheritnce parents, unlogged tables and system catalogues. External tables, table functions, values clause, CTEs, views and subqueries are not affected. Internal tables of a view can be specified by its real name/alias as the target object. The following example shows that the query is enforced differently on each table.
ja: `Parallel`ヒント は、スキャンの並列実行の設定を強制するものです。第3パラメータは強制の強さを指定します。`soft` は `pg_hint_plan` が `max_parallel_worker_per_gather` を変更するだけで、その他のすべてはプランナに任せることを意味します。`hard`はプランナのパラメータを変更し、強制的にその数値を適用するようにします。
    このヒントは通常のテーブル・継承の親テーブル・UNLOGGEDテーブル・システムカタログに影響を与えることができます。外部テーブル・テーブル関数・VALUE句・CTE・ビュー・サブクエリには影響を与えません。
    ビューの内部テーブルについては、対象オブジェクトとして実名/別名を用いて指定できます。次の例のクエリは、各テーブルで異なる設定を強制しています。

en: GUC parameters temporarily setting
ja: GUCパラメータ

en: `Set` hint changes GUC parameters just while planning. GUC parameter shown in [Query Planning](http://www.postgresql.org/docs/current/static/runtime-config-query.html) can have the expected effects on planning unless any other hint conflicts with the planner method configuration parameters. The last one among hints on the same GUC parameter makes effect. [GUC parameters for `pg_hint_plan`](#guc-parameters-for-pg_hint_plan) are also settable by this hint but it won't work as your expectation. See [Restrictions](#restrictions) for details.
ja: `Set`ヒントはプランニング中だけGUCパラメータを変更します。 [Query Planning](http://www.postgresql.org/docs/current/static/runtime-config-query.html) で示したGUCパラメータは、他のヒントがプランナの設定パラメータと競合しない限り、期待される効果を発揮することができます。同じGUCパラメータに関するヒントのうち、最後のものが効果を発揮します。[pg_hint_planのGUCパラメータ](#guc-parameters-for-pg_hint_plan) もこのヒントで設定可能ですが期待通りには動作しません。詳しくは[機能的な制限事項](functional_limitations)を参照してください。

en: GUC parameters for `pg_hint_plan`
ja: pg_hint_planのGUCパラメータ

en: GUC parameters below affect the behavior of `pg_hint_plan`.
ja: pg_hint_planの動作を制御するGUCパラメータを以下に記述します。

en: Parameter name
ja: パラメータ名

en: Description
ja: 説明

en: Default
ja: デフォルト値

en: True enbles `pg_hint_plan`.
ja: Trueは`pg_hint_plan`を有効にします。

en: True enbles hinting by table. `true` or `false`.
ja: Trueはテーブルによってヒントを指定する機能を有効にします。

en: Specifies the log level of hint parse error. Valid values are `error`, `warning`, `notice`, `info`, `log`, `debug`.
ja: 指定したヒントを構文解析できなかった場合のログメッセージのレベルを指定します。指定可能な値は、`error`、`warning`、`notice`、`info`、`log`、`debug`です。

en: Controls debug print and verbosity. Valid vaiues are `off`, `on`, `detailed` and `verbose`.
ja: 動作状況を示すログメッセージの出力を制御します。指定可能な値は `off`、`on`、`detailed`、`verbose`です。

en: Specifies message level of debug print. Valid values are `error`, `warning`, `notice`, `info`, `log`, `debug`.
ja: 動作ログメッセージのログレベルを指定します。指定可能な値は、`error`、`warning`、`notice`、`info`、`log`、`debug`です。
