Skip to content

update copy for 18.0 #3563

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
koizumistr wants to merge 3 commits into
base: doc_ja_18
Choose a base branch
from
Open

update copy for 18.0 #3563

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1a58202
update copy for 18.0
koizumistr Nov 29, 2025
b68cbe7
respond to Copilot's comment
koizumistr Dec 7, 2025
1752971
respond to Saito-san's comment
koizumistr Jan 30, 2026
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
69 changes: 27 additions & 42 deletions doc/src/sgml/ref/copy.sgml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -304,11 +304,9 @@ Windowsユーザの場合、<literal>E''</literal>文字列を使用し、パス
The default is <literal>text</literal>.
See <xref linkend="sql-copy-file-formats"/> below for details.
-->
《マッチ度[63.241107]》読み取りまたは書き込みに使用するデータ形式を選択します。
読み取りまたは書き込みに使用するデータ形式を選択します。
<literal>text</literal>、<literal>csv</literal>（カンマ区切り値）、または<literal>binary</literal>です。
デフォルトは<literal>text</literal>です。
《機械翻訳》読取りまたは書込みの対象となるデータフォーマットを、<literal>text</literal>、<literal>csv</literal>カンマ区切り形式または<literal>binary</literal>の中から選択します。
デフォルトは<literal>text</literal>です。
詳細は、後述の<xref linkend="sql-copy-file-formats"/>を参照してください。
</para>
</listitem>
Expand All @@ -329,16 +327,11 @@ Windowsユーザの場合、<literal>E''</literal>文字列を使用し、パス
a partitioned table or foreign table.
This option is only allowed in <command>COPY FROM</command>.
-->
《マッチ度[88.636364]》あたかも<command>VACUUM FREEZE</command>コマンドを実行した後のように、行を凍結した状態のデータコピー処理を要求します。
あたかも<command>VACUUM FREEZE</command>コマンドを実行した後のように、行を凍結した状態のデータコピー処理を要求します。
これは、初期データロード処理用の性能オプションとしての利用を意図しています。
ロード元のテーブルが現在の副トランザクションで作成または切り詰めされ、開いているカーソルは存在せず、またこのトランザクションで保持される古めのスナップショットが存在しない場合のみ、行は凍結されます。
今のところ、パーティションテーブルでは<command>COPY FREEZE</command>を実行できません。
今のところ、パーティションテーブルと外部テーブルでは<command>COPY FREEZE</command>を実行できません。
このオプションは<command>COPY FROM</command>でのみ使用できます。
《機械翻訳》<command>VACUUM FREEZE</command>データの実行後と同様に、行がすでに固定されているコマンドのコピーを要求します。
これは、初期のパフォーマンスロードのデータオプションとして意図されています。
ロード中のテーブルが現在サブトランザクションで作成または切り捨てられ、カーソルオープンがなく、このトランザクションに保持されている古いスナップショットがない場合にのみ、行が固定されます。
現在、<command>COPY FREEZE</command>パーティション化されたテーブルまたは外部テーブルでを実行することはできません。
このオプションは<command>COPY FROM</command>でのみ許可されています。
</para>
<para>
<!--
Expand Down Expand Up @@ -584,12 +577,9 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
When it is set to <literal>silent</literal>, no message is emitted
regarding ignored rows.
-->
《マッチ度[74.497992]》少なくとも1行が破棄された場合、<command>COPY FROM</command>の最後に、無視された行数を含む<literal>NOTICE</literal>メッセージが出力されます。
少なくとも1行が破棄された場合、<command>COPY FROM</command>の最後に、無視された行数を含む<literal>NOTICE</literal>メッセージが出力されます。
<literal>LOG_VERBOSITY</literal>オプションが<literal>verbose</literal>に設定されている場合、破棄された各行に対して、入力ファイルの行と入力変換に失敗した列名を含む<literal>NOTICE</literal>メッセージが出力されます。
《機械翻訳》<literal>NOTICE</literal>無視されたメッセージカウントを含む行は、<command>COPY FROM</command>少なくとも1つの行が破棄された場合の最後にエミットされます。
<literal>LOG_VERBOSITY</literal>オプションが<literal>verbose</literal>に設定されている場合、<literal>NOTICE</literal>入力されたファイルの直線と、入力された変換が失敗したカラム名前を含む行は、破棄されたごとにエミットされます。
<literal>silent</literal>に設定されている場合、無視された行に関してメッセージはエミットされません。
メッセージ
<literal>silent</literal>に設定されている場合、無視された行に関してメッセージは出力されません。
</para>
</listitem>
</varlistentry>
Expand All @@ -610,10 +600,10 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
allows an unlimited number of errors, meaning <command>COPY</command> will
skip all erroneous data.
-->
《機械翻訳》<literal>ON_ERROR</literal>が<literal>ignore</literal>に設定されている場合、カラムの入力値をデータタイプに変換するときに許容されるエラーの最大数を指定します。
入力が指定された値よりも多くのエラーを引き起こした場合、<command>COPY</command>コマンドは<literal>ON_ERROR</literal>に設定されている場合でも失敗します。
<literal>ignore</literal>この句は<literal>ON_ERROR</literal>=<literal>ignore</literal>および<replaceable class="parameter">maxerror</replaceable>は正の<type>bigint</type>である必要があります。
指定されていない場合、<literal>ON_ERROR</literal>=<literal>ignore</literal>はエラーの数に制限がないため、<command>COPY</command>はエラーのあるすべてのデータをスキップします。
<literal>ON_ERROR</literal>が<literal>ignore</literal>に設定されている場合、列の入力値をそのデータ型に変換するときに許容されるエラーの最大数を指定します。
入力が指定された値よりも多くのエラーを引き起こした場合、<command>COPY</command>コマンドは<literal>ON_ERROR</literal>が<literal>ignore</literal>に設定されている場合でも失敗します。
この句は<literal>ON_ERROR</literal>=<literal>ignore</literal>と組み合わせて使用することが必要で、また<replaceable class="parameter">maxerror</replaceable>は正の<type>bigint</type>でなければなりません。
指定されていない場合、<literal>ON_ERROR</literal>=<literal>ignore</literal>はエラーの数に制限がないため、<command>COPY</command>はエラーのあるデータをすべてスキップします。
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -647,12 +637,10 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
emitted during processing.
<literal>silent</literal> suppresses both verbose and default messages.
-->
《マッチ度[61.631420]》<command>COPY</command>コマンドが出力するメッセージの量を指定します。
<literal>default</literal>または<literal>verbose</literal>です。
<command>COPY</command>コマンドが出力するメッセージの量を指定します。
<literal>default</literal>、<literal>verbose</literal>または<literal>silent</literal>です。
<literal>verbose</literal>が指定された場合、処理中に追加のメッセージが出力されます。
《機械翻訳》<command>COPY</command>コマンド:<literal>default</literal>、<literal>verbose</literal>または<literal>silent</literal>。
<literal>verbose</literal>が指定されている場合は、処理中に追加のメッセージが発行されます。
<literal>silent</literal> VERBOSEとデフォルトの両方のメッセージが抑制されます。
<literal>silent</literal>ではverboseとdefaultの両方のメッセージが抑制されます。
</para>
<para>
<!--
Expand Down Expand Up @@ -760,9 +748,9 @@ COPY <replaceable class="parameter">count</replaceable>
To copy all rows from such relations, use <literal>COPY (SELECT * FROM
<replaceable class="parameter">table</replaceable>) TO</literal>.
-->
《機械翻訳》<command>COPY TO</command>プレーン・テーブルと移入されたマテリアライズド・ビューで使用できます。
例の場合、<literal>COPY <replaceable class="parameter">table</replaceable> TO</literal>は<literal>SELECT * FROM ONLY <replaceable class="parameter">table</replaceable></literal>と同じ行をコピーします。
ただし、テーブルパーティション、継承の子テーブル、またはビューなど、他のリレーションタイプを直接サポートすることはありません。
<command>COPY TO</command>は通常のテーブルとデータが格納されたマテリアライズドビューで使用できます。
例えば、<literal>COPY <replaceable class="parameter">table</replaceable> TO</literal>は<literal>SELECT * FROM ONLY <replaceable class="parameter">table</replaceable></literal>と同じ行をコピーします。
ただし、パーティションテーブル、継承の子テーブル、またはビューなど、他のリレーションタイプを直接サポートすることはありません。
このようなリレーションからすべての行をコピーするには、<literal>COPY (SELECT * FROM <replaceable class="parameter">table</replaceable>) TO</literal>を使用します。
</para>

