Update planstats.sgml for v17

[kkato]

以下のファイルの 17.0 対応です。

• planstats.sgml

Details

英語版のv16とv17の差分です。

~/ghq/github.com/kkato/jpug-doc/doc/src/sgml % git diff REL_16_4 REL_17_0 planstats.sgml
diff --git a/doc/src/sgml/planstats.sgml b/doc/src/sgml/planstats.sgml
index d2b84b301f5..c7ec749d0a6 100644
--- a/doc/src/sgml/planstats.sgml
+++ b/doc/src/sgml/planstats.sgml
@@ -30,8 +30,6 @@
   <para>
    The examples shown below use tables in the <productname>PostgreSQL</productname>
    regression test database.
-   The outputs shown are taken from version 8.3.
-   The behavior of earlier (or later) versions might vary.
    Note also that since <command>ANALYZE</command> uses random sampling
    while producing statistics, the results will change slightly after
    any new <command>ANALYZE</command>.
@@ -391,18 +389,20 @@ tablename  | null_frac | n_distinct | most_common_vals
 </programlisting>
 
    In this case there is no <acronym>MCV</acronym> information for
-   <structfield>unique2</structfield> because all the values appear to be
-   unique, so we use an algorithm that relies only on the number of
-   distinct values for both relations together with their null fractions:
+   <structname>unique2</structname> and all the values appear to be
+   unique (n_distinct = -1), so we use an algorithm that relies on the row
+   count estimates for both relations (num_rows, not shown, but "tenk")
+   together with the column null fractions (zero for both):
 
 <programlisting>
-selectivity = (1 - null_frac1) * (1 - null_frac2) * min(1/num_distinct1, 1/num_distinct2)
+selectivity = (1 - null_frac1) * (1 - null_frac2) / max(num_rows1, num_rows2)
             = (1 - 0) * (1 - 0) / max(10000, 10000)
             = 0.0001
 </programlisting>
 
    This is, subtract the null fraction from one for each of the relations,
-   and divide by the maximum of the numbers of distinct values.
+   and divide by the row count of the larger relation (this value does get
+   scaled in the non-unique case).
    The number of rows
    that the join is likely to emit is calculated as the cardinality of the
    Cartesian product of the two inputs, multiplied by the

[kkato]

@KenichiroTanaka
GitHub Workflowが実行されないので、承認をお願いします。

[KenichiroTanaka]

@kkato
早速の対応ありがとうございます。
承認しました。

[noborus]

この場合、<structname>unique2</structname> に関する <acronym>MCV</acronym> の

タグの前後のスペースは無しにしてください。

[noborus]

カラムのNULL率

カラムは「列」で統一されています。

[kkato]

ご指摘ありがとうございます。
修正しました。

[noborus]

ご指摘ありがとうございます。 修正しました。

修正ありがとうございます。確認しました。

[noborus]

newの意味は残したほうが良いと思うので、前バージョンの訳のままでも良いと思いました。

[noborus]

num_rowsは表示されていて、tenk1,tenk2が表示されていないので、
「両方のリレーション（ここでは表示されていませんが"tenk"）の行数推定値（num_rows） 」
だと思います。後々見たときにチェックしづらいので括弧の関係を崩したくないため
「両方のリレーションの行数推定値（（ここでは表示されていませんが"tenk"の）num_rows） 」
とするのが良いかもしれません。
（原文の方でnum_rows1,nom_rows2、tenk1,tenk2を崩さず書いてほしいところです...）

[noborus]

すみません。ちょっとコメントを移動修正。
2つコメントを書いたので確認をお願いします。

今回のバージョンアップで変更していない古い箇所で、
cardinality がカーディナリティではなく他では「濃度」になっているところがあります。
これはカーディナリティにしてしまって良いと思いました。

[kkato]

レビューありがとうございます。

返信が遅くなり、申し訳ありません。
修正したので、ご確認よろしくお願いします。

[noborus]

修正ありがとうございます。確認しました。

[KenichiroTanaka]

対応ありがとうございました。
一通り確認しましたのでマージします。