Skip to content

Commit

Permalink
update explain for 16.0
Browse files Browse the repository at this point in the history
  • Loading branch information
koizumistr committed Jan 21, 2024
1 parent 3c1867b commit a68a705
Showing 1 changed file with 9 additions and 23 deletions.
32 changes: 9 additions & 23 deletions doc/src/sgml/ref/explain.sgml
Original file line number Diff line number Diff line change
Expand Up @@ -253,10 +253,10 @@ ROLLBACK;
This parameter cannot be used together with <literal>ANALYZE</literal>.
It defaults to <literal>FALSE</literal>.
-->
《機械翻訳》ステートメントに<literal>$1</literal>のようなパラメータプレースホルダを含めることを許可し、これらのパラメータの値に依存しない一般的プランを生成します
一般的計画およびサポートパラメータが設定されるステートメントのタイプの詳細は、<link linkend="sql-prepare"><command>プリペア</command></link>を参照してください。
文が<literal>$1</literal>のようなパラメータプレースホルダを含むことを許可し、これらのパラメータの値に依存しない汎用的な計画を生成します
汎用的な計画およびパラメータをサポートする文のタイプの詳細は、<link linkend="sql-prepare"><command>PREPARE</command></link>を参照してください。
このパラメータは<literal>ANALYZE</literal>と併用できません。
デフォルトは<literal></literal>です。
デフォルトは<literal>FALSE</literal>です。
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -288,7 +288,7 @@ ROLLBACK;
format, only non-zero values are printed. This parameter defaults to
<literal>FALSE</literal>.
-->
《マッチ度[88.645580]》バッファの使用状況に関する情報を含めます。
バッファの使用状況に関する情報を含めます。
具体的には、共有ブロックのヒット数、読み取り数、ダーティブロック数、書き出し数、ローカルブロックのヒット数、読み取り数、ダーティブロック数、書き出し数、一時ブロックの読み取り数、書き出し数、そして、<xref linkend="guc-track-io-timing"/>が有効にされていればデータファイルブロックと一時ファイルブロックの読み取り、書き出しに掛かった時間(ミリ秒単位)が含められます。
<emphasis>ヒット</emphasis>とは、必要な時にキャッシュ内にそのブロックが見つかったため読み取りが避けられたことを意味します。
共有ブロックには、通常のテーブルとインデックスからのデータが含まれます。
Expand All @@ -298,19 +298,7 @@ ROLLBACK;
<emphasis>書き出し</emphasis>ブロック数は、問い合わせ処理の間にバックエンドにより、ダーティ状態だったブロックの内キャッシュから追い出されたブロックの数を示します。
上位レベルのノードで表示されるブロック数には、その子ノードすべてで使用されるブロックが含まれます。
テキスト形式では、非ゼロの値のみが出力されます。
デフォルトは<literal>FALSE</literal>です。
《機械翻訳》バッファの使用状況に関するinclude情報。
特に、ヒット、読取り、区別および書込み済の共有ブロック数、ヒット、読取り、区別および書込み済のローカルブロック数、読取りおよび書込み済の一時ブロック数、およびデータファイルブロックおよび一時的ファイルブロックの読取りおよび書込みにかかった時間(ミリ秒単位)。
<emphasis>ヒット</emphasis>は、ブロックが必要なときにキャッシュですでに検出されていたため、読取りが回避されたことを意味します。
共有ブロックには、通常の表および索引からデータが含まれます。
ローカル・ブロックには、一時的表および索引からデータが含まれます。
一方、一時的ブロックには、ソート、ハッシュ、マテリアライズ計画ノードなどで使用される短期作業データが含まれます。
ブロック数<emphasis>区別</emphasis>は、このクエリによって変更された、以前に変更されていないブロックの数を示します。
ブロック数<emphasis>書込み済</emphasis>は、以前に区別されたブロックの数を示します。
ブロック数は、そのすべての子ノードによって使用されているブロックを含みます。
では、区別されていない値のみが印刷されます。
こののデフォルトは<literal>反復性</literal>です。
キャッシュバックエンドクエリレベルノードテキストフォーマットゼロパラメータinclude偽<xref linkend="guc-track-io-timing"/>
このパラメータのデフォルトは<literal>FALSE</literal>です。
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -684,9 +672,8 @@ EXPLAIN ANALYZE EXECUTE query(100, 200);
We might also wish to see the generic plan for a parameterized
query, which can be done with <literal>GENERIC_PLAN</literal>:
-->
《機械翻訳》前の例では、<command>カスタム</command>で指定された特定のプラン値に対して<quote>パラメータ</quote>が表示されていたことに注意してください。
パラメータ化されたクエリの一般的プランを確認することもできます。
これは<literal>一般的_プラン</literal>で行うことができます。
前の例では、<command>EXECUTE</command>で与えられた特定のパラメータに対する<command>独自の</command>計画が表示されていたことに注意してください。
パラメータ化された問い合わせに対する汎用的な計画を確認することもできます。それは<literal>GENERIC_PLAN</literal>で可能です。

<programlisting>
EXPLAIN (GENERIC_PLAN)
Expand All @@ -711,9 +698,8 @@ EXPLAIN (GENERIC_PLAN)
it might be necessary to explicitly specify types for the parameter
symbols, which can be done by casting them, for example:
-->
このケースでは、パーサは<literal>$1</literal>と<literal>$2</literal>が<literal>id</literal>と同じデータタイプを持つべきだと正しく推測していたので、<command>プリペア</command>からのパラメータタイプ情報の欠如は問題ではありませんでした。
他の場合には、パラメータ記号の型を明示的に指定する必要があるかもしれません。
これは、例に対してそれらをキャストすることによって行うことができます。
この場合では、パーサは<literal>$1</literal>と<literal>$2</literal>が<literal>id</literal>と同じデータ型を持つべきだと正しく推測していたので、<command>PREPARE</command>からのパラメータ型情報の欠如は問題ではありませんでした。
他の場合には、パラメータ記号の型を明示的に指定することが必要かもしれません。これは、例えば以下のように、それらをキャストすることによって可能です。

<programlisting>
EXPLAIN (GENERIC_PLAN)
Expand Down

0 comments on commit a68a705

Please sign in to comment.