user-manag.sgml の 18.0 対応です by higuchi-daisuke · Pull Request #3576 · pgsql-jp/jpug-doc

higuchi-daisuke · 2025-12-28T00:19:45Z

No description provided.

Copilot

Pull request overview

This pull request updates the Japanese translation of the PostgreSQL user management documentation (user-manag.sgml) for version 18.0. The changes primarily involve refining existing translations, removing machine translation markers (《マッチ度》 and 《機械翻訳》), and improving the clarity and naturalness of the Japanese text.

Key Changes:

Removal of all machine translation quality indicators and redundant translation candidates
Refinement of technical terminology and phrasing for better clarity in Japanese
Improvements to consistency in markup tags (e.g., <command>SET ROLE</command> instead of just <command>SET</command>)

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2025-12-28T10:47:42Z

doc/src/sgml/user-manag.sgml

-《機械翻訳》<literal>pg_write_all_data</literal>は、すべてのデータ（テーブル、ビュー、シーケンス）を、<command>INSERT</command>、<command>UPDATE</command>、および<command>DELETE</command>これらのオブジェクトに対する権限と<literal>USAGE</literal>すべてのスキーマに対する権限を持つかのように記述できます。
-このロールは、バイパス行-レベルセキュリティ(RLS)ポリシーを持ちません。
-RLSが使用されている場合、管理者は<literal>BYPASSRLS</literal>このロールが付与されているロールに対して設定することができます。
+<literal>pg_write_all_data</literal>は、すべてのデータ（テーブル、ビュー、シーケンス）について、これらのオブジェクトの<command>INSERT</command>、<command>UPDATE</command>、および<command>DELETE</command>権限とすべてのスキーマの<command>USAGE</command>権限を持っているかのように書き込むことを許可します。


The command tag should be <literal> instead of <command> for consistency. The line mentions USAGE permission for schemas, and earlier in line 1079, <literal>USAGE</literal> is correctly used. This line should also use <literal>USAGE</literal> instead of <command>USAGE</command>.

Copilot · 2025-12-28T10:47:42Z

doc/src/sgml/user-manag.sgml

-これらはすべてデータベースをバイパスします。
-レベルパーミッションは、アクセスファイルを直接チェックし、スーパーユーザレベルアクセスを取得するために使用される可能性があります。
-したがって、これらの役割をユーザに付与するときは、十分に注意する必要があります。
+これらのロールは、信頼はできるがスーパーユーザではないロールが、データベースを実行するユーザとしてデータベースサーバ上のファイルにアクセスしたりプログラムを実行したりすることを、管理者が許可できるようにすることを意図としています。


「意図としています」は不自然な表現です。正しくは「意図しています」または「目的としています」にすべきです。

Suggested change

これらのロールは、信頼はできるがスーパーユーザではないロールが、データベースを実行するユーザとしてデータベースサーバ上のファイルにアクセスしたりプログラムを実行したりすることを、管理者が許可できるようにすることを意図としています。

これらのロールは、信頼はできるがスーパーユーザではないロールが、データベースを実行するユーザとしてデータベースサーバ上のファイルにアクセスしたりプログラムを実行したりすることを、管理者が許可できるようにすることを意図しています。

Copilot · 2025-12-28T10:47:42Z

doc/src/sgml/user-manag.sgml

 -->
-《機械翻訳》<literal>pg_signal_autovacuum_worker</literal>この場合、信号を発信するオートバキューム就業者は現在テーブルのバキュームにキャンセルするか、セッションを終了できます。
-「<xref linkend="functions-admin-signal"/>」を参照してください。
+<literal>pg_signal_autovacuum_worker</literal>は、自動バキュームワーカーに対して、現在のテーブルのバキュームをキャンセルさせたりセッションを終了させたりするためのシグナルを送信することを許可します。


「キャンセルさせたりセッションを終了させたりする」という表現で「させたり」が重複しています。「キャンセルしたりセッションを終了させたりする」とすべきです。

Suggested change

<literal>pg_signal_autovacuum_worker</literal>は、自動バキュームワーカーに対して、現在のテーブルのバキュームをキャンセルさせたりセッションを終了させたりするためのシグナルを送信することを許可します。

<literal>pg_signal_autovacuum_worker</literal>は、自動バキュームワーカーに対して、現在のテーブルのバキュームをキャンセルしたりセッションを終了させたりするためのシグナルを送信することを許可します。

Copilot · 2025-12-28T10:47:42Z

doc/src/sgml/user-manag.sgml

