Skip to content

Commit

Permalink
update copy for 17.0
Browse files Browse the repository at this point in the history
  • Loading branch information
koizumistr committed Mar 4, 2025
1 parent aceece4 commit 86b3ab3
Showing 1 changed file with 17 additions and 30 deletions.
47 changes: 17 additions & 30 deletions doc/src/sgml/ref/copy.sgml
Original file line number Diff line number Diff line change
Expand Up @@ -134,8 +134,8 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
the entire file is desired, the <literal>ON_ERROR</literal> clause can
be used to specify some other behavior.
-->
《機械翻訳》デフォルトでは、<command>COPY</command>は処理中にエラーが発生した場合に失敗します。
ファイル全体をロードするベストエフォート型の試みが必要な場合、<literal>ON_ERROR</literal>句を使用して別の動作を指定できます。
デフォルトでは、<command>COPY</command>は処理中にエラーが発生した場合に失敗します。
ファイル全体のロードをベストエフォートで試みるのが望ましい場合、<literal>ON_ERROR</literal>句を使用して別の動作を指定できます。
</para>
</refsect1>

Expand Down Expand Up @@ -187,10 +187,8 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
whose results are to be copied. Note that parentheses are required
around the query.
-->
《マッチ度[78.260870]》<link linkend="sql-select"><command>SELECT</command></link>、<link linkend="sql-values"><command>VALUES</command></link>、<link linkend="sql-insert"><command>INSERT</command></link>、<link linkend="sql-update"><command>UPDATE</command></link>あるいは<link linkend="sql-delete"><command>DELETE</command></link>コマンドで、その結果がコピーされます。
<link linkend="sql-select"><command>SELECT</command></link>、<link linkend="sql-values"><command>VALUES</command></link>、<link linkend="sql-insert"><command>INSERT</command></link>、<link linkend="sql-update"><command>UPDATE</command></link><link linkend="sql-delete"><command>DELETE</command></link>あるいは<link linkend="sql-merge"><command>MERGE</command></link>コマンドで、その結果がコピーされます。
問い合わせを括弧でくくる必要があることに注意してください。
《機械翻訳》結果をコピーする<link linkend="sql-select"><command>SELECT</command></link>、<link linkend="sql-values"><command>VALUES</command></link>、<link linkend="sql-insert"><command>INSERT</command></link>、<link linkend="sql-update"><command>UPDATE</command></link>、<link linkend="sql-delete"><command>DELETE</command></link>、または<link linkend="sql-merge"><command>MERGE</command></link>コマンド。
問い合わせの周りに括弧が必要です。
</para>
<para>
<!--
Expand All @@ -201,7 +199,7 @@ COPY { <replaceable class="parameter">table_name</replaceable> [ ( <replaceable
<literal>ALSO</literal> rule, nor an <literal>INSTEAD</literal> rule
that expands to multiple statements.
-->
《機械翻訳》<command>INSERT</command>、<command>UPDATE</command>、<command>DELETE</command><command>MERGE</command>問い合わせでは、<literal>RETURNING</literal>句を指定する必要があり、また、対象リレーションは条件付きルールも<literal>ALSO</literal>ルールも<literal>INSTEAD</literal>ルールも持たないこと
<command>INSERT</command>、<command>UPDATE</command>、<command>DELETE</command>および<command>MERGE</command>の問い合わせについては<literal>RETURNING</literal>句を付けなければならず、また、対象のリレーションには、複数の文に展開される条件付きルール、<literal>ALSO</literal>ルール、<literal>INSTEAD</literal>ルールがあってはなりません
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -326,14 +324,10 @@ Windowsユーザの場合、<literal>E''</literal>文字列を使用し、パス
a partitioned table.
This option is only allowed in <command>COPY FROM</command>.
-->
《マッチ度[80.180180]》あたかも<command>VACUUM FREEZE</command>コマンドを実行した後のように、行を凍結した状態のデータコピー処理を要求します。
あたかも<command>VACUUM FREEZE</command>コマンドを実行した後のように、行を凍結した状態のデータコピー処理を要求します。
これは、初期データロード処理用の性能オプションとしての利用を意図しています。
ロード元のテーブルが現在の副トランザクションで作成または切り詰めされ、開いているカーソルは存在せず、またこのトランザクションで保持される古めのスナップショットが存在しない場合のみ、行は凍結されます。
今のところ、パーティションテーブルでは<command>COPY FREEZE</command>を実行できません。
《機械翻訳》行がすでに凍結されているデータをコピーする要求を、<command>VACUUM FREEZE</command>コマンドの実行後と同様に行います。
これは、初期データ・ロードのパフォーマンス・オプションとして意図されています。
ローが凍結されるのは、ロード中のテーブルが現在のサブトランザクションで作成または切り捨てられた場合、カーソルが開いていない場合、およびこのトランザクションが保持している古いスナップショットがない場合のみです。
現在のところ、パーティション化されたテーブルに対して<command>COPY FREEZE</command>を実行することはできません。
このオプションは<command>COPY FROM</command>でのみ使用できます。
</para>
<para>
Expand Down Expand Up @@ -517,13 +511,10 @@ NULL値と空文字列を区別する必要がない場合は、テキスト形
This option is allowed only in <command>COPY FROM</command>, and only when
using <literal>CSV</literal> format.
-->
《マッチ度[75.175644]》指定された列の値をNULL文字列に対して比較しません。
指定された列の値をNULL文字列に対して比較しません。
NULL文字列が空であるデフォルトでは、空の値は引用符付けされていなくてもNULLではなく長さが0の文字列として読み取られることを意味します。
このオプションは<command>COPY FROM</command>において、かつ、<literal>CSV</literal>形式を使用する場合のみで許されます。
《機械翻訳》指定された列の値をNULL文字列と一致させないでください。
デフォルトの場合、NULL文字列が空の場合、これは、引用符が付いていない場合でも、空の値がNULLではなく長さ0の文字列として読み取られることを意味します。
<literal>*</literal>が指定されている場合、このオプションはすべての列に適用されます。
このオプションは<command>COPY FROM</command>でのみ、かつ<literal>CSV</literal>形式を使用する場合にのみ許可されます
このオプションは<command>COPY FROM</command>、かつ<literal>CSV</literal>形式を使用する場合のみで許されます
</para>
</listitem>
</varlistentry>
Expand All @@ -541,14 +532,10 @@ NULL文字列が空であるデフォルトでは、空の値は引用符付け
This option is allowed only in <command>COPY FROM</command>, and only when
using <literal>CSV</literal> format.
-->
《マッチ度[76.233184]》指定された列の値を、それが引用符付きであったとしても、NULL文字列と比較し、一致した場合は値を<literal>NULL</literal>にセットします。
指定された列の値を、それが引用符付きであったとしても、NULL文字列と比較し、一致した場合は値を<literal>NULL</literal>にセットします。
NULL文字列が空であるデフォルトでは、引用符付きの空文字列をNULLに変換します。
<literal>*</literal>が指定されている場合、このオプションはすべての列に適用されます。
このオプションは<command>COPY FROM</command>で、かつ<literal>CSV</literal>形式を使用する場合のみ許されます。
《機械翻訳》指定された列の値を、引用符で囲まれている場合でもNULL文字列と照合し、一致するものが見つかった場合は値を<literal>NULL</literal>に設定します。
デフォルトの場合、NULL文字列は空文字列です。
これは引用符で囲まれた空文字列を<literal>CSV</literal>形式を使用している場合にのみ変換します。
<literal>*</literal>を指定すると、このオプションは全ての列に適用されます。
このオプションは<command>COPY FROM</command>でのみ使用可能で、<literal>CSV</literal>形式を使用する場合にのみ有効です。
</para>
</listitem>
</varlistentry>
Expand All @@ -565,7 +552,7 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
<literal>ignore</literal> means discard the input row and continue with the next one.
The default is <literal>stop</literal>.
-->
《機械翻訳》列の入力値をデータ型に変換する際にエラーが発生した場合の動作を指定します。
列の入力値をデータ型に変換する際にエラーが発生した場合の動作を指定します。
<replaceable class="parameter">error_action</replaceable>の値が<literal>stop</literal>の場合、コマンドは失敗し、<literal>ignore</literal>の場合、入力行は破棄され、次の行に移ります。
デフォルトは<literal>stop</literal>です。
</para>
Expand All @@ -574,7 +561,7 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
The <literal>ignore</literal> option is applicable only for <command>COPY FROM</command>
when the <literal>FORMAT</literal> is <literal>text</literal> or <literal>csv</literal>.
-->
《機械翻訳》<literal>ignore</literal>オプションは、<literal>FORMAT</literal>が<literal>text</literal>または<literal>csv</literal>の場合の<command>COPY FROM</command>にのみ適用できます。
<literal>ignore</literal>オプションは、<literal>FORMAT</literal>が<literal>text</literal>または<literal>csv</literal>の場合に、<command>COPY FROM</command>にのみ適用できます。
</para>
<para>
<!--
Expand All @@ -585,7 +572,7 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
containing the line of the input file and the column name whose input
conversion has failed is emitted for each discarded row.
-->
《機械翻訳》少なくとも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>メッセージが出力されます。
</para>
</listitem>
Expand Down Expand Up @@ -618,7 +605,7 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
<literal>verbose</literal> is specified, additional messages are emitted
during processing.
-->
《機械翻訳》<command>COPY</command>コマンドが出力するメッセージの量を指定します。
<command>COPY</command>コマンドが出力するメッセージの量を指定します。
<literal>default</literal>または<literal>verbose</literal>です。
<literal>verbose</literal>が指定された場合、処理中に追加のメッセージが出力されます。
</para>
Expand All @@ -627,7 +614,7 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字
This is currently used in <command>COPY FROM</command> command when
<literal>ON_ERROR</literal> option is set to <literal>ignore</literal>.
-->
《機械翻訳》これは現在、<literal>ON_ERROR</literal>オプションが<literal>ignore</literal>に設定されている場合の<command>COPY FROM</command>コマンドで使用されます。
これは現在、<literal>ON_ERROR</literal>オプションが<literal>ignore</literal>に設定されている場合に<command>COPY FROM</command>コマンドで使用されます。
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -891,11 +878,11 @@ COPY <replaceable class="parameter">count</replaceable>
operation. <command>VACUUM</command> should be used to recover the
wasted space.
-->
《機械翻訳》<command>COPY FROM</command>コマンドは、入力行を物理的にテーブルに挿入します
<command>COPY FROM</command>コマンドは、処理の進行中に入力行を物理的にテーブルに挿入します
コマンドが失敗した場合、これらの行は削除された状態のままになります。
これらの行は表示されませんが、ディスク領域を占有します。
これは、大規模なコピー操作の途中で失敗した場合、かなりのディスク領域を浪費することになります
失われた領域を回復するには<command>VACUUM</command>を使用してください。
これは、大規模なコピー操作の途中で失敗した場合、かなりのディスク領域を浪費することになるかもしれません
浪費された領域を回復するには<command>VACUUM</command>を使用してください。
</para>

<para>
Expand Down

0 comments on commit 86b3ab3

Please sign in to comment.