Skip to content

update create_index for 18.0 #3544

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: doc_ja_18
Choose a base branch
from
Open

update create_index for 18.0 #3544

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
505a449
update create_index for 18.0
koizumistr Nov 10, 2025
6dffb4e
respond to Copilot's comment
koizumistr Nov 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 14 additions & 33 deletions doc/src/sgml/ref/create_index.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -562,17 +562,16 @@ NULLを非NULLより後にソートすることを指定します。
parameters</firstterm> for the index. Each index method has its own set
of allowed storage parameters.
-->
《機械翻訳》インデックスのオプショナル<literal>WITH</literal>句は<firstterm>ストレージパラメータ</firstterm>を指定します。
各インデックスメソッドには、独自に許可されたストレージパラメータのセットがあります。
<literal>WITH</literal>句を使うと、インデックスの<firstterm>格納パラメータ</firstterm>を指定できます。
インデックスメソッドはそれぞれ固有の設定可能な格納パラメータを持ちます。
</para>

<para>
<!--
The B-tree, hash, GiST and SP-GiST index methods all accept this
parameter:
-->
《マッチ度[53.333333]》B-treeインデックスはさらに以下のパラメータを受け付けます。
《機械翻訳》B-ツリー、ハッシュ、GiSTおよびSP-GiSTインデックスメソッドはすべてこのパラメータを受け入れます:。
B-tree、ハッシュ、GiSTおよびSP-GiSTといったインデックスはすべて次のパラメータを受け付けます。
</para>

<variablelist>
Expand All @@ -597,15 +596,10 @@ NULLを非NULLより後にソートすることを指定します。
fragmentation of the on-disk index structure. B-trees use a default
fillfactor of 90, but any integer value from 10 to 100 can be selected.
-->
《マッチ度[76.576577]》インデックス用のフィルファクタは割合（パーセント）で、インデックスメソッドがインデックスページをまとめ上げる時にどの程度ページを使用するかを決定するものです。
インデックスメソッドがインデックスページをまとめ上げる時にどの程度ページを使用するかを制御します。
B-treeでは、リーフページは初期インデックス構築時と右側（新しい最大キー値を追加する方向）にインデックスを拡張する時にこの割合分までページを使用します。
その後ページすべてが完全に使用されると分割され、ディスク上のインデックスの構造が断片化していきます。
B-treeのデフォルトのフィルファクタは90ですが、10から100までの任意の整数値を設定することができます。
《機械翻訳》インデックスメソッドがパックインデックスページに対してどの程度満たされるかを制御します。
B-treeの場合、リーフページは、最初のインデックス構築時、および拡張時に右側のインデックスに（新規の最大キー値を追加して）このパーセンテージまで満たされます。
その後、ページが完全に満たされると分割され、ディスク上のインデックス構造のフラグメンテーションが発生します。
B-treeでは90のデフォルトfillfactorが使用されますが、10から100までの整数値を選択できます。
トライ
</para>
<para>
<!--
Expand Down Expand Up @@ -730,9 +724,8 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
Note that if sorted build is possible, it will be used instead of
buffered build unless <literal>buffering=ON</literal> is specified.
-->
《マッチ度[90.381125]》<xref linkend="gist-buffering-build"/>で説明するバッファ化構築技術をインデックスを構築する時に使用するかどうかを決定します。
バッファ処理は<literal>OFF</literal>で無効に、<literal>ON</literal>で有効になります。
また<literal>AUTO</literal>と指定すると、最初は無効ですが、インデックスサイズが<xref linkend="guc-effective-cache-size"/>に達した後はその場で有効になります。
<xref linkend="gist-buffering-build"/>で説明するバッファ化構築技法をインデックスを構築する時に使用するかどうかを制御します。
バッファ処理は<literal>OFF</literal>で無効に、<literal>ON</literal>で有効になります。また<literal>AUTO</literal>と指定すると、最初は無効ですが、インデックスサイズが<xref linkend="guc-effective-cache-size"/>に達した後はその場で有効になります。
デフォルトは<literal>AUTO</literal>です。
ソートしての構築が可能であれば、<literal>buffering=ON</literal>が指定されていない限りバッファ化構築の代わりに使われることに注意してください。
</para>
Expand All @@ -744,8 +737,7 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
<!--
GIN indexes accept these parameters:
-->
《マッチ度[69.444444]》GINインデックスでは以下の異なるパラメータを受け付けます。
《機械翻訳》GINインデックスでは、次のパラメータを使用できます。
GINインデックスでは以下のパラメータを受け付けます。
</para>