-このノートでは、ロールが所有するバックエンドのシグナリングは許可されません。
-「<xref linkend="functions-admin-signal"/>」を参照してください。
-スーパーユーザ
+<literal>pg_signal_backend</literal>は、他のバックエンドに対して、問い合わせのキャンセルまたはそのセッションを終了させるためのシグナルを送信することを許可します。


「問い合わせのキャンセルまたはそのセッションを終了させる」という表現で、並列構造が不一致です。「問い合わせをキャンセルしたりそのセッションを終了させたりする」または「問い合わせのキャンセルまたはそのセッションの終了を行う」のように統一すべきです。

Suggested change

<literal>pg_signal_backend</literal>は、他のバックエンドに対して、問い合わせのキャンセルまたはそのセッションを終了させるためのシグナルを送信することを許可します。

<literal>pg_signal_backend</literal>は、他のバックエンドに対して、問い合わせをキャンセルさせたりそのセッションを終了させたりするためのシグナルを送信することを許可します。

higuchi-daisuke · 2025-12-28T23:38:54Z

copilotからの指摘を反映させました。

noborus · 2026-01-03T22:59:57Z

doc/src/sgml/user-manag.sgml

 -->
-《マッチ度[70.531401]》<link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link>を実行するために、ユーザに対してデータベースへの<literal>CREATE</literal>権限を許可する
-《機械翻訳》<literal>pg_create_subscription</literal>は、<literal>CREATE</literal>データベースのパーミッションを持つユーザが<link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link>を発行できるようにします。
+<literal>pg_create_subscription</literal>は、<link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link>を実行するために、ユーザに対してデータベースでの<literal>CREATE</literal>権限を許可します。


元からだったようですが、「権限を許可」が変な気がします。
「データベースでの<literal>CREATE</literal>権限を持つユーザに対して、<link linkend="sql-createsubscription"><command>CREATE SUBSCRIPTION</command></link>の実行を許可」ではないでしょうか。

higuchi-daisuke · 2026-01-04T02:36:08Z

レビューありがとうございます。ご指摘の通りと思いましたので修正いたしました。

noborus

ありがとうございます。
確認しました。

tatsuo-ishii

一通り確認しました。

tatsuo-ishii · 2026-01-11T09:28:13Z

doc/src/sgml/user-manag.sgml

-《マッチ度[94.444444]》グループロールのメンバは、2つの方法でロールの権限を使用できます。
-1つ目として、メンバ資格が<literal>SET</literal>オプションで付与されたメンバロールは、<link linkend="sql-set-role"><command>SET</command></link>オプションを使用して、一時的にグループロール<quote>になる</quote>ことができます。
+グループロールのメンバは、2つの方法でロールの権限を使用できます。
+1つ目として、メンバ資格が<literal>SET</literal>オプションで付与されたメンバロールは、<link linkend="sql-set-role"><command>SET ROLE</command></link>オプションを使用して、一時的にグループロールに<quote>なる</quote>ことができます。


ここでのSE ROLEはオプションではなくSQLコマンドのことなので、「SET ROLEオプション」の「オプション」は、削除するのが良いと思います。

tatsuo-ishii · 2026-01-11T09:39:54Z

doc/src/sgml/user-manag.sgml

-このロールは、<literal>pg_read_all_settings</literal>、<literal>pg_read_all_stats</literal>および<literal>pg_stat_scan_tables</literal>のメンバです。
-《機械翻訳》<literal>pg_monitor</literal>さまざまな監視ビューおよび関数の読み取り/実行を許可します。
-このロールは<literal>pg_read_all_settings</literal>、<literal>pg_read_all_stats</literal>および<literal>pg_stat_scan_tables</literal>のメンバです。
+<literal>pg_monitor</literal>は、各種の監視ビューや機能を読み取り/実行することを許可します。


この"functions"は機能ではなくて関数ではないでしょうか？

tatsuo-ishii · 2026-01-11T09:40:50Z

doc/src/sgml/user-manag.sgml

 -->
-《マッチ度[53.435115]》通常スーパーユーザのみが読み取れる、全ての設定変数を読み取る
-《機械翻訳》<literal>pg_read_all_settings</literal>により、通常はスーパーユーザのみに設定される変数も含め、全ての可視変数を読み込むことができます。
+<literal>pg_read_all_settings</literal>は、通常スーパーユーザのみが見える、すべての設定変数を読み取ることを許可します。


「のみが見える」→「のみに見える」

tatsuo-ishii · 2026-01-11T09:41:28Z