Expand Down Expand Up @@ -988,12 +976,10 @@ COPY <replaceable class="parameter">count</replaceable>
context the rule is needed to be able to end the operation before the
end of the script.
-->
《機械翻訳》データの終わりは、バックスラッシュ-ピリオド<literal>\.</literal>のみを含む行で表すことができます。
データの終わりは完全に機能するため、ファイルから読み取る場合はファイルの終わりマーカーは必要ありません。
コンテキストでは、この規定は逆方向互換性に対してのみ存在します。
ただし、<application>psql</application>では、<literal>\.</literal>を使用して<literal>COPY FROM STDIN</literal>オペレーションを終了します。
つまり、SQLスクリプトでは-直線<command>COPY</command>データを読み取ります。
そのコンテキストでは、ルールはオペレーション前をスクリプトの終わりで終了できる必要があります。
データの終了は、バックスラッシュとピリオド（<literal>\.</literal>）のみから構成される1行で表されます。
ファイルの終了により同じ動作になるので、ファイルからの読み込みの場合はデータの終了の印は不要です。そのような状況では、この規定は後方互換性のためだけに存在します。
Copy link

Copilot AI Dec 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] 980行目の文が長く、2つの独立した内容が句点なしに連結されています。「不要です。」の後に改行を入れて2つの文に分けるべきです：「ファイルからの読み込みの場合はデータの終了の印は不要です。そのような状況では、この規定は後方互換性のためだけに存在します。」

Suggested change
ファイルの終了により同じ動作になるので、ファイルからの読み込みの場合はデータの終了の印は不要です。そのような状況では、この規定は後方互換性のためだけに存在します。
ファイルの終了により同じ動作になるので、ファイルからの読み込みの場合はデータの終了の印は不要です。
そのような状況では、この規定は後方互換性のためだけに存在します。

Copilot uses AI. Check for mistakes.
ただし、<application>psql</application>では、<literal>\.</literal>を使用して<literal>COPY FROM STDIN</literal>操作（つまり、SQLスクリプト内のインライン<command>COPY</command>データの読み込み）を終了します。
そのような状況では、スクリプトの終わりの前に操作を終了できるようにするためこの規則が必要です。
</para>

<para>
Expand Down Expand Up @@ -1130,7 +1116,7 @@ COPY <replaceable class="parameter">count</replaceable>
-->
上表で記載されていないバックスラッシュ付きの文字はすべて、その文字自体として解釈されます。
しかし、不要なバックスラッシュの追加には注意してください。
偶然にデータの終わりを示す印（<literal>\.</literal>）やヌル文字列（デフォルトでは<literal>\N</literal>）と合致する文字列を生成してしまうかもしれないためです。
偶然にデータの終了の印（<literal>\.</literal>）やヌル文字列（デフォルトでは<literal>\N</literal>）と合致する文字列を生成してしまうかもしれないためです。
これらの文字列は他のバックスラッシュの処理を行う前に解釈されます。
</para>

Expand Down Expand Up @@ -1199,7 +1185,7 @@ COPY <replaceable class="parameter">count</replaceable>
<productname>PostgreSQL</productname>'s standard text format, it
produces and recognizes the common <literal>CSV</literal> escaping mechanism.
-->
《マッチ度[94.285714]》この形式オプションは、スプレッドシートなど他の多くのプログラムで使用されるカンマ区切り値（<literal>CSV</literal>）ファイル形式をインポート、エクスポートするために使用されます。
この形式オプションは、スプレッドシートなど他の多くのプログラムで使用されるカンマ区切り値（<literal>CSV</literal>）ファイル形式をインポート、エクスポートするために使用されます。
<productname>PostgreSQL</productname>の標準テキスト形式で使用されるエスケープ規則の代わりに、一般的な<literal>CSV</literal>のエスケープ機構を生成、認識します。
</para>

Expand Down Expand Up @@ -1257,8 +1243,8 @@ COPY <replaceable class="parameter">count</replaceable>
only <literal>\.</literal>, whether it is text or <literal>CSV</literal>
mode.
-->
《機械翻訳》バックスラッシュは<literal>CSV</literal>フォーマットの特殊文字ではないため、データ<literal>\.</literal>で使用されるテキストモード終了マーカーは、通常、<literal>CSV</literal>データを読み取る際には特殊文字として扱われません。
例外は、<application>psql</application>は<literal>COPY FROM STDIN</literal>オペレーションを終了します(つまり、-直線<command>COPY</command>SQLスクリプトのデータを読み取ると、テキストであっても<literal>CSV</literal>モードであっても<literal>\.</literal>のみを含む行で終了します。
バックスラッシュは<literal>CSV</literal>形式では特殊文字でないため、テキストモードで使われるデータの終了の印（<literal>\.</literal>）は、通常、<literal>CSV</literal>データを読み取る際には特殊文字として扱われません。
例外は、<application>psql</application>が、テキストであっても<literal>CSV</literal>モードであっても<literal>\.</literal>のみを含む行で<literal>COPY FROM STDIN</literal>操作（つまり、SQLスクリプト内のインライン<command>COPY</command>データの読み込み）を終了することです。
</para>

<note>
Expand All @@ -1270,8 +1256,8 @@ COPY <replaceable class="parameter">count</replaceable>
versions, <command>COPY TO</command> will quote <literal>\.</literal>
when it's alone on a line, even though this is no longer necessary.
-->
《機械翻訳》<productname>PostgreSQL</productname>前v18のバージョンでは、別のデータから読み込んだ場合でも、常にクォートされていない<literal>\.</literal>ファイルの終わりのマーカーとしてを認識していました。
古いバージョンの互換性では、<command>COPY TO</command>は1行に引用符<literal>\.</literal>がある場合、これが不要になったとしても引用符で囲みます。
<productname>PostgreSQL</productname>のv18以前のバージョンでは、別のファイルから読み込んだ場合でも、引用符で囲まれていない<literal>\.</literal>をデータの終了の印として認識していました。
古いバージョンとの互換性のため、<command>COPY TO</command>は1行に<literal>\.</literal>だけがある場合、必要でないとしてもこれを引用符で囲みます。
</para>
</note>

Expand Down Expand Up @@ -1396,10 +1382,9 @@ easy identification of files that have been munged by a non-8-bit-clean
transfer. This signature will be changed by end-of-line-translation
filters, dropped zero bytes, dropped high bits, or parity changes.)
-->
<literal>PGCOPY\n\377\r\n\0</literal>という11バイトの並びです。
この署名の必須部分にNULLバイトが含まれていることに注意してください
<literal>PGCOPY\n\377\r\n\0</literal>という11バイトの並びです &mdash; この署名の必須部分にNULLバイトが含まれていることに注意してください。
Copy link

Copilot AI Dec 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] 行末にスペース（&mdash;）を追加した後、句読点の扱いに注意が必要です。日本語の文中では「です」の後に全角スペースではなく、半角スペースとダッシュ（&mdash;）を続ける形式は不自然です。元の2行の構成を保持するか、「です。」の後に改行して「この署名の必須部分に...」を次の文として開始する方が自然です。

Suggested change
<literal>PGCOPY\n\377\r\n\0</literal>という11バイトの並びです &mdash; この署名の必須部分にNULLバイトが含まれていることに注意してください。
<literal>PGCOPY\n\377\r\n\0</literal>という11バイトの並びです。
この署名の必須部分にNULLバイトが含まれていることに注意してください。

Copilot uses AI. Check for mistakes.
（この署名は、8ビットを通過させない転送方式によってファイルが破損した場合、これを容易に識別できるように設計されています。
署名は、改行コード変換やNULLバイトの削除、上位ビット落ち、パリティの変更などによって変化します）。
署名は、改行コード変換やNULLバイトの削除、上位ビット落ち、パリティの変更などによって変化します。）
</para>
</listitem>
</varlistentry>
Expand Down