diff --git a/doc/src/sgml/ref/copy.sgml b/doc/src/sgml/ref/copy.sgml index 74d3db8932a..98e2780e91d 100644 --- a/doc/src/sgml/ref/copy.sgml +++ b/doc/src/sgml/ref/copy.sgml @@ -304,11 +304,9 @@ Windowsユーザの場合、E''文字列を使用し、パス The default is text. See below for details. --> -《マッチ度[63.241107]》読み取りまたは書き込みに使用するデータ形式を選択します。 +読み取りまたは書き込みに使用するデータ形式を選択します。 text、csv（カンマ区切り値）、またはbinaryです。 デフォルトはtextです。 -《機械翻訳》読取りまたは書込みの対象となるデータフォーマットを、text、csvカンマ区切り形式またはbinaryの中から選択します。 -デフォルトはtextです。 詳細は、後述のを参照してください。 @@ -329,16 +327,11 @@ Windowsユーザの場合、E''文字列を使用し、パス a partitioned table or foreign table. This option is only allowed in COPY FROM. --> -《マッチ度[88.636364]》あたかもVACUUM FREEZEコマンドを実行した後のように、行を凍結した状態のデータコピー処理を要求します。 +あたかもVACUUM FREEZEコマンドを実行した後のように、行を凍結した状態のデータコピー処理を要求します。 これは、初期データロード処理用の性能オプションとしての利用を意図しています。 ロード元のテーブルが現在の副トランザクションで作成または切り詰めされ、開いているカーソルは存在せず、またこのトランザクションで保持される古めのスナップショットが存在しない場合のみ、行は凍結されます。 -今のところ、パーティションテーブルではCOPY FREEZEを実行できません。 +今のところ、パーティションテーブルと外部テーブルではCOPY FREEZEを実行できません。 このオプションはCOPY FROMでのみ使用できます。 -《機械翻訳》VACUUM FREEZEデータの実行後と同様に、行がすでに固定されているコマンドのコピーを要求します。 -これは、初期のパフォーマンスロードのデータオプションとして意図されています。 -ロード中のテーブルが現在サブトランザクションで作成または切り捨てられ、カーソルオープンがなく、このトランザクションに保持されている古いスナップショットがない場合にのみ、行が固定されます。 -現在、COPY FREEZEパーティション化されたテーブルまたは外部テーブルでを実行することはできません。 -このオプションはCOPY FROMでのみ許可されています。 -《マッチ度[74.497992]》少なくとも1行が破棄された場合、COPY FROMの最後に、無視された行数を含むNOTICEメッセージが出力されます。 +少なくとも1行が破棄された場合、COPY FROMの最後に、無視された行数を含むNOTICEメッセージが出力されます。 LOG_VERBOSITYオプションがverboseに設定されている場合、破棄された各行に対して、入力ファイルの行と入力変換に失敗した列名を含むNOTICEメッセージが出力されます。 -《機械翻訳》NOTICE無視されたメッセージカウントを含む行は、COPY FROM少なくとも1つの行が破棄された場合の最後にエミットされます。 -LOG_VERBOSITYオプションがverboseに設定されている場合、NOTICE入力されたファイルの直線と、入力された変換が失敗したカラム名前を含む行は、破棄されたごとにエミットされます。 -silentに設定されている場合、無視された行に関してメッセージはエミットされません。 -メッセージ +silentに設定されている場合、無視された行に関してメッセージは出力されません。 @@ -610,10 +600,10 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字 allows an unlimited number of errors, meaning COPY will skip all erroneous data. --> -《機械翻訳》ON_ERRORがignoreに設定されている場合、カラムの入力値をデータタイプに変換するときに許容されるエラーの最大数を指定します。 -入力が指定された値よりも多くのエラーを引き起こした場合、COPYコマンドはON_ERRORに設定されている場合でも失敗します。 -ignoreこの句はON_ERROR=ignoreおよびmaxerrorは正のbigintである必要があります。 -指定されていない場合、ON_ERROR=ignoreはエラーの数に制限がないため、COPYはエラーのあるすべてのデータをスキップします。 +ON_ERRORがignoreに設定されている場合、列の入力値をそのデータ型に変換するときに許容されるエラーの最大数を指定します。 +入力が指定された値よりも多くのエラーを引き起こした場合、COPYコマンドはON_ERRORがignoreに設定されている場合でも失敗します。 +この句はON_ERROR=ignoreと組み合わせて使用することが必要で、またmaxerrorは正のbigintでなければなりません。 +指定されていない場合、ON_ERROR=ignoreはエラーの数に制限がないため、COPYはエラーのあるデータをすべてスキップします。 @@ -647,12 +637,10 @@ NULL文字列が空であるデフォルトでは、引用符付きの空文字 emitted during processing. silent suppresses both verbose and default messages. --> -《マッチ度[61.631420]》COPYコマンドが出力するメッセージの量を指定します。 -defaultまたはverboseです。 +COPYコマンドが出力するメッセージの量を指定します。 +default、verboseまたはsilentです。 verboseが指定された場合、処理中に追加のメッセージが出力されます。 -《機械翻訳》COPYコマンド:default、verboseまたはsilent。 -verboseが指定されている場合は、処理中に追加のメッセージが発行されます。 -silent VERBOSEとデフォルトの両方のメッセージが抑制されます。 +silentでは追加とデフォルトの両方のメッセージが抑制されます。 -《機械翻訳》COPY TOプレーン・テーブルと移入されたマテリアライズド・ビューで使用できます。 -例の場合、COPY table TOはSELECT * FROM ONLY tableと同じ行をコピーします。 -ただし、テーブルパーティション、継承の子テーブル、またはビューなど、他のリレーションタイプを直接サポートすることはありません。 +COPY TOは通常のテーブルとデータが格納されたマテリアライズドビューで使用できます。 +例えば、COPY table TOはSELECT * FROM ONLY tableと同じ行をコピーします。 +ただし、パーティションテーブル、継承の子テーブル、またはビューなど、他のリレーションタイプを直接サポートすることはありません。 このようなリレーションからすべての行をコピーするには、COPY (SELECT * FROM table) TOを使用します。 @@ -988,12 +976,10 @@ COPY count context the rule is needed to be able to end the operation before the end of the script. --> -《機械翻訳》データの終わりは、バックスラッシュ-ピリオド\.のみを含む行で表すことができます。 -データの終わりは完全に機能するため、ファイルから読み取る場合はファイルの終わりマーカーは必要ありません。 -コンテキストでは、この規定は逆方向互換性に対してのみ存在します。 -ただし、psqlでは、\.を使用してCOPY FROM STDINオペレーションを終了します。 -つまり、SQLスクリプトでは-直線COPYデータを読み取ります。 -そのコンテキストでは、ルールはオペレーション前をスクリプトの終わりで終了できる必要があります。 +データの終了は、バックスラッシュとピリオド（\.）のみから構成される1行で表されます。 +ファイルの終了により同じ動作になるので、ファイルからの読み込みの場合はデータの終了の印は不要です。そのような状況では、この規定は後方互換性のためだけに存在します。 +ただし、psqlでは、\.を使用してCOPY FROM STDIN操作（つまり、SQLスクリプト内のインラインCOPYデータの読み込み）を終了します。 +そのような状況では、スクリプトの終わりの前に操作を終了できるようにするためこの規則が必要です。 @@ -1130,7 +1116,7 @@ COPY count --> 上表で記載されていないバックスラッシュ付きの文字はすべて、その文字自体として解釈されます。 しかし、不要なバックスラッシュの追加には注意してください。 -偶然にデータの終わりを示す印（\.）やヌル文字列（デフォルトでは\N）と合致する文字列を生成してしまうかもしれないためです。 +偶然にデータの終了の印（\.）やヌル文字列（デフォルトでは\N）と合致する文字列を生成してしまうかもしれないためです。 これらの文字列は他のバックスラッシュの処理を行う前に解釈されます。 @@ -1199,7 +1185,7 @@ COPY count PostgreSQL's standard text format, it produces and recognizes the common CSV escaping mechanism. --> -《マッチ度[94.285714]》この形式オプションは、スプレッドシートなど他の多くのプログラムで使用されるカンマ区切り値（CSV）ファイル形式をインポート、エクスポートするために使用されます。 +この形式オプションは、スプレッドシートなど他の多くのプログラムで使用されるカンマ区切り値（CSV）ファイル形式をインポート、エクスポートするために使用されます。 PostgreSQLの標準テキスト形式で使用されるエスケープ規則の代わりに、一般的なCSVのエスケープ機構を生成、認識します。 @@ -1257,8 +1243,8 @@ COPY count only \., whether it is text or CSV mode. --> -《機械翻訳》バックスラッシュはCSVフォーマットの特殊文字ではないため、データ\.で使用されるテキストモード終了マーカーは、通常、CSVデータを読み取る際には特殊文字として扱われません。 -例外は、psqlはCOPY FROM STDINオペレーションを終了します(つまり、-直線COPYSQLスクリプトのデータを読み取ると、テキストであってもCSVモードであっても\.のみを含む行で終了します。 +バックスラッシュはCSV形式では特殊文字でないため、テキストモードで使われるデータの終了の印（\.）は、通常、CSVデータを読み取る際には特殊文字として扱われません。 +例外は、psqlが、テキストであってもCSVモードであっても\.のみを含む行でCOPY FROM STDIN操作（つまり、SQLスクリプト内のインラインCOPYデータの読み込み）を終了することです。 @@ -1270,8 +1256,8 @@ COPY count versions, COPY TO will quote \. when it's alone on a line, even though this is no longer necessary. --> -《機械翻訳》PostgreSQL前v18のバージョンでは、別のデータから読み込んだ場合でも、常にクォートされていない\.ファイルの終わりのマーカーとしてを認識していました。 -古いバージョンの互換性では、COPY TOは1行に引用符\.がある場合、これが不要になったとしても引用符で囲みます。 +PostgreSQLのv18以前のバージョンでは、別のファイルから読み込んだ場合でも、引用符で囲まれていない\.をデータの終了の印として認識していました。 +古いバージョンとの互換性のため、COPY TOは1行に\.だけがある場合、必要でないとしてもこれを引用符で囲みます。 @@ -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.) --> -PGCOPY\n\377\r\n\0という11バイトの並びです。 -この署名の必須部分にNULLバイトが含まれていることに注意してください +PGCOPY\n\377\r\n\0という11バイトの並びです — この署名の必須部分にNULLバイトが含まれていることに注意してください。 （この署名は、8ビットを通過させない転送方式によってファイルが破損した場合、これを容易に識別できるように設計されています。 -署名は、改行コード変換やNULLバイトの削除、上位ビット落ち、パリティの変更などによって変化します）。 +署名は、改行コード変換やNULLバイトの削除、上位ビット落ち、パリティの変更などによって変化します。）