doc/src/sgml/user-manag.sgml

 -->
-《マッチ度[64.457831]》通常スーパーユーザのみが読み取れる、すべてのpg_stat_*ビューを読み取り、各種の統計関連のエクステンションを使用する
-《機械翻訳》<literal>pg_read_all_stats</literal>全てのpg_stat_*ビューを読み込むことができ、また、通常はスーパーユーザのみに統計処理されるものも含め、様々な可視関連の拡張を使用することができます。
+<literal>pg_read_all_stats</literal>は、通常スーパーユーザのみが見える、すべてのpg_stat_*ビューの読み取りと各種統計関連の拡張の使用を許可します。


「のみが見える」→「のみに見える」

higuchi-daisuke · 2026-01-20T10:49:18Z

レビューありがとうございます。また、確認が遅くなりすみません。
ご指摘の通りと思いましたので、いただいたコメントの通り修正いたしました。

higuchi-daisuke added 2 commits December 23, 2025 12:15

Update doc/src/sgml/user-manag.sgml for 18.0.

beffd9d

Update

ab8261d

github-actions bot added the レビュー待ち label Dec 28, 2025

noborus requested a review from Copilot December 28, 2025 10:45

Copilot started reviewing on behalf of noborus December 28, 2025 10:46 View session

Copilot AI reviewed Dec 28, 2025

View reviewed changes

Update based on copilot comments for user-manag.sgml

47bc606

noborus reviewed Jan 3, 2026

View reviewed changes

noborus added 指摘事項あり and removed レビュー待ち labels Jan 3, 2026

Update based on review comments for user-manag.sgml

42e64cc

github-actions bot added 再レビュー待ち and removed 指摘事項あり labels Jan 4, 2026

noborus approved these changes Jan 7, 2026

View reviewed changes

noborus added 他にも誰か見て（レビュー済み） and removed 再レビュー待ち labels Jan 7, 2026

tatsuo-ishii requested changes Jan 11, 2026

View reviewed changes

tatsuo-ishii added 指摘事項あり and removed 他にも誰か見て（レビュー済み） labels Jan 11, 2026

Update based on review comments for doc/src/sgml/user-manag.sgml

4919947

github-actions bot added 再レビュー待ち and removed 指摘事項あり labels Jan 20, 2026

	これらのロールは、信頼はできるがスーパーユーザではないロールが、データベースを実行するユーザとしてデータベースサーバ上のファイルにアクセスしたりプログラムを実行したりすることを、管理者が許可できるようにすることを意図としています。
	これらのロールは、信頼はできるがスーパーユーザではないロールが、データベースを実行するユーザとしてデータベースサーバ上のファイルにアクセスしたりプログラムを実行したりすることを、管理者が許可できるようにすることを意図しています。

	<literal>pg_signal_autovacuum_worker</literal>は、自動バキュームワーカーに対して、現在のテーブルのバキュームをキャンセルさせたりセッションを終了させたりするためのシグナルを送信することを許可します。
	<literal>pg_signal_autovacuum_worker</literal>は、自動バキュームワーカーに対して、現在のテーブルのバキュームをキャンセルしたりセッションを終了させたりするためのシグナルを送信することを許可します。

	<literal>pg_signal_backend</literal>は、他のバックエンドに対して、問い合わせのキャンセルまたはそのセッションを終了させるためのシグナルを送信することを許可します。
	<literal>pg_signal_backend</literal>は、他のバックエンドに対して、問い合わせをキャンセルさせたりそのセッションを終了させたりするためのシグナルを送信することを許可します。

Conversation

higuchi-daisuke commented Dec 28, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Dec 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 28, 2025

Choose a reason for hiding this comment

Uh oh!

higuchi-daisuke commented Dec 28, 2025

Uh oh!

noborus Jan 3, 2026

Choose a reason for hiding this comment

Uh oh!

higuchi-daisuke commented Jan 4, 2026

Uh oh!

noborus left a comment

Choose a reason for hiding this comment

Uh oh!

tatsuo-ishii left a comment

Choose a reason for hiding this comment

Uh oh!

tatsuo-ishii Jan 11, 2026

Choose a reason for hiding this comment

Uh oh!

tatsuo-ishii Jan 11, 2026

Choose a reason for hiding this comment

Uh oh!

tatsuo-ishii Jan 11, 2026

Choose a reason for hiding this comment

Uh oh!

tatsuo-ishii Jan 11, 2026

Choose a reason for hiding this comment

Uh oh!

higuchi-daisuke commented Jan 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants