From 53d838a893c22b3bc03ee8940cbc33c2891126e7 Mon Sep 17 00:00:00 2001 From: Yasuo Honda Date: Wed, 19 Aug 2026 14:08:30 +0900 Subject: [PATCH 1/5] i18n(ja): keep sample person-name data values in English to match code MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit In dev-guide-update-data.md, the prose rendered the author's name as ヘレン・ハルキ while the UPDATE statement uses "Helen Haruki". The same pattern appeared in the transaction guides, where ボブ/アリス in prose did not match the 'Bob'/'Alice' values used in the SQL/Java/Go code. Fix the prose so the sample person names match the actual data values used in the code samples: - ヘレン・ハルキ -> Helen Haruki - ボブ -> Bob, アリス -> Alice --- ...dev-guide-optimistic-and-pessimistic-transaction.md | 10 +++++----- develop/dev-guide-transaction-overview.md | 8 ++++---- develop/dev-guide-update-data.md | 2 +- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/develop/dev-guide-optimistic-and-pessimistic-transaction.md b/develop/dev-guide-optimistic-and-pessimistic-transaction.md index 47347a47b8404..06916316af385 100644 --- a/develop/dev-guide-optimistic-and-pessimistic-transaction.md +++ b/develop/dev-guide-optimistic-and-pessimistic-transaction.md @@ -24,7 +24,7 @@ aliases: ['/ja/tidb/stable/dev-guide-optimistic-and-pessimistic-transaction/','/ ## 悲観的トランザクション {#pessimistic-transactions} -以下のコードは、2つのスレッドを使用して、2人のユーザーが同じ本を悲観的トランザクションモードで購入するプロセスをシミュレートします。書店には10冊の本が残っています。ボブは6冊、アリスは4冊を購入します。2人はほぼ同時に注文を完了します。その結果、在庫にあるすべての本が売り切れます。 +以下のコードは、2つのスレッドを使用して、2人のユーザーが同じ本を悲観的トランザクションモードで購入するプロセスをシミュレートします。書店には10冊の本が残っています。Bobは6冊、Aliceは4冊を購入します。2人はほぼ同時に注文を完了します。その結果、在庫にあるすべての本が売り切れます。 @@ -919,7 +919,7 @@ mysql> SELECT * FROM users; ### 過剰販売を防ぐ例 {#an-example-that-prevents-overselling} -この例のタスクはより難易度が高いです。在庫が10冊残っているとします。ボブは7冊、アリスは4冊、そしてほぼ同時に注文したとします。何が起こるでしょうか？前の例のコードを再利用してこの課題を解決し、ボブの購入数量を6から7に変更することができます。 +この例のタスクはより難易度が高いです。在庫が10冊残っているとします。Bobは7冊、Aliceは4冊、そしてほぼ同時に注文したとします。何が起こるでしょうか？前の例のコードを再利用してこの課題を解決し、Bobの購入数量を6から7に変更することができます。 サンプルプログラムを実行します。 @@ -968,7 +968,7 @@ OPTIMISTIC=False ALICE=4 BOB=7 python3 txn_example.py `txn 2`先行してロックリソースを取得し、ストックを更新するため、 `txn 1`の`affected_rows`の戻り値は0となり、 `rollback`処理に入ります。 -注文の作成、ユーザー残高の減額、書籍在庫の減額を確認しましょう。アリスは4冊の注文に成功し、ボブは7冊の注文に失敗しました。残りの6冊は予想通り在庫があります。 +注文の作成、ユーザー残高の減額、書籍在庫の減額を確認しましょう。Aliceは4冊の注文に成功し、Bobは7冊の注文に失敗しました。残りの6冊は予想通り在庫があります。 ```sql mysql> SELECT * FROM books; @@ -999,7 +999,7 @@ mysql> SELECT * FROM users; ## 楽観的トランザクション {#optimistic-transactions} -以下のコードは、2つのスレッドを使用して、悲観的トランザクションの例と同様に、2人のユーザーが楽観的トランザクションで同じ本を購入するプロセスをシミュレートします。在庫には10冊の本が残っています。ボブは6冊、アリスは4冊購入します。2人はほぼ同時に注文を完了します。最終的に、在庫には本が残っていません。 +以下のコードは、2つのスレッドを使用して、悲観的トランザクションの例と同様に、2人のユーザーが楽観的トランザクションで同じ本を購入するプロセスをシミュレートします。在庫には10冊の本が残っています。Bobは6冊、Aliceは4冊購入します。2人はほぼ同時に注文を完了します。最終的に、在庫には本が残っていません。 ### 楽観的トランザクションの例を書く {#write-an-optimistic-transaction-example} @@ -1286,7 +1286,7 @@ mysql> SELECT * FROM users; ### 過剰販売を防ぐ例 {#an-example-that-prevents-overselling} -このセクションでは、過剰販売を防ぐ楽観的トランザクションの例を説明します。在庫に10冊の本が残っているとします。ボブは7冊、アリスは4冊購入します。2人はほぼ同時に注文をしました。何が起こるでしょうか？この要件に対処するために、楽観的トランザクションの例のコードを再利用できます。ボブの購入数を6冊から7冊に変更してください。 +このセクションでは、過剰販売を防ぐ楽観的トランザクションの例を説明します。在庫に10冊の本が残っているとします。Bobは7冊、Aliceは4冊購入します。2人はほぼ同時に注文をしました。何が起こるでしょうか？この要件に対処するために、楽観的トランザクションの例のコードを再利用できます。Bobの購入数を6冊から7冊に変更してください。 サンプルプログラムを実行します。 diff --git a/develop/dev-guide-transaction-overview.md b/develop/dev-guide-transaction-overview.md index bac31790452a1..c61acd9018b96 100644 --- a/develop/dev-guide-transaction-overview.md +++ b/develop/dev-guide-transaction-overview.md @@ -12,10 +12,10 @@ TiDBは完全な分散トランザクションをサポートし、 [楽観的 この章では、TiDBにおけるトランザクションの使用方法を紹介します。以下の例は、単純なトランザクションの処理を示しています。 -ボブはアリスに20ドルを送金したいと考えています。このトランザクションには2つの操作が含まれます。 +BobはAliceに20ドルを送金したいと考えています。このトランザクションには2つの操作が含まれます。 -- ボブの口座残高は 20 ドル減少します。 -- アリスの口座残高は 20 ドル増加しました。 +- Bobの口座残高は 20 ドル減少します。 +- Aliceの口座残高は 20 ドル増加しました。 トランザクションにより、上記の操作の両方が正常に実行されるか、または両方とも失敗するかを確認できます。 @@ -93,7 +93,7 @@ COMMIT; ROLLBACK; ``` -前の転送の例では、トランザクション全体をロールバックすると、アリスとボブの残高は変更されず、現在のトランザクションのすべての変更がキャンセルされます。 +前の転送の例では、トランザクション全体をロールバックすると、AliceとBobの残高は変更されず、現在のトランザクションのすべての変更がキャンセルされます。 ```sql TRUNCATE TABLE `users`; diff --git a/develop/dev-guide-update-data.md b/develop/dev-guide-update-data.md index 3b095e65f887e..67a6f26d760fc 100644 --- a/develop/dev-guide-update-data.md +++ b/develop/dev-guide-update-data.md @@ -54,7 +54,7 @@ UPDATE {table} SET {update_column} = {update_value} WHERE {filter_column} = {fil ### `UPDATE`例 {#update-example} -[著者](/develop/dev-guide-bookshop-schema-design.md#authors-table)が名前を**ヘレン・ハルキ**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。 +[著者](/develop/dev-guide-bookshop-schema-design.md#authors-table)が名前を**Helen Haruki**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。
From 99fb9fcad1f42f411a21c139358477f06d1ed883 Mon Sep 17 00:00:00 2001 From: Yasuo Honda Date: Wed, 19 Aug 2026 14:14:31 +0900 Subject: [PATCH 2/5] i18n(ja): use authors table name in link text to match code --- develop/dev-guide-update-data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop/dev-guide-update-data.md b/develop/dev-guide-update-data.md index 67a6f26d760fc..b71b7f5c22c49 100644 --- a/develop/dev-guide-update-data.md +++ b/develop/dev-guide-update-data.md @@ -54,7 +54,7 @@ UPDATE {table} SET {update_column} = {update_value} WHERE {filter_column} = {fil ### `UPDATE`例 {#update-example} -[著者](/develop/dev-guide-bookshop-schema-design.md#authors-table)が名前を**Helen Haruki**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。 +[authors](/develop/dev-guide-bookshop-schema-design.md#authors-table)が名前を**Helen Haruki**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。
From 04c4c1645da1d819125bd64d3dbf102099dfde9c Mon Sep 17 00:00:00 2001 From: Yasuo Honda Date: Wed, 19 Aug 2026 14:20:32 +0900 Subject: [PATCH 3/5] i18n(ja): make the authors table reference read naturally in Japanese --- develop/dev-guide-update-data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop/dev-guide-update-data.md b/develop/dev-guide-update-data.md index b71b7f5c22c49..05c65ab5ed764 100644 --- a/develop/dev-guide-update-data.md +++ b/develop/dev-guide-update-data.md @@ -54,7 +54,7 @@ UPDATE {table} SET {update_column} = {update_value} WHERE {filter_column} = {fil ### `UPDATE`例 {#update-example} -[authors](/develop/dev-guide-bookshop-schema-design.md#authors-table)が名前を**Helen Haruki**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。 +[authors](/develop/dev-guide-bookshop-schema-design.md#authors-table)テーブルの著者が名前を**Helen Haruki**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。
From 6cb10ed64e4cfbb657cec49d14f1603c37daed2d Mon Sep 17 00:00:00 2001 From: Yasuo Honda Date: Wed, 19 Aug 2026 14:22:48 +0900 Subject: [PATCH 4/5] i18n(ja): align authors table reference wording with the English source --- develop/dev-guide-update-data.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/develop/dev-guide-update-data.md b/develop/dev-guide-update-data.md index 05c65ab5ed764..1f464c71eed88 100644 --- a/develop/dev-guide-update-data.md +++ b/develop/dev-guide-update-data.md @@ -54,7 +54,7 @@ UPDATE {table} SET {update_column} = {update_value} WHERE {filter_column} = {fil ### `UPDATE`例 {#update-example} -[authors](/develop/dev-guide-bookshop-schema-design.md#authors-table)テーブルの著者が名前を**Helen Haruki**に変更したとします。テーブルを変更する必要があります。彼女の固有の`id`が**1で**あると仮定すると、フィルターは`id = 1`になります。 +[authors](/develop/dev-guide-bookshop-schema-design.md#authors-table)テーブルの著者が名前を**Helen Haruki**に変更したとします。[authors]テーブルを変更する必要があります。彼女の固有の`id`が**1**であると仮定すると、フィルターは`id = 1`になります。
From 10b9606f4eadc91df0b691ef0cf6fa5c26f01df1 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 19 Aug 2026 14:06:21 +0800 Subject: [PATCH 5/5] Update develop/dev-guide-transaction-overview.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> --- develop/dev-guide-transaction-overview.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/develop/dev-guide-transaction-overview.md b/develop/dev-guide-transaction-overview.md index c61acd9018b96..5d8d7145fb957 100644 --- a/develop/dev-guide-transaction-overview.md +++ b/develop/dev-guide-transaction-overview.md @@ -14,8 +14,8 @@ TiDBは完全な分散トランザクションをサポートし、 [楽観的 BobはAliceに20ドルを送金したいと考えています。このトランザクションには2つの操作が含まれます。 -- Bobの口座残高は 20 ドル減少します。 -- Aliceの口座残高は 20 ドル増加しました。 +- Bobの口座残高は 20 ドル減少します。 +- Aliceの口座残高は 20 ドル増加しました。 トランザクションにより、上記の操作の両方が正常に実行されるか、または両方とも失敗するかを確認できます。