<variablelist>
Expand All @@ -766,11 +758,8 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
<literal>ON</literal> enables fast update, <literal>OFF</literal> disables it.
The default is <literal>ON</literal>.
-->
《マッチ度[70.192308]》この設定は<xref linkend="gin-fast-update"/>で説明する高速更新技法を使用するかどうかを制御します。
<xref linkend="gin-fast-update"/>で説明する高速更新技法を使用するかどうかを制御します。
これは論理値パラメータであり、<literal>ON</literal>は高速更新を有効に、<literal>OFF</literal>は無効にします。
デフォルトは<literal>ON</literal>です。
《機械翻訳》<xref linkend="gin-fast-update"/>で説明されている高速更新テクニックの使用方法を制御します。
<literal>ON</literal>高速更新を有効にし、<literal>OFF</literal>無効にします。
デフォルトは<literal>ON</literal>です。
</para>

Expand All @@ -784,11 +773,9 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
the <function>gin_clean_pending_list</function>
function afterward to ensure the pending list is emptied.
-->
《マッチ度[88.346883]》<command>ALTER INDEX</command>を使用して<literal>fastupdate</literal>を無効にすることにより、以後の挿入は待機中のインデックス項目リストに入らないようになります。
<command>ALTER INDEX</command>を使用して<literal>fastupdate</literal>を無効にすることにより、以後の挿入は待機中のインデックス項目リストに入らないようになります。
しかし、このコマンド自体はこれまでの項目を吐き出しません。
確実に待機中のリストを空にするためには、続いてテーブルを<command>VACUUM</command>するか、<function>gin_clean_pending_list</function>関数を呼び出すのが良いでしょう。
《機械翻訳》<literal>高速更新</literal>オフを<command>ALTER INDEX</command>経由に変更すると、今後の挿入が保留中のインデックスエントリのリストに入るのを防ぎますが、自分自身フラッシュの既存のエントリには入りません。
<command>VACUUM</command>テーブルまたは呼び出しを<function>gin_clean_pending_list</function>後で関数を保証に変更すると、保留中のリストが空になります。
</para>
</note>
</listitem>
Expand All @@ -814,10 +801,8 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
<xref linkend="guc-gin-pending-list-limit"/> for this index.
This value is specified in kilobytes.
-->
《マッチ度[69.230769]》<xref linkend="guc-gin-pending-list-limit"/>のカスタムパラメータです。
このインデックスに対する<xref linkend="guc-gin-pending-list-limit"/>の全体設定を上書きします。
値はキロバイト単位で指定します。
《機械翻訳》このグローバルの<xref linkend="guc-gin-pending-list-limit"/>のインデックス設定を上書きします。
この値はキロバイトで指定されます。
</para>
</listitem>
</varlistentry>
Expand All @@ -827,8 +812,7 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
<!--
<acronym>BRIN</acronym> indexes accept these parameters:
-->
《マッチ度[80.357143]》<acronym>BRIN</acronym>インデックスは別のパラメータを受け入れます。
《機械翻訳》<acronym>BRIN</acronym>インデックスは、次のパラメータを受け入れます。
<acronym>BRIN</acronym>インデックスでは次のパラメータを受け付けます。
</para>

<variablelist>
Expand Down Expand Up @@ -871,11 +855,8 @@ GiSTインデックスではさらに以下のパラメータを受け付けま
(see <xref linkend="brin-operation"/> for more details).
The default is <literal>off</literal>.
-->
《マッチ度[89.497717]》次のページへの挿入が検知された時に、いつでも直前のページに対してサマリ処理をキューに入れるかどうかを定義します。
詳細は<xref linkend="brin-operation"/>を参照してください。
次のページへの挿入が検知された時に、いつでも直前のページに対してサマリ処理をキューに入れるかどうかを定義します（詳細は<xref linkend="brin-operation"/>を参照してください）。
デフォルトは<literal>off</literal>です。
《機械翻訳》次のレンジで挿入が検出されるたびに、前のページデフォルトの要約実行をキューに入れるかどうかを定義します（詳細については、<xref linkend="brin-operation"/>を参照してください）。
は<literal>off</literal>です。
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -1228,9 +1209,9 @@ Indexes:
Generally, a cost model automatically determines how many worker
processes should be requested, if any.
-->
《マッチ度[93.739425]》<productname>PostgreSQL</productname>はテーブルの行をより高速に処理するために複数CPUを効かせてインデックスを作成できます。
<productname>PostgreSQL</productname>はテーブルの行をより高速に処理するために複数CPUを効かせてインデックスを作成できます。
この機能は<firstterm>パラレルインデックス作成</firstterm>と呼ばれています。
パラレルでのインデックス作成をサポートしているインデックスメソッド（今のところB-treeとBRIN）に対して、<varname>maintenance_work_mem</varname>では、いくつのワーカープロセスが実行されているかに拘らず、各インデックス作成操作で使うことができる全体のメモリの最大量を指定します。
パラレルでのインデックス作成をサポートしているインデックスメソッド（今のところB-tree、GINとBRIN）に対して、<varname>maintenance_work_mem</varname>では、いくつのワーカープロセスが実行されているかに拘らず、各インデックス作成操作で使うことができる全体のメモリの最大量を指定します。
一般にコストモデルは、もしあるなら、どれだけの数のワーカープロセスを要求すべきかを自動的に決定します。
</para>

Expand Down