high-availability.sgmlのPostgreSQL 17.0対応#3187
high-availability.sgmlのPostgreSQL 17.0対応#3187KenichiroTanaka merged 3 commits intopgsql-jp:doc_ja_17from
Conversation
noborus
left a comment
noborus
left a comment
There was a problem hiding this comment.
「これらの方法の欠点は、しばしば必要以上のWALセグメントを保持することで、これらに対してレプリケーションスロットは必要とされる数のセグメントしか保持しません。」
英語では1センテンスでしたが、日本語では2つに分けた方がわかりやすいかもしれません。原本をふまえ1センテンスで書いています。
もうちょっと長くなると分ける方がよいですが、これぐらいだとこのままで良いと思いました。
「ロジカルレプリケーションスロット」とするか、「論理レプリケーションスロット」とするかで悩みましたが、多くの文言が「論理レプリケーション」としていたためこちらを採用しています。
はい。「論理レプリケーション」で良いです。
pg_statio_ という書き方は原本を踏襲しています。 pg_statio_* とした方がわかりやすいかもしれませんが好みの範疇と思いました。
これは変えないでください。変えるなら原文からでお願いします。
doc/src/sgml/high-availability.sgml
Outdated
| requests will wait forever for the standby to appear. | ||
| --> | ||
| 《マッチ度[80.758017]》トランザクションの待機中にスタンバイサーバを再作成する必要がある場合、pg_backup_start()およびpg_backup_stop()を実行するコマンドを<varname>synchronous_commit</varname> = <literal>off</literal>であるセッション内で確実に実行してください。 | ||
| トランザクションの待機中にスタンバイサーバを再作成する必要がある場合、<function>pg_backup_start()</function>関数および<function>pg_backup_stop()</function>関数を実行するコマンドを<varname>synchronous_commit</varname> = <literal>off</literal>であるセッション内で確実に実行してください。 |
There was a problem hiding this comment.
commands -> functions なので「実行するコマンドを」は単純に削って良いと思います
There was a problem hiding this comment.
ありがとうございます、コメントのとおり、原文がcommandsからfunctionsに変更されているので該当箇所を削除しました
KenichiroTanaka
left a comment
KenichiroTanaka
left a comment
There was a problem hiding this comment.
対応ありがとうございます。
細かいですが１点だけ、気づくところがありましたので見ていただいてもいいでしょうか。
doc/src/sgml/high-availability.sgml
Outdated
| --> | ||
| 《機械翻訳》レプリケーションスロットは、サーバが非常に多くのWALセグメントを保持し、<literal>pg_wal</literal>に割り当てられたスペースを一杯にしてしまう可能性があることに注意してください。 | ||
| レプリケーションスロットは、サーバが非常に多くのWALセグメントを保持し、<literal>pg_wal</literal>に割り当てられた領域を一杯にしてしまう可能性があることに注意してください。 | ||
| <xref linkend="guc-max-slot-wal-keep-size"/>は、レプリケーションスロットが保持するWALファイルのサイズを制限するために使用できます。 |
There was a problem hiding this comment.
細かいですが１点だけ、修正をお願いします。
機械翻訳の箇所ですが、
「レプリケーションスロットが保持するWALファイルのサイズを制限する」
は、原文通り受け身形で
「レプリケーションスロットによって保持されるWALファイルのサイズを制限する」
でお願いしてもいいでしょうか。
今のままだとレプリケーションスロットがWALを保持する機能を持つようにも理解できるためです。
レプリケーションスロットの概念が少し難しいため、誤解を招く表現はできるだけ減らせればと考えています。
There was a problem hiding this comment.
ご確認ありがとうございます。
該当箇所をコメントいただいたとおり
「レプリケーションスロットによって保持されるWALファイルのサイズを制限する」
に修正しました。
KenichiroTanaka
left a comment
KenichiroTanaka
left a comment
There was a problem hiding this comment.
早速の対応ありがとうございました。
複数名のレビューが通りましたので本ファイルはここでマージします。
3 participants
はじめてのPRです。対応漏れや不足がありましたらご指摘いただければと思います、よろしくお願いします。
「これらの方法の欠点は、しばしば必要以上のWALセグメントを保持することで、これらに対してレプリケーションスロットは必要とされる数のセグメントしか保持しません。」
英語では1センテンスでしたが、日本語では2つに分けた方がわかりやすいかもしれません。原本をふまえ1センテンスで書いています。
「ロジカルレプリケーションスロット」とするか、「論理レプリケーションスロット」とするかで悩みましたが、多くの文言が「論理レプリケーション」としていたためこちらを採用しています。
pg_statio_という書き方は原本を踏襲しています。pg_statio_*とした方がわかりやすいかもしれませんが好みの範疇と思いました。