Open
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
ALTER TABLE リファレンス（日本語訳）を PostgreSQL 18.1 の原文に合わせて更新し、特に per-attribute オプション（n_distinct / n_distinct_inherited）説明の内容差分を解消する PR です。
Changes:
- per-attribute オプション説明を 18.1 の英文コメントに追従（パーティションテーブル統計への言及、負値/小数指定の説明など）
- 既存テキスト中の機械翻訳由来の不正な混入行を削除
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| 負の値の場合、この値は-1以上でなければなりませんが、<command>ANALYZE</command>は、その列内の非NULLの個別値はテーブルのサイズに線形であるとみなし、推定テーブルサイズに指定した値の絶対値を乗じた値が個別値数であるとみなします。 | ||
| これらのオプションは、その後の<link linkend="sql-analyze"><command>ANALYZE</command></link>操作により生成される個別値の数の推定値を上書きします。 | ||
| <literal>n_distinct</literal>はテーブル自身の統計情報に影響を与え、<literal>n_distinct_inherited</literal>はテーブルとそれを継承した子テーブルから集めた統計情報、およびパーティションテーブルから集めた統計情報に影響を与えます。 | ||
| 指定された値が正の値の場合、問い合わせプランナは、その列は、指定された個数の非NULLの個別値を正確に含むものとみなします。 |
There was a problem hiding this comment.
「問い合わせプランナは、その列は、…」は日本語として不自然です。英語原文の "assume that the column contains" に合わせて「問い合わせプランナは、その列が…含むものとみなします」のように主語を「が」にすると読みやすくなります。
Suggested change
| 指定された値が正の値の場合、問い合わせプランナは、その列は、指定された個数の非NULLの個別値を正確に含むものとみなします。 | |
| 指定された値が正の値の場合、問い合わせプランナは、その列が指定された個数の非NULLの個別値を正確に含むものとみなします。 |
| <literal>n_distinct</literal>はテーブル自身の統計情報に影響を与え、<literal>n_distinct_inherited</literal>はテーブルとそれを継承した子テーブルから集めた統計情報、およびパーティションテーブルから集めた統計情報に影響を与えます。 | ||
| 指定された値が正の値の場合、問い合わせプランナは、その列は、指定された個数の非NULLの個別値を正確に含むものとみなします。 | ||
| 0未満、-1以上の値を使って、小数を指定することもできます。 | ||
| これは、指定された数の絶対値にテーブルの推定行数を乗算して個別値の数を推定するよう問い合わせプランナに指示します。 |
There was a problem hiding this comment.
「…推定するよう問い合わせプランナに指示します」は助詞が抜けているため文意が取りづらいです。「…推定するように問い合わせプランナに指示します」など、「ように」を入れる形に直してください。
Suggested change
| これは、指定された数の絶対値にテーブルの推定行数を乗算して個別値の数を推定するよう問い合わせプランナに指示します。 | |
| これは、指定された数の絶対値にテーブルの推定行数を乗算して個別値の数を推定するように問い合わせプランナに指示します。 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
ref/alter_table.sgml の 18.1 対応です。