diff --git a/TOC-tidb-cloud-essential.md b/TOC-tidb-cloud-essential.md index 2652f517e5b54..afcda93cfd4f9 100644 --- a/TOC-tidb-cloud-essential.md +++ b/TOC-tidb-cloud-essential.md @@ -53,7 +53,7 @@ - 監視と警告 - [概要](/tidb-cloud/monitor-tidb-cluster.md) - [組み込みの指標](/tidb-cloud/built-in-monitoring.md) - - [トップRU](/tidb-cloud/top-ru.md) + - [Top RU](/tidb-cloud/top-ru.md) ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) - [内蔵アラート機能](/tidb-cloud/monitor-built-in-alerting.md) - [TiDB CloudをPrometheusおよびGrafanaと統合する](/tidb-cloud/prometheus-grafana-integration.md) - アラート通知を購読する diff --git a/TOC-tidb-cloud-premium.md b/TOC-tidb-cloud-premium.md index 47c3d487c172d..74349731853b2 100644 --- a/TOC-tidb-cloud-premium.md +++ b/TOC-tidb-cloud-premium.md @@ -52,7 +52,7 @@ - 監視と警告 - [概要](/tidb-cloud/monitor-tidb-cluster.md) - [組み込みの指標](/tidb-cloud/premium/built-in-monitoring-premium.md) - - [トップRU](/tidb-cloud/top-ru.md) + - [Top RU](/tidb-cloud/top-ru.md) ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png) - [内蔵アラート機能](/tidb-cloud/monitor-built-in-alerting.md) - [TiDB CloudをPrometheusおよびGrafanaと統合する](/tidb-cloud/prometheus-grafana-integration.md) - アラート通知を購読する @@ -223,6 +223,7 @@ - [`ANALYZE TABLE`](/sql-statements/sql-statement-analyze-table.md) - [`BATCH`](/sql-statements/sql-statement-batch.md) - [`BEGIN`](/sql-statements/sql-statement-begin.md) + - [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) - [`CANCEL IMPORT JOB`](/sql-statements/sql-statement-cancel-import-job.md) - [`COMMIT`](/sql-statements/sql-statement-commit.md) - [`CREATE [GLOBAL|SESSION] BINDING`](/sql-statements/sql-statement-create-binding.md) @@ -238,6 +239,7 @@ - [`DELETE`](/sql-statements/sql-statement-delete.md) - [`DESC`](/sql-statements/sql-statement-desc.md) - [`DESCRIBE`](/sql-statements/sql-statement-describe.md) + - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) - [`DO`](/sql-statements/sql-statement-do.md) - [`DROP [GLOBAL|SESSION] BINDING`](/sql-statements/sql-statement-drop-binding.md) - [`DROP DATABASE`](/sql-statements/sql-statement-drop-database.md) @@ -292,6 +294,7 @@ - [`SHOW CREATE TABLE`](/sql-statements/sql-statement-show-create-table.md) - [`SHOW CREATE USER`](/sql-statements/sql-statement-show-create-user.md) - [`SHOW DATABASES`](/sql-statements/sql-statement-show-databases.md) + - [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) - [`SHOW ENGINES`](/sql-statements/sql-statement-show-engines.md) - [`SHOW ERRORS`](/sql-statements/sql-statement-show-errors.md) - [`SHOW FIELDS FROM`](/sql-statements/sql-statement-show-fields-from.md) @@ -310,6 +313,7 @@ - [`SHOW STATS_META`](/sql-statements/sql-statement-show-stats-meta.md) - [`SHOW STATS_TOPN`](/sql-statements/sql-statement-show-stats-topn.md) - [`SHOW STATUS`](/sql-statements/sql-statement-show-status.md) + - [`SHOW TABLE DISTRIBUTION`](/sql-statements/sql-statement-show-table-distribution.md) - [`SHOW TABLE NEXT_ROW_ID`](/sql-statements/sql-statement-show-table-next-rowid.md) - [`SHOW TABLE STATUS`](/sql-statements/sql-statement-show-table-status.md) - [`SHOW TABLES`](/sql-statements/sql-statement-show-tables.md) @@ -464,6 +468,7 @@ - [サーバー状態変数](/status-variables.md) - [テーブルフィルター](/table-filter.md) - [外部ストレージサービスのURI形式](/external-storage-uri.md) + - [DDL ステートメントに埋め込まれた `ANALYZE`](/ddl_embedded_analyze.md) - [データとインデックス間の不整合のトラブルシューティング](/troubleshoot-data-inconsistency-errors.md) - [通知](/tidb-cloud/notifications.md) - サポートプラン diff --git a/TOC-tidb-cloud-releases.md b/TOC-tidb-cloud-releases.md index f13a9c61d28b7..b8362d3279dc9 100644 --- a/TOC-tidb-cloud-releases.md +++ b/TOC-tidb-cloud-releases.md @@ -1,28 +1,36 @@ - # 目次 -## リリースノート +## 概要 + +- [TiDB Cloud リリース概要](/tidb-cloud/releases/_index.md) + +## クラウドプラットフォームのリリースノート + +- [2026](/tidb-cloud/releases/tidb-cloud-release-notes.md) +- [2025](/tidb-cloud/releases/release-notes-2025.md) +- 以前のリリース + - [2024](/tidb-cloud/releases/release-notes-2024.md) + - [2023](/tidb-cloud/releases/release-notes-2023.md) + - [2022](/tidb-cloud/releases/release-notes-2022.md) + - [2021](/tidb-cloud/releases/release-notes-2021.md) + - [2020](/tidb-cloud/releases/release-notes-2020.md) + +## TiDB X KERNEL リリースノート -- [2026](/tidb-cloud/releases/tidb-cloud-release-notes.md) -- [2025](/tidb-cloud/releases/release-notes-2025.md) -- [2024](/tidb-cloud/releases/release-notes-2024.md) -- 以前のリリース - - [2023](/tidb-cloud/releases/release-notes-2023.md) - - [2022](/tidb-cloud/releases/release-notes-2022.md) - - [2021](/tidb-cloud/releases/release-notes-2021.md) - - [2020](/tidb-cloud/releases/release-notes-2020.md) +- [TiDB Cloud Premium 向けカーネルバージョニング](/tidb-cloud/releases/tidb-cloud-kernel-versioning.md) +- [TiDB-X-CLOUD.202510.1 リリースノート](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) ## メンテナンス通知 -- [[2024-09-15] TiDB Cloudコンソールメンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-09-15-console-maintenance.md) -- [[2024-04-18] TiDB Cloudデータ移行（DM）機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-18-dm-feature-maintenance.md) -- [[2024-04-16] TiDB Cloud監視機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-16-monitoring-features-maintenance.md) -- [[2024-04-11] TiDB Cloudデータ移行（DM）機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-11-dm-feature-maintenance.md) -- [[2024-04-09] TiDB Cloud監視機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-09-monitoring-features-maintenance.md) -- 以前の通知 - - [[2023-11-14] TiDB Cloud Dedicatedスケール機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2023-11-14-scale-feature-maintenance.md) - - [[2023-09-26] TiDB Cloudコンソールメンテナンスのお知らせ](/tidb-cloud/releases/notification-2023-09-26-console-maintenance.md) - - [[2023-08-31] TiDB Cloudコンソールメンテナンスのお知らせ](/tidb-cloud/releases/notification-2023-08-31-console-maintenance.md) +- [[2024-09-15] TiDB Cloudコンソールメンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-09-15-console-maintenance.md) +- [[2024-04-18] TiDB Cloudデータ移行（DM）機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-18-dm-feature-maintenance.md) +- 以前の通知 + - [[2024-04-16] TiDB Cloud監視機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-16-monitoring-features-maintenance.md) + - [[2024-04-11] TiDB Cloudデータ移行（DM）機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-11-dm-feature-maintenance.md) + - [[2024-04-09] TiDB Cloud監視機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2024-04-09-monitoring-features-maintenance.md) + - [[2023-11-14] TiDB Cloud Dedicatedスケール機能メンテナンスのお知らせ](/tidb-cloud/releases/notification-2023-11-14-scale-feature-maintenance.md) + - [[2023-09-26] TiDB Cloudコンソールメンテナンスのお知らせ](/tidb-cloud/releases/notification-2023-09-26-console-maintenance.md) + - [[2023-08-31] TiDB Cloudコンソールメンテナンスのお知らせ](/tidb-cloud/releases/notification-2023-08-31-console-maintenance.md) diff --git a/ai/guides/vector-search-full-text-search-sql.md b/ai/guides/vector-search-full-text-search-sql.md index 2e334bc07e5b4..938be3f31b701 100644 --- a/ai/guides/vector-search-full-text-search-sql.md +++ b/ai/guides/vector-search-full-text-search-sql.md @@ -44,7 +44,7 @@ TiDBの全文検索機能は、以下の機能を提供します。 全文検索を実行するには、効率的な検索とランキングに必要なデータ構造を提供する全文インデックスが必要です。全文インデックスは、新規テーブルに作成することも、既存のテーブルに追加することもできます。 -全文検索インデックス付きのテーブルを作成します。 +全文インデックス付きのテーブルを作成します。 ```sql CREATE TABLE stock_items( @@ -54,7 +54,7 @@ CREATE TABLE stock_items( ); ``` -または、既存のテーブルに全文検索インデックスを追加します。 +または、既存のテーブルに全文インデックスを追加します。 ```sql CREATE TABLE stock_items( @@ -70,13 +70,63 @@ ALTER TABLE stock_items ADD FULLTEXT INDEX (title) WITH PARSER MULTILINGUAL ADD_ `WITH PARSER `句では、以下のパーサーが受け入れられます。 -- `STANDARD` : 高速で、英語コンテンツに対応し、スペースと句読点によって単語を分割します。 +- `STANDARD` : 高速で、英語コンテンツに対応し、スペースと句読点によって単語を分割します。インデックス作成と検索では、すべてのテキストが小文字化されます（大文字と小文字を区別しないマッチング）。 - `MULTILINGUAL` : 英語、中国語、日本語、韓国語など、複数の言語をサポートしています。 +### 全文インデックスを管理する {#manage-full-text-indexes} + +全文インデックスを作成する際、インデックス名の指定は任意です。指定しない場合、TiDB はデフォルトで最初にインデックス化されるカラム名をインデックス名として使用します。 + +```sql +-- Without specifying an index name, TiDB uses the first indexed column name ("title") as the index name +ALTER TABLE stock_items ADD FULLTEXT INDEX (title) WITH PARSER MULTILINGUAL; + +-- Specifying an index name +ALTER TABLE stock_items ADD FULLTEXT INDEX ft_title (title) WITH PARSER MULTILINGUAL; +``` + +**既存のインデックス名を表示する:** + +```sql +-- The Key_name column shows the index name +SHOW INDEX FROM stock_items; + +-- Or query INFORMATION_SCHEMA +SELECT INDEX_NAME, COLUMN_NAME, INDEX_TYPE +FROM INFORMATION_SCHEMA.STATISTICS +WHERE TABLE_SCHEMA = 'your_database' AND TABLE_NAME = 'stock_items'; +``` + +**全文インデックスを削除する:** + +```sql +-- Use SHOW INDEX to confirm the index name first +ALTER TABLE stock_items DROP INDEX title; +``` + +#### インデックス名を指定する {#specify-an-index-name} + +`CREATE TABLE` 文と `ALTER TABLE` 文のどちらでも、`FULLTEXT INDEX` または `FULLTEXT KEY` の後にインデックス名を指定できます。 + +```sql +-- Specifying a name in CREATE TABLE +CREATE TABLE users ( + id INT, + name TEXT, + FULLTEXT INDEX ft_name (name) WITH PARSER STANDARD +); + +-- Specifying a name in ALTER TABLE +ALTER TABLE users ADD FULLTEXT INDEX ft_name (name) WITH PARSER STANDARD; + +-- Using standalone CREATE FULLTEXT INDEX (an index name is required) +CREATE FULLTEXT INDEX ft_name ON users (name) WITH PARSER STANDARD; +``` + ### テキストデータを挿入する {#insert-text-data} -全文検索インデックスを持つテーブルにデータを挿入する方法は、他のテーブルにデータを挿入する方法と全く同じです。 +全文インデックスを持つテーブルにデータを挿入する方法は、他のテーブルにデータを挿入する方法と全く同じです。 例えば、以下のSQL文を実行することで、複数の言語でデータを挿入できます。TiDBの多言語パーサーがテキストを自動的に処理します。 @@ -152,6 +202,71 @@ SELECT COUNT(*) FROM stock_items +----------+ ``` +#### 複数語検索: トークン化とクエリのセマンティクス + +`fts_match_word()` を使用すると、クエリ文字列はパーサーのルールに従ってトークン化され、各トークンが独立して照合されます。 + +STANDARD パーサーは、スペースと句読点を区切り文字として文字列を単語にトークン化します。MULTILINGUAL パーサーは、言語固有の分割ルールに従って文字列をトークン化します。 + +```sql +-- This query is tokenized into two tokens: "Alice" and "Smith" +SELECT * FROM users WHERE fts_match_word('Alice Smith', name); +``` + +`fts_match_word()` は **OR** セマンティクスを使用します。つまり、いずれかのトークンを含むドキュメントが一致し、一致するトークンが多いほど関連性スコアが高くなります。 + +```sql +-- The query below returns all rows where the name column contains +-- "Alice" or "Smith" or both +SELECT * FROM users WHERE fts_match_word('Alice Smith', name); +``` + +よくある誤解として、`fts_match_word('Alice X', name)` が `"Alice X"` を完全一致のための単一の実体として扱うというものがあります。実際には、これは `Alice` と `X` にトークン化され、OR セマンティクスが使用されます。`X` は非常に短いクエリ語であるため、無関係な多くのドキュメントに一致する可能性があります。非常に短いクエリ語や単一文字の使用は避けてください。 + +> **Note:** +> +> TiDB 全文検索は、すべてのクエリトークンが連続して指定された順序で出現する必要がある完全なフレーズ一致をサポートしていません。 + +#### プレフィックス検索 + +**サポートされていません。** + +#### 繰り返し語が関連性スコアに与える影響 + +`fts_match_word()` が返す関連性スコアは、**BM25** アルゴリズムに基づいています。クエリ文字列に繰り返し語が含まれる場合、その語の単語頻度はスコアリングで 2 倍になります。 + +```sql +-- "Alice" appears twice; in BM25 scoring, Alice's term frequency is 2 +SELECT * FROM users WHERE fts_match_word('Alice alice bob', name); +``` + +この例では、`Alice` に一致するドキュメントは、`bob` と比べて 2 倍の重みが与えられます。これは、単語頻度 (TF) に基づいて関連性を評価する BM25 アルゴリズムの想定どおりの動作です。 + +#### 関連性スコアリングアルゴリズム + +TiDB 全文検索では、関連性スコアの計算に **BM25Tantivy** アルゴリズムを使用します。このアルゴリズムは、パフォーマンス向上のために Count-Min Sketch を使用して文書頻度 (DF) を近似する、古典的な BM25 (Okapi BM25) アルゴリズムの変種です。 + +**BM25 formula (standard form):** + +``` +score(D, Q) = sum_{t in Q} IDF(t) * TF(t, D) * (k1 + 1) / (TF(t, D) + k1 * (1 - b + b * |D| / avgdl)) +``` + +Where: + +- `t`: クエリ語 +- `Q`: クエリ文字列（トークン化後のすべてのトークン） +- `D`: 評価対象のドキュメント +- `TF(t, D)`: ドキュメント内の `t` の単語頻度 +- `IDF(t)`: 逆文書頻度。語の希少性を測定します +- `|D|`: ドキュメント長 +- `avgdl`: すべてのドキュメントにおける平均ドキュメント長 +- `k1`, `b`: BM25 のチューニングパラメータ + +TiDB の実装では、情報検索における BM25 の標準デフォルト値である `k1 = 1.2` と `b = 0.75` の固定値を使用します。 + +返されるスコアは非負の浮動小数点数です。値が高いほど、クエリとの関連性が高いことを示します。スコアは異なるデータセット間で直接比較することはできません。 + ## 高度な例：検索結果を他のテーブルと結合する {#advanced-example-join-search-results-with-other-tables} 全文検索は、結合やサブクエリなどの他のSQL機能と組み合わせることができます。 diff --git a/best-practices/tidb-best-practices.md b/best-practices/tidb-best-practices.md index 8390e664cc80c..1a1e5f7bc17b9 100644 --- a/best-practices/tidb-best-practices.md +++ b/best-practices/tidb-best-practices.md @@ -130,7 +130,7 @@ MySQLで培った多くの経験は、TiDBにも応用できます。ただし - インデックスを使用して結果の順序を確実にします - インデックスを使用してデータをフィルタリングまたはソートできます。まず、インデックスの順序に従って行IDを取得します。次に、行IDの返された順序に従って行の内容を返します。このようにして、返される結果はインデックス列に従って順序付けられます。インデックスのスキャンと行の取得のモデルは並列処理＋パイプラインであると既に述べました。行がインデックスの順序に従って返される場合、2つのクエリ間の高い同時実行性はレイテンシーを削減しません。そのため、デフォルトでは同時実行性は低く設定されていますが、 [`tidb_index_serial_scan_concurrency`](/system-variables.md#tidb_index_serial_scan_concurrency)変数で変更できます。 + インデックスを使用してデータをフィルタリングまたはソートできます。TiDB はまずインデックスの順序に従って行IDを取得し、その後それらの行IDの順序に従って行の内容を返します。このようにして、返される結果はインデックス列に従って順序付けられます。インデックスのスキャンと行の取得のモデルは並列処理＋パイプラインであると既に述べました。行がインデックスの順序に従って返される場合、2つのクエリ間の高い同時実行性はレイテンシーを削減しません。そのため、デフォルトでは同時実行性は低く設定されていますが、 [`tidb_executor_concurrency`](/system-variables.md#tidb_executor_concurrency-new-in-v50)を調整することで増やすことができます。 - 逆インデックススキャン diff --git a/index-advisor.md b/index-advisor.md index dce97cb8f676f..fea8dfd3b0bcf 100644 --- a/index-advisor.md +++ b/index-advisor.md @@ -5,7 +5,7 @@ summary: TiDB Index Advisorを使用してクエリパフォーマンスを最 # インデックスアドバイザー {#index-advisor} -TiDB v8.5.0では、クエリパフォーマンスを向上させるインデックスを推奨することでワークロードを最適化するインデックスアドバイザー機能が導入されました。新しいSQLステートメント`RECOMMEND INDEX`を使用すると、単一のクエリまたはワークロード全体に対してインデックスの推奨事項を生成できます。評価のために物理的にインデックスを作成するというリソース集約型のプロセスを回避するために、TiDBは[仮説的な指標](#hypothetical-indexes)サポートしており、これは具体化されていない論理インデックスです。 +TiDB v8.5.0では、クエリパフォーマンスを向上させるインデックスを推奨することでワークロードを最適化するインデックスアドバイザー機能が導入されました。新しいSQLステートメント`RECOMMEND INDEX`を使用すると、単一のクエリまたはワークロード全体に対してインデックスの推奨事項を生成できます。評価のために物理的にインデックスを作成するというリソース集約型のプロセスを回避するために、TiDBは[仮説インデックス](#hypothetical-indexes)サポートしており、これは具体化されていない論理インデックスです。 > **Note:** > @@ -190,15 +190,15 @@ WHERE last_access_time IS NOT NULL AND percentage_access_0 + percentage_access_0 > > `INFORMATION_SCHEMA.CLUSTER_TIDB_INDEX_USAGE`のデータは最大 5 分遅延する可能性があり、TiDB ノードが再起動されるたびに使用状況データはリセットされます。また、インデックスの使用状況は、テーブルに有効な統計情報がある場合にのみ記録されます。 -## 仮説的な指標 {#hypothetical-indexes} +## 仮説インデックス {#hypothetical-indexes} -仮説インデックス（Hypo Indexes）は、 `CREATE INDEX`ステートメントではなく、 のような SQL コメントを使用して作成されます。この方法により[クエリヒント](/optimizer-hints.md)インデックスを物理的に作成するオーバーヘッドなしに、軽量なインデックス実験が可能になります。 +`EXPLAIN`ステートメントでは、クエリプランナーが考慮する仮説インデックスを定義するために、`/*+ HYPO_INDEX(...) */` SQLコメント構文を使用できます。この方法により、インデックスを物理的に作成するオーバーヘッドなしに、軽量なインデックス実験が可能になります。 例えば、 `/*+ HYPO_INDEX(t, idx_ab, a, b) */`コメントは、クエリ プランナーに対し、 `idx_ab`テーブル上に、 `t`に対して、 `a` `b`名前の仮想インデックスを作成するように指示します。プランナーはインデックスのメタデータを生成しますが、物理的にインデックスを作成することはありません。該当する場合、プランナーはインデックス作成に伴うコストを発生させることなく、クエリ最適化中にこの仮想インデックスを考慮します。 `RECOMMEND INDEX`アドバイザーは、仮説的なインデックスを使用して「もしも」分析を行い、さまざまなインデックスの潜在的なメリットを評価します。また、仮説的なインデックスを直接使用して、インデックスを作成する前にインデックス設計を試すこともできます。 -次の例は、架空のインデックスを使用したクエリを示しています。 +次の例は、仮説インデックスを使用した`EXPLAIN`ステートメントを示しています。 ```sql CREATE TABLE t(a INT, b INT, c INT); diff --git a/latest_translation_commit.json b/latest_translation_commit.json index 652fbd3addfb9..0d77f56522995 100644 --- a/latest_translation_commit.json +++ b/latest_translation_commit.json @@ -1,4 +1,4 @@ { "target": "release-8.5", - "sha": "37c45d52207b46f0d84339da42eb3b4f6f247129" + "sha": "b6f7f75a70c32ead3841d9636a62c0749c211fc4" } diff --git a/sql-statements/sql-statement-cancel-distribution-job.md b/sql-statements/sql-statement-cancel-distribution-job.md index 9772187881e51..966b3925530b3 100644 --- a/sql-statements/sql-statement-cancel-distribution-job.md +++ b/sql-statements/sql-statement-cancel-distribution-job.md @@ -7,14 +7,10 @@ summary: TiDBにおけるCANCEL DISTRIBUTION JOBの使用方法の概要。 `CANCEL DISTRIBUTION JOB`ステートメントは、TiDB の[`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md)ステートメントを使用して作成されたリージョンスケジューリング タスクをキャンセルするために使用されます。 - - > **Note:** > > この機能は、 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter)および[TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential)インスタンスではご利用いただけません。 - - ## 概要 {#synopsis} ```ebnf+diagram @@ -41,4 +37,4 @@ CANCEL DISTRIBUTION JOB 1; ## 参照 {#see-also} - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) -- [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) +- [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) \ No newline at end of file diff --git a/sql-statements/sql-statement-distribute-table.md b/sql-statements/sql-statement-distribute-table.md index a8c944b02ab10..8c8a657702472 100644 --- a/sql-statements/sql-statement-distribute-table.md +++ b/sql-statements/sql-statement-distribute-table.md @@ -9,14 +9,10 @@ summary: TiDBデータベースにおけるDISTRIBUTE T​​ABLEの使用方法 > > この機能は実験的です。本番環境での使用は推奨されません。この機能は予告なく変更または削除される場合があります。バグを発見した場合は、GitHubで[問題](https://github.com/pingcap/tidb/issues)を報告してください。 - - > **Note:** > > この機能は、 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter)および[TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential)インスタンスではご利用いただけません。 - - `DISTRIBUTE TABLE`ステートメントは、指定されたテーブルのリージョンを再分配および再スケジュールし、テーブルレベルでバランスの取れた分散を実現します。このステートメントを実行することで、リージョンが少数のTiFlashまたは TiKV ノードに集中するのを防ぎ、テーブル内のリージョンの分散が不均一になる問題を解決できます。 ## 概要 {#synopsis} @@ -117,4 +113,4 @@ DISTRIBUTE TABLE t4 PARTITION (p1, p2) RULE = "learner-scatter" ENGINE="tiflash" - [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) - [`SHOW TABLE DISTRIBUTION`](/sql-statements/sql-statement-show-table-distribution.md) - [`SHOW TABLE REGIONS`](/sql-statements/sql-statement-show-table-regions.md) -- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) +- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) \ No newline at end of file diff --git a/sql-statements/sql-statement-show-distribution-jobs.md b/sql-statements/sql-statement-show-distribution-jobs.md index f075dbf6d814d..da631d91da085 100644 --- a/sql-statements/sql-statement-show-distribution-jobs.md +++ b/sql-statements/sql-statement-show-distribution-jobs.md @@ -7,14 +7,10 @@ summary: TiDBデータベースにおけるSHOW DISTRIBUTION JOBSの使用方法 `SHOW DISTRIBUTION JOBS`ステートメントは、現在実行中のリージョン配布ジョブをすべて表示します。 - - > **Note:** > > この機能は、 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter)および[TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential)インスタンスではご利用いただけません。 - - ## 概要 {#synopsis} ```ebnf+diagram @@ -46,4 +42,4 @@ SHOW DISTRIBUTION JOBS; - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) - [`SHOW TABLE DISTRIBUTION`](/sql-statements/sql-statement-show-table-distribution.md) -- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) +- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) \ No newline at end of file diff --git a/sql-statements/sql-statement-show-table-distribution.md b/sql-statements/sql-statement-show-table-distribution.md index d0f56adb8e8ae..f86984d0abd5f 100644 --- a/sql-statements/sql-statement-show-table-distribution.md +++ b/sql-statements/sql-statement-show-table-distribution.md @@ -7,14 +7,10 @@ summary: TiDBデータベースにおけるSHOW TABLE DISTRIBUTIONの使用方 `SHOW TABLE DISTRIBUTION`ステートメントは、指定されたテーブルのリージョン分布情報を表示します。 - - > **Note:** > > この機能は、 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter)および[TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential)インスタンスではご利用いただけません。 - - ## 概要 {#synopsis} ```ebnf+diagram @@ -64,4 +60,4 @@ SHOW TABLE t DISTRIBUTIONS; - [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) - [`SHOW DISTRIBUTION JOBS`](/sql-statements/sql-statement-show-distribution-jobs.md) -- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) +- [`CANCEL DISTRIBUTION JOB`](/sql-statements/sql-statement-cancel-distribution-job.md) \ No newline at end of file diff --git a/statistics.md b/statistics.md index 96d89643f2035..0d430b13ab5aa 100644 --- a/statistics.md +++ b/statistics.md @@ -749,23 +749,29 @@ TiDB v6.0以降、TiDBは`KILL`ステートメントを使用して、バック #### `tidb_build_stats_concurrency` {#tidb-build-stats-concurrency} -`ANALYZE`ステートメントを実行すると、タスクは複数の小さなタスクに分割されます。各タスクは、1 つの列またはインデックスの統計情報のみを処理します。tidb_build_stats_concurrency 変数を使用して、同時実行される小さなタスクの数を制御できます。 [`tidb_build_stats_concurrency`](/system-variables.md#tidb_build_stats_concurrency)値は`2`です。v7.4.0 以前のバージョンでは、デフォルト値は`4`です。 +この変数は、手動 `ANALYZE` 中に統計情報を構築する際の同時実行性を制御します。たとえば、同時に処理できるテーブルまたはパーティションの分析タスク数です。デフォルト値は`2`です。v7.4.0 以前のバージョンでは、デフォルト値は`4`です。 #### `tidb_build_sampling_stats_concurrency` {#tidb-build-sampling-stats-concurrency} -通常の列を分析する場合、 [`tidb_build_sampling_stats_concurrency`](/system-variables.md#tidb_build_sampling_stats_concurrency-new-in-v750)を使用して、サンプリング タスクの実行の同時実行を制御できます。デフォルト値は`2`です。 +この変数は、`ANALYZE` の同時実行性に関する以下の項目を制御します。 + +- 異なるリージョンから収集されたサンプルをマージする際の同時実行性。 +- 特殊なインデックス（仮想生成カラム上のインデックスなど）の統計情報を収集する際の同時実行性。たとえば、TiDB が同時に統計情報を収集できるインデックス数です。 + +デフォルト値は`2`です。 #### `tidb_analyze_partition_concurrency` {#tidb-analyze-partition-concurrency} -`ANALYZE`ステートメントを実行する際に、 [`tidb_analyze_partition_concurrency`](/system-variables.md#tidb_analyze_partition_concurrency)を使用して、パーティションテーブルの統計情報の読み取りと書き込みの同時実行を制御できます。デフォルト値は`2`です。v7.4.0 以前のバージョンでは、デフォルト値は`1`です。 +この変数は、`ANALYZE` の結果を保存する際の同時実行性（TopN とヒストグラムをシステムテーブルに書き込むこと）を制御します。デフォルト値は`2`です。v7.4.0 以前のバージョンでは、デフォルト値は`1`です。 -#### `tidb_distsql_scan_concurrency` {#tidb-distsql-scan-concurrency} +#### `tidb_analyze_distsql_scan_concurrency` {#tidb-analyze-distsql-scan-concurrency} -通常の列を分析する場合、 [`tidb_distsql_scan_concurrency`](/system-variables.md#tidb_distsql_scan_concurrency)変数を使用して、一度に読み込むリージョンの数を制御できます。デフォルト値は`15`です。値を変更するとクエリのパフォーマンスに影響するため、慎重に調整してください。 +この変数は、`ANALYZE` の同時実行性に関する以下の項目を制御します。 -#### `tidb_index_serial_scan_concurrency` {#tidb-index-serial-scan-concurrency} +- TiKV リージョンをスキャンする際の同時実行性。 +- 特殊なインデックス（仮想カラムから生成されたインデックス）のためにリージョンをスキャンする際の同時実行性。 -インデックス列を分析する際、 [`tidb_index_serial_scan_concurrency`](/system-variables.md#tidb_index_serial_scan_concurrency)変数を使用して、一度に読み込むリージョンの数を制御できます。デフォルト値は`1`です。この値を変更するとクエリのパフォーマンスに影響するため、慎重に調整してください。 +デフォルト値は`4`です。 ## 関連項目 {#see-also} diff --git a/sync-diff-inspector/sync-diff-inspector-overview.md b/sync-diff-inspector/sync-diff-inspector-overview.md index b2b90e7344b2c..f7f216d7b7502 100644 --- a/sync-diff-inspector/sync-diff-inspector-overview.md +++ b/sync-diff-inspector/sync-diff-inspector-overview.md @@ -5,7 +5,7 @@ summary: sync-diff-inspectorを使用してデータを比較し、不整合な # sync-diff-inspector ユーザーガイド {#sync-diff-inspector-user-guide} -[sync-diff-inspector](https://github.com/pingcap/tiflow/tree/master/sync_diff_inspector)は、MySQLプロトコルを使用するデータベースに保存されているデータを比較するためのツールです。例えば、MySQLのデータとTiDBのデータ、MySQLのデータとMySQLのデータ、またはTiDBのデータとTiDBのデータを比較できます。さらに、少量のデータに不整合がある場合、このツールを使用してデータを修復することもできます。 +[sync-diff-inspector](https://github.com/pingcap/tiflow/tree/master/sync_diff_inspector)は、MySQL互換データベース（MySQL および TiDB を含む）に保存されているデータを比較するためのツールです。例えば、MySQLのデータとTiDBのデータ、MySQLのデータとMySQLのデータ、またはTiDBのデータとTiDBのデータを比較できます。さらに、少量のデータに不整合がある場合、このツールを使用してデータを修復することもできます。 このガイドでは、sync-diff-inspectorの主な機能を紹介し、このツールの設定方法と使用方法について説明します。 @@ -52,7 +52,12 @@ TiDB v8.5.6以降の場合： - MySQL と TiDB 間のデータ移行では、オンラインチェックはサポートされていません。アップストリーム/ダウンストリームチェックリストにデータが書き込まれていないこと、および特定の範囲のデータが変更されていないことを確認してください。 `range`を設定することで、この範囲のデータをチェックできます。 -- TiDB と MySQL では、 `FLOAT` 、 `DOUBLE`およびその他の浮動小数点型の実装が異なります。 `FLOAT`と`DOUBLE`は、それぞれチェックサムの計算に 6 桁と 15 桁の有効数字を使用します。この機能を使用しない場合は、 `ignore-columns`を設定して、これらの列のチェックをスキップしてください。 +- データ型サポートに関する注意事項: + + - **FLOAT/DOUBLE**: 浮動小数点型は TiDB と MySQL で実装が異なります。 `FLOAT`と`DOUBLE`は、それぞれチェックサムの計算に 6 桁と 15 桁の有効数字を使用します。この機能を使用しない場合は、 `ignore-columns`を設定して、これらの列のチェックをスキップしてください。 + - **JSON**: 比較がサポートされています。JSON 文字列値については、アップストリームとダウンストリーム間の照合順序および文字セットの違いにより、誤検知が発生する可能性があることに注意してください。 + - **BLOB/VARBINARY**: バイナリデータとしてサポートされ、バイト単位で比較されます。 + - **BIT**: MySQL から TiDB への比較でサポートされています。幅 1、8、16、64 で検証されています。スキーマで標準外の幅やアプリケーションレベルの変換を使用している場合は、対象を絞った検証テストを実施してください。 - 主キーまたは一意インデックスを含まないテーブルのチェックをサポートします。ただし、データに矛盾がある場合、生成されたSQL文ではデータを正しく修復できない可能性があります。 @@ -174,8 +179,9 @@ range = "age > 10 AND age < 20" # (optional) Specifies the column used to divide data into chunks. If you do not configure it, # sync-diff-inspector chooses an appropriate column (primary key, unique key, or a field with index). index-fields = ["col1","col2"] -# (optional) Ignores checking some columns such as some types (json, bit, blob, etc.) -# that sync-diff-inspector does not currently support. +# (optional) Ignores checking columns that you want to exclude from validation. +# For example, columns with known cross-implementation differences (such as floating-point types) +# or columns you prefer to validate separately. # The floating-point data type behaves differently in TiDB and MySQL. You can use # `ignore-columns` to skip checking these columns. ignore-columns = ["",""] @@ -305,7 +311,13 @@ REPLACE INTO `sbtest`.`sbtest99`(`id`,`k`,`c`,`pad`) VALUES (3700000,2501808,'he ## 注記 {#note} - sync-diff-inspectorは、データチェック時に一定量のサーバーリソースを消費します。業務のピーク時間帯には、sync-diff-inspectorを使用してデータチェックを行うことは避けてください。 -- MySQL のデータと TiDB のデータを比較する前に、テーブルの文字セットと`collation`構成を確認してください。これは、テーブルの主キーまたは一意キーが`varchar`型である場合に特に重要です。上流データベースと下流データベースで照合順序ルールが異なると、ソートの問題が発生し、検証結果が不正確になる可能性があります。たとえば、MySQL のデフォルトの照合順序は大文字小文字を区別しませんが、TiDB のデフォルトの照合順序は大文字小文字を区別します。この不一致により、修復 SQL で同一の削除レコードと挿入レコードが発生する可能性があります。この問題を回避するには、 `index-fields`構成を使用して、大文字小文字の区別に影響されないインデックス列を指定します。 sync-diff-inspector 設定ファイルで`collation`を設定し、チャンクベースの比較時にアップストリームとダウンストリームの両方で同じ照合順序を明示的に使用する場合、インデックス フィールドの順序はテーブルの照合順序設定に依存することに注意してください。照合順序が異なると、一方の側でインデックスを使用できなくなる可能性があります。さらに、アップストリームとダウンストリームで文字セットが異なる場合 (たとえば、MySQL が UTF-8 を使用し、TiDB が UTF-8MB4 を使用する場合)、照合順序設定を統一することはできません。 +- MySQL と TiDB のデータを比較する前に、テーブルの文字セットと`collation`構成を確認してください。これは、UTF-8 データを含む `varchar`、`text`、または `JSON` カラムを持つテーブル、特にこれらのカラムが主キーまたは一意キーの一部である場合に重要です。MySQL 8.0 のデフォルトは `utf8mb4_0900_ai_ci`（大文字小文字を区別せず、アクセントも区別しない）である一方、TiDB では `utf8mb4_bin`（バイナリ/大文字小文字を区別する）がよく使用されます。この不一致により、sync-diff-inspector は同一の UTF-8 文字列や JSON 文字列値に対して誤った差分を報告する可能性があります。誤検知を避けるには、アップストリームとダウンストリームの両方のテーブルで照合順序（たとえば `utf8mb4_bin`）を揃えるか、`ignore-columns` を使用して影響を受ける UTF-8 テキストカラムおよび JSON カラムを除外してください。 +- sync-diff-inspector 設定ファイルで`collation`を設定し、チャンクベースの比較時にアップストリームとダウンストリームの両方で同じ照合順序を明示的に使用する場合、インデックス列の順序はテーブルの照合順序設定に依存することに注意してください。照合順序が異なると、一方の側でインデックスを使用できなくなる可能性があります。さらに、アップストリームとダウンストリームで文字セットが異なる場合 (たとえば、MySQL が `utf8` を使用し、TiDB が `utf8mb4` を使用する場合)、照合順序設定を統一することはできません。 +- データが論理的に同一であっても、次のようなシナリオでは誤った差分が生じる可能性があります: + - アップストリームとダウンストリームで照合順序が異なる VARCHAR および TEXT カラム（たとえば、`utf8mb4_0900_ai_ci` と `utf8mb4_bin`）では、同一の文字列値に対して差分が報告されます。 + - 文字列値を含む JSON カラムは、同じ照合順序ベースの比較の問題の影響を受けます。 + - 自動入力される TIMESTAMP カラム（`DEFAULT CURRENT_TIMESTAMP` や `ON UPDATE CURRENT_TIMESTAMP` など）は、スキーマが異なる時刻にロードされた場合や、わずかなタイミング差のあるデータを比較する場合にノイズを生じさせる可能性があります。 +- 自動入力される timestamp カラムを含むデータセットを検証する場合は、`DEFAULT CURRENT_TIMESTAMP` に依存するのではなく、検証データに対して決定論的な TIMESTAMP 値を設定することを検討してください。あるいは、その正確な値が検証目的にとって重要でない場合は、`ignore-columns` を使用して自動入力される TIMESTAMP カラムを除外してください。 - アップストリームテーブルとダウンストリームテーブルで主キーが異なる場合、sync-diff-inspector は元の主キー列を使用してチャンクを分割しません。たとえば、MySQL のシャーディングされたテーブルが、元の主キーとシャードキーを含む複合主キーを使用して TiDB にマージされる場合などです。この場合、 `index-fields`を使用して元の主キー列を構成し、 `check-data-only`を`true`に設定します。 - sync-diff-inspector は、まず TiDB の統計情報に基づいてデータをチャンクに分割します。統計情報の正確性を保証する必要があります。TiDB サーバーの*ワークロードが軽い*場合は、 `analyze table {table_name}`コマンドを手動で実行できます。 - `table-rules`に特に注意してください。 `schema-pattern="test1"` 、 `table-pattern = "t_1"` 、 `target-schema="test2"` 、 `target-table = "t_2"`構成すると、ソース データベースの`test1` 、 `t_1`スキーマと、ターゲット データベースの`test2` 、 `t_2`スキーマが比較されます。 sync-diff-inspector ではシャーディングがデフォルトで有効になっているため、ソース データベースに`test2` . `t_2`テーブルがある場合、シャーディングとして機能しているソース データベースの`test1` . `t_1`テーブルと`test2` . `t_2`テーブルが、ターゲット データベースの`test2` . `t_2`テーブルと比較されます。 diff --git a/system-variables.md b/system-variables.md index 944803d1e43e9..fddb06b4e2920 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1150,13 +1150,19 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー ### tidb_analyze_distsql_scan_concurrency v7.6.0で追加 {#tidb-analyze-distsql-scan-concurrency-new-in-v760} +> **Note:** +> +> v7.6.0 より前のバージョンでは、通常の `ANALYZE` リージョンスキャンは `tidb_distsql_scan_concurrency` によって制御され、インデックス統計スキャンは `tidb_index_serial_scan_concurrency` によって制御されます。したがって、これらのバージョンで TiKV リージョンのスキャンの同時実行数を調整するには、`tidb_distsql_scan_concurrency` の値を変更することを検討してください。 + - 範囲: セッション | グローバル - クラスターに保持される: はい - ヒント[SET_VAR](/optimizer-hints.md#set_varvar_namevar_value)に適用：いいえ - 型: 整数 - デフォルト値: `4` - 範囲: `[0, 4294967295]` 。v8.2.0 より前のバージョンでは、最小値は`1`です。これを`0`に設定すると、クラスタサイズに基づいて同時実行数が適応的に調整されます。 -- この変数は`scan`操作を実行する際に、 `ANALYZE`操作の同時実行性を設定するために使用されます。 +- この変数は、`ANALYZE` の同時実行性について、以下の項目を制御します。 + - TiKV リージョンをスキャンする同時実行数。 + - 生成された仮想カラム上のインデックスなど、特殊なインデックスのリージョンをスキャンする同時実行数。 ### tidb_analyze_partition_concurrency {#tidb-analyze-partition-concurrency} @@ -1165,7 +1171,7 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - ヒント[SET_VAR](/optimizer-hints.md#set_varvar_namevar_value)に適用：いいえ - デフォルト値: `2` 。v7.4.0以前のバージョンでは、デフォルト値は`1`です。 - 範囲: `[1, 128]` 。v8.4.0 より前は、値の範囲は`[1, 18446744073709551615]`です。 -- この変数は、TiDB がパーティションテーブルを分析する際に、収集された統計情報を書き込む際の同時実行数を指定します。 +- 手動および自動 `ANALYZE` について、この変数は、TopN とヒストグラムのシステムテーブルへの書き込みを含む、`ANALYZE` 結果の保存の同時実行数を制御します。 ### tidb_analyze_version v5.1.0で追加 {#tidb-analyze-version-new-in-v510} @@ -1185,7 +1191,7 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - クラスターを以前のバージョンからアップグレードした場合、 `tidb_analyze_version`のデフォルト値はアップグレード後も変更されません。 - この変数の詳細については、[統計入門](/statistics.md)参照してください。 -### tidb_analyze_skip_column_types はv7.2.0 で追加されました。 {#tidb-analyze-skip-column-types-span-class-version-mark-new-in-v7-2-0-span} +### tidb_analyze_skip_column_types v7.2.0 で追加されました。 {#tidb-analyze-skip-column-types-span-class-version-mark-new-in-v7-2-0-span} - 範囲: セッション | グローバル - クラスターに保持される: はい @@ -1214,7 +1220,7 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー +----------------------------------+ | @@tidb_analyze_skip_column_types | +----------------------------------+ - | json,blob,mediumblob,longblob | + | json,blob,mediumblob,longblob,mediumtext,longtext | +----------------------------------+ 1 row in set (0.00 sec) @@ -1323,7 +1329,7 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - 型: 整数 - デフォルト値: `2` - 範囲: `[1, 256]` -- この変数は、統計情報の自動更新を実行する際の同時実行数を設定するために使用されます。 +- この変数は、自動 `ANALYZE` 中に統計情報を構築する同時実行数を制御します。たとえば、同時に処理できるテーブルまたはパーティションの分析タスク数です。 - v8.5.7 以降、この変数のデフォルト値は `1` から `2` に変更されました。以前のバージョンからクラスターをアップグレードした場合、この変数の値はアップグレード後も変更されません。 ### tidb_backoff_lock_fast {#tidb-backoff-lock-fast} @@ -1437,10 +1443,9 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - デフォルト値: `2` 。v7.4.0以前のバージョンでは、デフォルト値は`4`です。 - 範囲: `[1, 256]` - 単位：糸 -- この変数は`ANALYZE`ステートメントの実行の同時実行を設定するために使用されます。 -- 変数をより大きな値に設定すると、他のクエリの実行パフォーマンスに影響が出ます。 +- この変数は、手動 `ANALYZE` 中に統計情報を構築する同時実行数を制御します。たとえば、同時に処理できるテーブルまたはパーティションの分析タスク数です。 -### tidb_build_sampling_stats_concurrency はv7.5.0 で追加されました。 {#tidb-build-sampling-stats-concurrency-span-class-version-mark-new-in-v7-5-0-span} +### tidb_build_sampling_stats_concurrency v7.5.0 で追加されました。 {#tidb-build-sampling-stats-concurrency-span-class-version-mark-new-in-v7-5-0-span} - 範囲: セッション | グローバル - クラスターに保持される: はい @@ -1449,8 +1454,9 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - 単位：糸 - デフォルト値: `2` - 範囲: `[1, 256]` -- この変数は`ANALYZE`プロセスのサンプリング同時実行数を設定するために使用されます。 -- 変数をより大きな値に設定すると、他のクエリの実行パフォーマンスに影響が出ます。 +- この変数は、`ANALYZE` の同時実行性について、以下の項目を制御します。 + - 異なるリージョンから収集されたサンプルをマージする同時実行数。 + - 特殊なインデックス（生成された仮想カラム上のインデックスなど）の統計情報を収集する同時実行数。たとえば、TiDB が同時に統計情報を収集できるインデックス数です。 ### tidb_capture_plan_baselines v4.0で追加 {#tidb-capture-plan-baselines-new-in-v40} @@ -3637,6 +3643,10 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー ### tidb_index_serial_scan_concurrency {#tidb-index-serial-scan-concurrency} +> **Warning:** +> +> この変数は非推奨であり、実行動作を制御しなくなりました。シーケンシャルインデックススキャンの同時実行数は現在 [`tidb_executor_concurrency`](#tidb_executor_concurrency-new-in-v50) によって制御され、[`ANALYZE TABLE`](/sql-statements/sql-statement-analyze-table.md) はインデックス統計スキャンの同時実行数を制御するために [`tidb_analyze_distsql_scan_concurrency`](#tidb_analyze_distsql_scan_concurrency-new-in-v760) を使用します。 + - 範囲: セッション | グローバル - クラスターに保持される: はい - ヒント[SET_VAR](/optimizer-hints.md#set_varvar_namevar_value)に適用：はい @@ -3644,8 +3654,7 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - デフォルト値: `1` - 範囲: `[1, 256]` - 単位：糸 -- この変数は`serial scan`操作の同時実行数を設定するために使用されます。 -- OLAPシナリオではより大きな値を使用し、OLTPシナリオではより小さな値を使用してください。 +- この変数は後方互換性のためだけに残されています。シーケンシャルインデックススキャンの同時実行数を制御するには [`tidb_executor_concurrency`](#tidb_executor_concurrency-new-in-v50) を、インデックス統計スキャンの同時実行数を制御するには [`tidb_analyze_distsql_scan_concurrency`](#tidb_analyze_distsql_scan_concurrency-new-in-v760) を使用してください。 ### tidb_init_chunk_size {#tidb-init-chunk-size} @@ -4167,7 +4176,7 @@ MPP は、 TiFlashエンジンによって提供される分散コンピュー - クラスターに保持される: はい - ヒント[SET_VAR](/optimizer-hints.md#set_varvar_namevar_value)に適用：いいえ - デフォルト値: `1` -- この変数は、TiDB がパーティション テーブルを分析する際に、パーティションテーブルパーティションテーブルに対する統計情報をマージする同時実行回数を指定します。 +- この変数は、パーティションテーブルの TopN 結果をマージする同時実行数を制御します。 ### tidb_enable_async_merge_global_stats はv7.5.0 で追加されました。 {#tidb-enable-async-merge-global-stats-span-class-version-mark-new-in-v7-5-0-span} diff --git a/tidb-cloud/architecture-concepts.md b/tidb-cloud/architecture-concepts.md index 56cea2ee01a6f..2c3730ebfab5d 100644 --- a/tidb-cloud/architecture-concepts.md +++ b/tidb-cloud/architecture-concepts.md @@ -89,6 +89,38 @@ TiDB Cloud Essentialは、さまざまな運用要件に対応するため、2 ミッション クリティカルなワークロードの稼働時間と回復力を最大化するために、 TiDB Cloud Premium は[地域的な高可用性](/tidb-cloud/serverless-high-availability.md#regional-high-availability-architecture)を提供し、複数のアベイラビリティ ゾーンにノードを分散して、ゾーン展開よりも高い冗長性を実現します。 + + +## TiDB Cloud BYOC {#tidb-cloud-byoc} + +TiDB Cloud BYOC（Bring Your Own Cloud）は、マネージドサービスとして TiDB Cloud を利用しながら、データの配置場所、クラウドリソース、ネットワーク境界、コンプライアンス体制をより強く制御する必要がある組織向けに設計されています。BYOC では、TiDB Cloud の コントロールプレーン は PingCAP によって管理され、TiDB の データプレーン はお客様自身のクラウドアカウント内で実行されます。 + +BYOC は、次の機能を提供します。 + +- **Customer-owned data plane**: TiDB サービスのリソース、データストレージ、ネットワーク境界をお客様のクラウドアカウント内に保持します。 +- **Managed operations**: デプロイ、スケーリング、監視、アップグレード、バックアップ、ライフサイクル管理に TiDB Cloud を使用します。 +- **Flexible high availability**: Single-AZ と Multi-AZ の両方のデプロイをサポートしており、低レイテンシーのゾーン単位デプロイと、より高い耐障害性を持つリージョン単位デプロイのどちらかを選択できます。 +- **Cloud-account-level controls**: ネットワーキング、セキュリティ、監査可能性、コンプライアンスに対して、お客様独自のクラウドポリシーを適用できます。 +- **Private connectivity**: BYOC の設定に応じて、VPC ピアリング などのプライベートネットワークアクセスパターンをサポートします。 + +さまざまなワークロード要件に対応するため、TiDB Cloud BYOC は Single-AZ と Multi-AZ の両方のデプロイをサポートしており、低レイテンシーのゾーン単位デプロイと、複数の availability zone にまたがる高い耐障害性を持つデプロイのどちらかを選択できます。 + +![TiDB Cloud BYOC Architecture](/media/tidb-cloud/byoc-architecture.png) + +TiDB Cloud BYOC のデプロイには、次の主要なコンポーネントが含まれます。 + +- **TiDB Cloud control plane**: TiDB Cloud コンソール、組織およびプロジェクト管理、課金、ライフサイクルのオーケストレーション、監視ビュー、アラート、メンテナンスワークフローを提供します。 +- **BYOC data plane**: お客様のクラウドアカウント内で TiDB サービスおよび関連インフラストラクチャを実行します。TiDB Cloud は、BYOC オンボーディング時に付与された権限に基づいてこの環境を運用します。 +- **TiDB service VPC**: アプリケーショントラフィックを処理する TiDB サービスのコンポーネントをホストします。 +- **Observability service VPC**: BYOC デプロイのメトリクス、ログ、運用データを収集するために使用される observability コンポーネントをホストします。 +- **Application VPC**: お客様のアプリケーションをホストします。この VPC はお客様が管理し、BYOC TiDB サービスにアクセスするためのネットワーク接続を設定します。 + +各 BYOC リージョンは、それぞれ独立してデプロイおよび運用されます。BYOC リージョンが追加されると、TiDB Cloud はお客様のクラウドアカウント内に必要なリージョンリソースをプロビジョニングします。各 BYOC リージョンは独自の data-plane 構成を持つため、リージョン間で単一の TiDB Service VPC または Observability Service VPC を共有することはありません。 + +お客様のアプリケーションは、アプリケーション環境から {{{ .byoc }}} インスタンスに接続します。BYOC の設定に応じて、接続にはプライベートアクセスまたは制御されたパブリックアクセスのいずれかが使用されます。プライベートアクセスについては、BYOC は VPC ピアリング やその他のプライベート接続オプションをサポートします。 + + + ## TiDB Cloud Dedicated {#tidb-cloud-dedicated} TiDB Cloud Dedicatedは、ミッションクリティカルなビジネス向けに設計されており、複数のアベイラビリティゾーンにわたる高可用性、水平スケーリング、および完全なHTAP機能を提供します。 diff --git a/tidb-cloud/backup-and-restore-concepts.md b/tidb-cloud/backup-and-restore-concepts.md index 1f08297361149..6ac7890c3cdcd 100644 --- a/tidb-cloud/backup-and-restore-concepts.md +++ b/tidb-cloud/backup-and-restore-concepts.md @@ -7,21 +7,32 @@ summary: TiDB Cloudのバックアップと復元に関する概念について TiDB Cloudバックアップ＆リストア機能は、データのバックアップと復元を可能にすることで、お客様のデータを保護し、事業継続性を確保するように設計されています。 + + +TiDB Cloud BYOC では、データプレーンをお客様自身のクラウドアカウントで実行しながら、TiDB Cloudコンソールを通じてバックアップおよび復元の操作を管理できます。これにより、データプレーンをお客様のクラウド環境内に保持したまま、マネージドなバックアップおよび復元の利用体験を提供します。 + + + ## 自動バックアップ {#automatic-backup} TiDB Cloudでは、スナップショットバックアップはデフォルトで自動的に取得され、バックアップ保持ポリシーに従って保存されます。 詳細については、以下を参照してください。 -- [TiDB Cloud StarterおよびTiDB Cloud Essentialインスタンスの自動バックアップ](/tidb-cloud/backup-and-restore-serverless.md#automatic-backups) -- [TiDB Cloud Premiumインスタンスの自動バックアップ](/tidb-cloud/premium/backup-and-restore-premium.md#automatic-backups) -- [TiDB Cloud Dedicatedクラスターの自動バックアップ](/tidb-cloud/backup-and-restore.md#turn-on-auto-backup) +- [TiDB Cloud StarterおよびTiDB Cloud Essentialインスタンスの自動バックアップ](/tidb-cloud/backup-and-restore-serverless.md#automatic-backups) +- [TiDB Cloud Premium および TiDB Cloud BYOC インスタンスの自動バックアップ](/tidb-cloud/premium/backup-and-restore-premium.md#automatic-backups) +- [TiDB Cloud Dedicatedクラスターの自動バックアップ](/tidb-cloud/backup-and-restore.md#turn-on-auto-backup) ## 手動バックアップ {#manual-backup} -TiDB Cloud Dedicatedの手動バックアップ機能は、必要に応じてデータを既知の状態にバックアップし、いつでもその状態に復元できる機能です。 +手動バックアップを使用すると、必要に応じてデータを既知の状態にバックアップし、その状態にいつでも復元できます。手動バックアップは、システムのアップグレード、重要なデータの削除、元に戻せないスキーマ変更などの高リスクな操作を実行する前に利用できます。 -詳細については、 [手動バックアップを実行する](/tidb-cloud/backup-and-restore.md#perform-a-manual-backup)参照してください。 +{{{ .premium }}}, {{{ .byoc }}}, および TiDB Cloud Dedicated は手動バックアップをサポートしています。手動バックアップは、制御された復元ポイントを提供し、明示的に削除するまで保持されます。手動バックアップは PITR または部分バックアップをサポートしておらず、復元を実行するたびに新しいインスタンスが作成されます。 + +詳細については、以下を参照してください。 + +- [{{{ .premium }}} および {{{ .byoc }}} インスタンスの手動バックアップ](/tidb-cloud/premium/backup-and-restore-premium.md#manual-backups) +- [TiDB Cloud Dedicated クラスターの手動バックアップを実行する](/tidb-cloud/backup-and-restore.md#perform-a-manual-backup) ## デュアルリージョンバックアップ {#dual-region-backup} @@ -42,3 +53,9 @@ TiDB Cloud Dedicatedのデュアルリージョンバックアップ機能は、 - TiDB Cloud Starterインスタンスでは、特定時点への復元機能は利用できません。 - TiDB Cloud Essentialインスタンスの場合、過去30日間の任意の時点に復元できます。詳細については、 [復元モード](/tidb-cloud/backup-and-restore-serverless.md#restore-mode)参照してください。 - TiDB Cloud Dedicatedクラスターの場合、事前に[PITRを有効にする](/tidb-cloud/backup-and-restore.md#turn-on-point-in-time-restore)必要があります。 + +## Restore {#restore} + +TiDB Cloud は、バックアップスナップショットまたはポイントインタイムリカバリから、新しいクラスターまたはインスタンスにデータを復元することをサポートしています。復元操作は、誤ったデータ損失、データ破損、またはアプリケーションエラーからのリカバリに役立ちます。 + +{{{ .premium }}} および {{{ .byoc }}} インスタンスでは、新しいインスタンスにデータを復元できます。自動バックアップ、手動バックアップ、またはサポートされている外部クラウドストレージのバックアップから復元できます。PITR は自動バックアップでのみサポートされ、手動バックアップではサポートされません。 diff --git a/tidb-cloud/manage-projects-and-resources.md b/tidb-cloud/manage-projects-and-resources.md index 51c2d596050cf..0f1a352028f4b 100644 --- a/tidb-cloud/manage-projects-and-resources.md +++ b/tidb-cloud/manage-projects-and-resources.md @@ -13,8 +13,8 @@ summary: TiDB Cloudのリソースとプロジェクトの管理方法につい TiDB Cloudのリソースは、管理可能なデプロイ可能な単位です。以下のいずれかになります。 -- TiDB Xインスタンスは、 [TiDB Xアーキテクチャ](/tidb-cloud/tidb-x-architecture.md)上に構築されたサービス指向のTiDB Cloud製品です。TiDB Cloud Starter、 Essential、またはPremiumインスタンスなど。 -- TiDB Cloud Dedicatedクラスター +- TiDB Xインスタンスは、[TiDB Xアーキテクチャ](/tidb-cloud/tidb-x-architecture.md)上に構築されたサービス指向のTiDB Cloud製品です。{{{ .starter }}}、Essential、Premium、またはBYOCインスタンスなどがあります。 +- {{{ .dedicated }}}クラスター ### TiDB Cloudプロジェクト {#tidb-cloud-projects} @@ -45,6 +45,12 @@ TiDB Cloudリソースを作成するには、組織の[**私のTiDB**](https:// - [TiDB Cloud Premiumインスタンスを作成する](/tidb-cloud/premium/create-tidb-instance-premium.md) + + +- [TiDB Cloud {{{ .byoc }}}インスタンスを作成する](/tidb-cloud/byoc/create-tidb-instance-byoc.md) + + + - [TiDB Cloud Dedicatedクラスタを作成する](/tidb-cloud/create-tidb-cluster.md) ### TiDB Cloudのリソースを管理する {#manage-tidb-cloud-resources} @@ -94,9 +100,22 @@ TiDB Cloudのリソースをプロジェクトごとにグループ化して表 - プロジェクトが TiDB X インスタンス用に作成されている場合は、 **[確認]**をクリックします。 + + > **Note:** > - > TiDB Cloud Premium インスタンスの場合、暗号化はプロジェクトごとではなくインスタンスごとに構成されます。インスタンスを作成した後、 [二重層データ暗号化](/tidb-cloud/premium/dual-layer-data-encryption-premium.md)有効にして、デフォルトのストレージ層の暗号化に加えてデータベース層の暗号化を追加できます。 + > TiDB Cloud Premium インスタンスの場合、暗号化はプロジェクトごとではなくインスタンスごとに構成されます。インスタンスを作成した後、 [二重層データ暗号化](/tidb-cloud/premium/dual-layer-data-encryption-premium.md)を有効にして、デフォルトのストレージ層の暗号化に加えてデータベース層の暗号化を追加できます。 + + + + + +> **Note:** + > + > - {{{ .byoc }}} インスタンスでは、プロジェクトは任意です。データプレーンはお客様自身のクラウドアカウントで実行され、BYOC 環境レベルの設定は BYOC オンボーディング時に構成されます。 + > - {{{ .premium }}} インスタンスでは、暗号化はプロジェクト単位ではなくインスタンス単位で構成されます。インスタンスの作成後、[二重層データ暗号化](/tidb-cloud/premium/dual-layer-data-encryption-premium.md) を有効にして、デフォルトのストレージレイヤー暗号化の上にデータベースレイヤー暗号化を追加できます。 + + - プロジェクトがTiDB Cloud Dedicatedクラスター用に作成されている場合は、 **「Dedicatedクラスタ用に作成」**オプションを選択し、プロジェクトの [顧客管理型暗号化キー（CMEK）](/tidb-cloud/tidb-cloud-encrypt-cmek-aws.md)と[メンテナンスウィンドウ](/tidb-cloud/configure-maintenance-window.md)を構成して、 **「確認」**をクリックします。 diff --git a/tidb-cloud/manage-user-access.md b/tidb-cloud/manage-user-access.md index e972b5f987de4..878044a7e62fb 100644 --- a/tidb-cloud/manage-user-access.md +++ b/tidb-cloud/manage-user-access.md @@ -135,7 +135,8 @@ TiDB Cloudは、組織、プロジェクト、インスタンスの各レベル | プロジェクト内のすべてのTiDB Cloud Starterインスタンスの[支出限度額](/tidb-cloud/manage-serverless-spend-limit.md)を管理します。 | ✅ | ❌ | ❌ | ❌ | | プロジェクトの種類に応じてサポートされるインスタンスやクラスタの作成、変更、移動、削除など、プロジェクト内のリソース操作を管理します。 | ✅ | ❌ | ❌ | ❌ | | プロジェクト内のTiDB Cloud StarterおよびTiDB Cloud Essentialインスタンスのブランチを管理します。ブランチの作成、接続、削除などを行います。 | ✅ | ❌ | ❌ | ❌ | -| データインポート、データバックアップと復元、データ移行などのリソースデータを管理します。 | ✅ | ✅ | ❌ | ❌ | +| データインポート、データバックアップ、データ移行などのリソースデータを管理します。 | ✅ | ✅ | ❌ | ❌ | +| バックアップからインスタンスまたはクラスターを新しいリソースとして復元します。 | ✅ | ❌ | ❌ | ❌ | | データを読み取るためのエンドポイントの使用または作成など、データ読み取り専用操作の[データサービス](/tidb-cloud/data-service-overview.md)を管理します。 | ✅ | ✅ | ✅ | ❌ | | データの読み取りおよび書き込み操作のための[データサービス](/tidb-cloud/data-service-overview.md)を管理します。 | ✅ | ✅ | ❌ | ❌ | | リソース タイプでサポートされている場合は、[SQLエディタ](/tidb-cloud/explore-data-with-chat2query.md)を使用してリソース データを確認する。 | ✅ | ✅ | ✅ | ❌ | diff --git a/tidb-cloud/premium/backup-and-restore-premium.md b/tidb-cloud/premium/backup-and-restore-premium.md index c2e78e4a7c8b7..13ee574997349 100644 --- a/tidb-cloud/premium/backup-and-restore-premium.md +++ b/tidb-cloud/premium/backup-and-restore-premium.md @@ -8,6 +8,12 @@ aliases: ['/ja/tidbcloud/restore-deleted-tidb-cluster'] このドキュメントでは、 TiDB Cloud Premiumインスタンス上のデータのバックアップと復元方法について説明します。TiDB Cloud Premiumは、自動バックアップと手動バックアップの両方をサポートしており、必要に応じてバックアップデータを新しいインスタンスに復元できます。 + + +このドキュメントは {{{ .byoc }}} にも適用されます。現在、{{{ .byoc }}} のバックアップおよび復元機能は {{{ .premium }}} と同等です。 + + + バックアップファイルは、以下のソースから生成される可能性があります。 - アクティブなTiDB Cloud Premiumインスタンス @@ -162,14 +168,16 @@ TiDB Cloudは、新しいインスタンスへのデータ復元をサポート > > 複数の組織に所属している場合は、左上隅のコンボボックスを使用して、まず目的の組織に切り替えてください。 -2. **ごみ箱**ページで、 **[Premium]**タブをクリックすると、 TiDB Cloud Premiumインスタンスのごみ箱に移動します。 +2. **Recycle Bin**ページで、**Premium****BYOC** タブをクリックして、{{{ .premium }}}{{{ .byoc }}} インスタンスのごみ箱に移動します。 -3. 復元したいTiDB Cloud Premiumインスタンスを見つけて、[ **>]**ボタンをクリックして、そのインスタンスの利用可能なバックアップを展開します。 +3. 復元したい{{{ .premium }}}{{{ .byoc }}}インスタンスを見つけて、**>** ボタンをクリックし、そのインスタンスで利用可能なバックアップを展開します。 4. 復元したいバックアップの行で、 **...**をクリックし、次に**「復元」**を選択します。 5. **[復元]**ページで、[新しいインスタンスに復元する](#restore-to-a-new-instance)と同じ手順に従って、バックアップを新しいインスタンスに復元します。 + + ### 別のプランタイプからバックアップを復元する {#restore-backups-from-a-different-plan-type} 現在、AWS上でホストされているTiDB Cloud Dedicatedクラスタから新しいTiDB Cloud Premiumインスタンスへのバックアップ復元のみが可能です。 @@ -187,9 +195,11 @@ TiDB Cloud Dedicatedクラスターによって生成されたバックアップ 3. **[復元]**ページで、[新しいインスタンスに復元する](#restore-to-a-new-instance)と同じ手順に従って、バックアップを新しいインスタンスに復元します。 + + ### クラウドストレージからバックアップを復元する {#restore-backups-from-cloud-storage} -TiDB Cloud Premiumは、クラウドストレージ（Amazon S3やAlibaba Cloud Object Storage Service（OSS）など）から新しいインスタンスへのバックアップ復元をサポートしています。この機能は、 TiDB Cloud DedicatedクラスタまたはTiDB Self-Managedクラスタから生成されたバックアップと互換性があります。 +{{{ .premium }}}{{{ .byoc }}} は、クラウドストレージ（Amazon S3 や Alibaba Cloud Object Storage Service（OSS）など）から新しいインスタンスへのバックアップの復元をサポートしています。この機能は、{{{ .dedicated }}} クラスターまたは TiDB Self-Managed クラスターから生成されたバックアップと互換性があります。 > **Note:** > diff --git a/tidb-cloud/releases/_index.md b/tidb-cloud/releases/_index.md index a152f24d12724..5fd3b17af06c3 100644 --- a/tidb-cloud/releases/_index.md +++ b/tidb-cloud/releases/_index.md @@ -1,16 +1,35 @@ --- title: TiDB Cloud Releases -summary: TiDB Cloud のリリース ノートとメンテナンス通知について説明します。 +summary: TiDB Cloud のリリース ノート、カーネルのバージョン管理、メンテナンス通知について説明します。 --- # TiDB Cloudリリース {#tidb-cloud-releases} -[TiDB Cloud](https://www.pingcap.com/tidb/cloud/) 、オープンソースのハイブリッドトランザクションおよび分析処理（HTAP）データベースである[TiDB](https://docs.pingcap.com/tidb/stable/overview)クラウドに提供する、フルマネージドの Database-as-a-Service（DBaaS）です。TiDB Cloud は、データベースの複雑な処理に煩わされることなく、アプリケーション開発に集中できるよう、データベースの導入と管理を容易にします。このドキュメントでは、 TiDB Cloud のリリースノートとメンテナンス通知の概要を説明します。 +[TiDB Cloud](https://www.pingcap.com/tidb/cloud/)は、オープンソースのハイブリッドトランザクションおよび分析処理（HTAP）データベースである[TiDB](https://docs.pingcap.com/tidb/stable/overview)をクラウドに提供する、フルマネージドの Database-as-a-Service（DBaaS）です。 -## リリースノート {#release-notes} +TiDB Cloud には、[クラウドプラットフォーム リリース](#cloud-platform-release-notes) と [データベース カーネル リリース](#database-kernel-release-notes) の 2 種類のリリースがあります。これらは独立したリリース サイクルに従い、別々に文書化されています。 -TiDB Cloudリリースノートには、各リリースにおける新機能と改善点に関する情報が記載されています。詳細なリリースノートについては、 [TiDB Cloudリリースノート](/tidb-cloud/releases/tidb-cloud-release-notes.md)ご覧ください。 +## クラウドプラットフォーム リリースノート + +クラウドプラットフォーム リリースには、TiDB Cloud のコンソール、API、コントロールプレーンが含まれ、すべての TiDB Cloud プランにわたる新しいプラン機能、UI の変更、統合、運用上の改善が含まれます。 + +- [TiDB Cloud Release Notes](/tidb-cloud/releases/tidb-cloud-release-notes.md) + +## データベース カーネル リリースノート + +データベース カーネルは、SQL クエリを処理し、データを管理するコア エンジンです。TiDB Cloud プランに応じて、ご利用のリソースは異なるカーネルで実行され、それぞれ独自のリリース サイクルを持ちます。 + +| Plan | Kernel information and release notes | +| --- | --- | +| TiDB Cloud **Starter** | クラシック [TiDB v8.5.3](https://docs.pingcap.com/tidb/stable/release-8.5.3/) カーネルをベースにしたカスタマイズ版 [TiDB X](/tidb-cloud/tidb-x-architecture.md) エンジンで実行されます。 | +| TiDB Cloud **Essential** | デフォルトでは、クラシック [TiDB v8.5.3](https://docs.pingcap.com/tidb/stable/release-8.5.3/) カーネルをベースにしたカスタマイズ版 [TiDB X](/tidb-cloud/tidb-x-architecture.md) エンジンで実行されます。 | +| TiDB Cloud **Premium** | [TiDB X](/tidb-cloud/tidb-x-architecture.md) カーネルの [`TiDB-X-CLOUD.202510.1`](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) バージョンで実行されます。 | +| TiDB Cloud **Dedicated** | クラシック TiDB カーネルで実行され、カーネル バージョンは TiDB Self-Managed のバージョンに直接対応します。現在、新しく作成された TiDB Cloud Dedicated クラスターのデフォルト TiDB バージョンは [v8.5.7](https://docs.pingcap.com/tidb/stable/release-8.5.7/) です。 | + +> **Note:** +> +> TiDB Cloud Essential インスタンスを TiDB Cloud Premium と同じカーネルで実行したい場合は、[TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support) にお問い合わせください。 ## メンテナンス通知 {#maintenance-notifications} -TiDB Cloudメンテナンス通知は、 TiDB Cloudサービスに影響を及ぼす可能性のある、スケジュールされたメンテナンス アクティビティに関する情報を提供します。 +TiDB Cloudメンテナンス通知は、 TiDB Cloudサービスに影響を及ぼす可能性のある、スケジュールされたメンテナンス アクティビティに関する情報を提供します。通知の一覧については、左側のナビゲーション ペインを参照してください。 diff --git a/tidb-cloud/releases/tidb-cloud-kernel-versioning.md b/tidb-cloud/releases/tidb-cloud-kernel-versioning.md new file mode 100644 index 0000000000000..147c7ddcdc4e9 --- /dev/null +++ b/tidb-cloud/releases/tidb-cloud-kernel-versioning.md @@ -0,0 +1,49 @@ +--- +title: TiDB Cloud Premium のカーネルバージョニング +summary: TiDB Cloud Premium のカーネルのバージョニング規則と形式について説明します。 +--- + +# TiDB Cloud Premium のカーネルバージョニング + +このドキュメントでは、TiDB Cloud Premium で使用される基盤データベースカーネルのバージョニング規則について説明します。 + +> **Note:** +> +> このドキュメントで説明するカーネルバージョニング規則は、TiDB Cloud Premium にのみ適用されます。その他の TiDB Cloud プランでは、異なるカーネルバージョニングモデルが使用されます。 +> +> - TiDB Cloud Starter インスタンスは、従来の TiDB v8.5.3 カーネルをベースにしたカスタマイズ済みの TiDB X エンジン上で動作します。このカーネルは、TiDB Cloud Premium のカーネルとは若干異なります。 +> - TiDB Cloud Essential インスタンスは、デフォルトで従来の TiDB v8.5.3 カーネルをベースにしたカスタマイズ済みの TiDB X エンジン上で動作します。TiDB Cloud Essential インスタンスを TiDB Cloud Premium と同じカーネルで動作させたい場合は、[TiDB Cloud Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support) にお問い合わせください。 +> - TiDB Cloud Dedicated クラスターは、従来の TiDB カーネル上で動作し、そのカーネルバージョンは TiDB Self-Managed のバージョンに直接対応します。 + +## カーネルバージョニング {#kernel-versioning} + +TiDB Cloud Premium のカーネルバージョンは、次の日付ベースの形式を使用します。 + +```text +TiDB-X-CLOUD.YYYYMM.x +``` + +例: + +```text +TiDB-X-CLOUD.202510.1 +``` + +各要素の意味は次のとおりです。 + +- `YYYYMM` は、カーネルの開発に使用されたベースラインコードブランチを示します。たとえば、`202510` はベースラインブランチが 2025 年 10 月に作成されたことを意味します。これは、カーネルバージョンのリリース時期を示すものではありません。 +- `x` は、そのベースラインブランチに対するパッチリリース番号を示します。 + +たとえば、`TiDB-X-CLOUD.202510.1` は、そのカーネルが 2025 年 10 月に作成されたブランチに基づいており、そのブランチからビルドされた最初のパッチリリースであることを示します。 + +カーネルの開発スケジュールとリリーススケジュールは独立しているため、カーネルバージョンはベースラインブランチの作成から数か月後にリリースされる場合があります。 + +TiDB Cloud Premium は独自のカーネルリリースサイクルに従うため、[TiDB Cloud Premium リリースノート](/tidb-cloud/releases/tidb-x-cloud.202510.1.md) は [TiDB Self-Managed リリースノート](https://docs.pingcap.com/releases/tidb-self-managed/) とは別に公開されます。 + +## FAQ {#faq} + +### TiDB Cloud Premium インスタンスのカーネルバージョンを選択できますか？ {#can-i-choose-the-kernel-version-for-my-tidb-cloud-premium-instance} + +いいえ。TiDB Cloud は、TiDB Cloud Premium のカーネルライフサイクル全体を管理します。 + +TiDB Cloud は、新しいデプロイに対して検証済みのカーネルバージョンを自動的に提供し、必要に応じて管理されたアップグレードを実行します。これにより、手動メンテナンスを行うことなく、セキュリティ、安定性、互換性を確保しつつ、最新の機能や改善点を利用できます。 \ No newline at end of file diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index 3fbf398dd538a..6df6409321d16 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -8,6 +8,18 @@ aliases: ['/ja/tidbcloud/supported-tidb-versions','/ja/tidbcloud/release-notes'] このページには、2026年の[TiDB Cloud](https://www.pingcap.com/tidb-cloud/)のリリースノートが掲載されています。 +## 2026年7月21日 {#july-21-2026} + +**一般的な変更** + +- **TiDB Cloud Essential** + + - [Top RU](/tidb-cloud/top-ru.md)（パブリックプレビュー）が、[TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) で次の追加リージョンをサポートするようになりました。 + + - Alibaba Cloud: `Jakarta (ap-southeast-5)` + + この機能は、分単位で RU 消費量の多い上位の SQL を表示し、最もリソースを消費するクエリをすばやく特定してコストを削減するのに役立ちます。 + ## 2026年7月14日 {#july-14-2026} **一般的な変更** @@ -190,7 +202,7 @@ aliases: ['/ja/tidbcloud/supported-tidb-versions','/ja/tidbcloud/release-notes'] Alibaba Cloud Key Management Service (KMS) では、独自のキーを使用して保存データを暗号化できるため、データセキュリティとコンプライアンスをより詳細に管理できます。 - この機能はリクエストに応じて利用できるようになりました。詳細については、 [二重層データ暗号化](/tidb-cloud/premium/dual-layer-data-encryption-premium.md)参照してください。 + この機能はリクエストに応じて利用できるようになりました。詳細については、 [二重層データ暗号化](/tidb-cloud/premium/dual-layer-data-encryption-premium.md)を参照してください。 - TiDB Cloud Premiumインスタンス向けに、**メトリクス**ページ（**インスタンス概要**タブ）に2つの新しいTTL監視メトリクスを追加します。 diff --git a/tidb-cloud/releases/tidb-x-cloud.202510.1.md b/tidb-cloud/releases/tidb-x-cloud.202510.1.md new file mode 100644 index 0000000000000..6d533666d2d27 --- /dev/null +++ b/tidb-cloud/releases/tidb-x-cloud.202510.1.md @@ -0,0 +1,69 @@ +--- +title: TiDB-X-CLOUD.202510.1 リリースノート +summary: TiDB-X-CLOUD.202510.1 カーネルの機能について説明します。 +--- + +# TiDB-X-CLOUD.202510.1 Release Notes + +**リリース日**: 2026年4月28日 + +**適用される TiDB Cloud プラン**: {{{ .premium }}} + +**TiDB X カーネルバージョン**: `TiDB-X-CLOUD.202510.1` + +{{{ .premium }}} は、`TiDB-X-CLOUD.202510.1` カーネルを使用して、2026年4月28日よりパブリックプレビューで利用できます。 + +`TiDB-X-CLOUD.202510.1` では、次のようになります。 + +- `202510` は、このカーネルバージョンのベースラインコードブランチが 2025 年 10 月に作成されたことを示しており、リリース日とは異なります。 +- `1` は、`TiDB-X-CLOUD.202510` ベースラインブランチからビルドされた最初のパッチリリースであることを示します。 + +`TiDB-X-CLOUD.202510.1` カーネルは [TiDB v8.5.0](https://docs.pingcap.com/tidb/stable/release-8.5.0/) カーネルをベースとしており、TiDB v8.5.0 で導入された機能と改善の大部分を含んでいます。 + +さらに、[TiDB v8.5.0](https://docs.pingcap.com/tidb/stable/release-8.5.0/) カーネルと比較して、`TiDB-X-CLOUD.202510.1` カーネルでは次の機能が導入されています。 + +## 新しい TiDB X アーキテクチャ {#new-tidb-x-architecture} + +* TiDB X アーキテクチャを導入しました。これは、クラウドネイティブなオブジェクトストレージを TiDB の中核とする、クラウドネイティブな共有ストレージアーキテクチャです。 + + このアーキテクチャにより、AI 時代のワークロードに向けて、弾力的なスケーラビリティ、予測可能なパフォーマンス、そして最適化された総保有コスト（TCO）を実現します。 + + TiDB X は、[従来の TiDB](https://docs.pingcap.com/tidbcloud/tidb-architecture/?plan=premium) の shared-nothing アーキテクチャから、クラウドネイティブな共有ストレージアーキテクチャへの本質的な進化を表しています。shared-nothing から共有ストレージアーキテクチャへ移行することで、TiDB X は結合されたノードの物理的な制約に対処し、次の技術目標を達成します。 + + - **スケーリングの高速化**: 物理データ移行の必要をなくすことで、スケーリング性能を最大 10 倍向上させます。 + - **タスク分離**: バックグラウンドのメンテナンスタスク（compaction など）とオンラインのトランザクション処理トラフィックの間で、干渉が発生しないようにします。 + - **リソースの弾力性**: コンピュートリソースがストレージ容量とは独立してスケールする、真の「pay-as-you-go」モデルを実現します。 + + 詳細は、[TiDB X アーキテクチャ](https://docs.pingcap.com/tidbcloud/tidb-x-architecture/?plan=premium) を参照してください。 + +## パフォーマンス機能 {#performance-features} + +* 特定のテーブルのデータ再分散をサポートしました（実験的） [#63260](https://github.com/pingcap/tidb/issues/63260) @[bufferflies](https://github.com/bufferflies) + + PD は、クラスター内のすべての TiKV ノードに対して、データができるだけ均等に分散されるよう自動的にスケジューリングします。ただし、この自動スケジューリングはクラスター全体を対象としています。そのため、クラスター全体でのデータ分散が均衡していても、特定のテーブルのデータは TiKV ノード間で不均一に分散されている場合があります。 + + [`SHOW TABLE DISTRIBUTION`](https://docs.pingcap.com/tidbcloud/sql-statement-show-table-distribution/?plan=premium) ステートメントを使用して、特定のテーブルのデータがすべての TiKV ノードにどのように分散されているかを確認できるようになりました。データ分散が不均衡な場合は、[`DISTRIBUTE TABLE`](https://docs.pingcap.com/tidbcloud/sql-statement-distribute-table/?plan=premium) ステートメントを使用して、テーブルのデータを再分散（実験的）し、負荷分散を改善できます。 + + 特定のテーブルのデータ再分散は、タイムアウト制限のある 1 回限りのタスクであることに注意してください。分散タスクがタイムアウトまでに完了しない場合、自動的に終了します。 + + 詳細は、[ドキュメント](https://docs.pingcap.com/tidbcloud/sql-statement-distribute-table/?plan=premium) を参照してください。 + +* DDL ステートメントに埋め込まれた `ANALYZE` をサポートしました [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) + + この機能は、次の種類の DDL ステートメントに適用されます。 + + - 新しいインデックスを作成する DDL ステートメント: [`ADD INDEX`](https://docs.pingcap.com/tidbcloud/sql-statement-add-index/?plan=premium) + - 既存のインデックスを再編成する DDL ステートメント: [`MODIFY COLUMN`](https://docs.pingcap.com/tidbcloud/sql-statement-modify-column/?plan=premium) および [`CHANGE COLUMN`](https://docs.pingcap.com/tidbcloud/sql-statement-change-column/?plan=premium) + + この機能を有効にすると、新規または再編成されたインデックスがユーザーから見えるようになる前に、TiDB が自動的に `ANALYZE`（統計情報収集）操作を実行します。これにより、インデックス作成または再編成の直後に統計情報が一時的に利用できないことで発生する、オプティマイザの不正確な見積もりや、潜在的な実行計画の変更を防ぎます。 + + 詳細は、[ドキュメント](https://docs.pingcap.com/tidbcloud/ddl_embedded_analyze/?plan=premium) を参照してください。 + +## 制限事項 {#limitations} + +TiDB X と 従来の TiDB のアーキテクチャの違いにより、TiDB X カーネルは 従来の TiDB カーネルの次のストレージ機能をサポートしていません。 + +- [TiKV MVCC In-Memory Engine (IME)](https://docs.pingcap.com/tidb/v8.5/tikv-in-memory-engine) +- [Follower Read](https://docs.pingcap.com/tidb/v8.5/follower-read) + +制限事項の詳細については、[TiDB X インスタンスで制限される SQL 機能](https://docs.pingcap.com/tidbcloud/limited-sql-features-tidb-x/?plan=premium) を参照してください。 \ No newline at end of file diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index a0a808a4515c8..87b8cd68f7405 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -10,10 +10,24 @@ aliases: ['/ja/tidbcloud/developer-tier-cluster'] TiDB Cloud、以下のプランをご用意しています。新規導入の場合でも、アプリケーションの需要増加に合わせて拡張していく場合でも、これらのサービスプランは必要な柔軟性と機能を提供します。TiDBリソースを作成する前に、どのプランがお客様のニーズに最適かを検討する必要があります。 -- [TiDB Cloud Starter](#starter) -- [TiDB Cloud Essential](#essential) -- [TiDB Cloud Premium](#premium) -- [TiDB Cloud Dedicated](#tidb-cloud-dedicated) + + +- [{{{ .starter }}}](#starter) +- [{{{ .essential }}}](#essential) +- [{{{ .premium }}}](#premium) +- [{{{ .dedicated }}}](#tidb-cloud-dedicated) + + + + + +- [{{{ .starter }}}](#starter) +- [{{{ .essential }}}](#essential) +- [{{{ .premium }}}](#premium) +- [{{{ .byoc }}}](#byoc) +- [{{{ .dedicated }}}](#tidb-cloud-dedicated) + + > **Note:** > @@ -106,6 +120,22 @@ TiDB Cloud StarterまたはTiDB Cloud Essentialインスタンスのプレフィ - **予測可能な料金体系**：storageとリクエスト容量ユニット（RCU）に基づいて課金されるため、ニーズに合わせて拡張可能な透明性の高い使用量ベースの料金体系が実現し、予期せぬ追加料金なしで使用した分だけを支払うことができます。 - **高度なセキュリティとコンプライアンス**：高度な暗号化、顧客管理型暗号化キー（CMEK）、プライベートネットワーク、およびコンプライアンス認証をサポートし、機密データを保護します。 + + +## {{{ .byoc }}} {#byoc} + +{{{ .byoc }}} は、データの配置場所、クラウドリソース、ネットワーク境界、コンプライアンス体制をより強力に制御する必要があるエンタープライズワークロード向けに設計されています。{{{ .byoc }}} では、TiDB Cloud のコントロールプレーンは PingCAP によって管理され、データプレーンはお客様自身のクラウドアカウント内で実行されます。 + +{{{ .byoc }}} は、以下の機能を備えたマネージド TiDB Cloud エクスペリエンスを提供します。 + +- **Customer-owned data plane**: TiDB サービスのリソース、ストレージ、ネットワーク、およびデータをお客様のクラウドアカウント内に保持します。 +- **Managed operations**: デプロイ、スケーリング、モニタリング、アップグレード、バックアップとリストア、ライフサイクル管理に TiDB Cloud を使用します。 +- **Flexible high availability**: Single-AZ と Multi-AZ の両方のデプロイをサポートし、低レイテンシーのゾーン単位デプロイと、複数のアベイラビリティゾーンにまたがる高い耐障害性を持つデプロイのいずれかを選択できます。 +- **Cloud-account-level security controls**: 独自のクラウドポリシー、ネットワーク制御、監査ログ、およびコンプライアンス制御を BYOC データプレーンに適用できます。 +- **Private connectivity**: BYOC の設定に応じて、VPC peering などのプライベートネットワークアクセスパターンをサポートします。 + + + ## TiDB Cloud Dedicated {#tidb-cloud-dedicated} TiDB Cloud Dedicatedは、ゾーン間高可用性、水平スケーリング、 [HTAP](https://en.wikipedia.org/wiki/Hybrid_transactional/analytical_processing)といったメリットを備えた、本番での利用を想定したサービスです。 diff --git a/tidb-cloud/tidb-cloud-intro.md b/tidb-cloud/tidb-cloud-intro.md index f5a8e586b629b..dc2089ac085bc 100644 --- a/tidb-cloud/tidb-cloud-intro.md +++ b/tidb-cloud/tidb-cloud-intro.md @@ -118,6 +118,16 @@ TiDB Cloudは、以下の導入オプションを提供します。 + + +- {{{ .byoc }}} + + {{{ .byoc }}}は、より高度な制御、セキュリティ、およびコンプライアンスを必要とする大規模な本番ワークロード向けに設計されています。TiDB Cloudの自動運用、伸縮自在なスケーラビリティ、エンタープライズグレードのセキュリティの利点を活用しながら、自身のAWSアカウントでデータプレーンを実行できます。 + + 現在、{{{ .byoc }}}はAWSでプライベートプレビュー版として提供されています。 + + + - TiDB Cloud Dedicated TiDB Cloud Dedicatedは、ミッションクリティカルなビジネス向けに設計されており、複数のアベイラビリティゾーンにわたる高可用性、水平スケーリング、および完全な[HTAP](https://en.wikipedia.org/wiki/Hybrid_transactional/analytical_processing)機能を提供します。 @@ -140,6 +150,14 @@ TiDB Cloudは、以下の導入オプションを提供します。 プライベート エンドポイント接続または VPC ピアリング接続を介してTiDB Cloudリソースに接続できます。詳細については[プライベートエンドポイント接続を設定する](/tidb-cloud/set-up-private-endpoint-connections.md)または[VPCピアリング接続の設定](/tidb-cloud/set-up-vpc-peering-connections.md)を参照してください。 + + +> **Note:** +> +> TiDB Cloud BYOC は、他の TiDB Cloud のデプロイオプションとは異なるアーキテクチャを採用しています。BYOC では、TiDB Cloud のコントロールプレーンは PingCAP によって管理され、データプレーンはお客様自身のクラウドアカウントで実行されます。詳細については、[TiDB Cloud BYOC アーキテクチャ](/tidb-cloud/architecture-concepts.md#tidb-cloud-byoc) を参照してください。 + + + ## 関連リソース {#related-resources} diff --git a/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md b/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md index 77d57bccd7e94..740934f9f0695 100644 --- a/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md +++ b/tidb-cloud/v8.1-performance-benchmarking-with-tpcc.md @@ -96,8 +96,8 @@ raft-engine.prefill-for-recycle = true ```sql SET tidb_build_stats_concurrency=16; - SET tidb_distsql_scan_concurrency=16; - SET tidb_index_serial_scan_concurrency=16; + SET tidb_build_sampling_stats_concurrency=16; + SET tidb_analyze_distsql_scan_concurrency=16; ``` 5. TiDB Cloud Dedicated クラスタでストレステストを実行するには、以下のコマンドを`go-tpc tpcc`実行します。同時実行ごとにテストは 2 時間かかります。 diff --git a/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md b/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md index 86115ec572924..26163c48bb733 100644 --- a/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md +++ b/tidb-cloud/v8.5-performance-benchmarking-with-tpcc.md @@ -96,8 +96,8 @@ raft-engine.prefill-for-recycle = true ```sql SET tidb_build_stats_concurrency=16; - SET tidb_distsql_scan_concurrency=16; - SET tidb_index_serial_scan_concurrency=16; + SET tidb_build_sampling_stats_concurrency=16; + SET tidb_analyze_distsql_scan_concurrency=16; ``` 5. TiDB Cloud Dedicated クラスタでストレステストを実行するには、以下のコマンドを`go-tpc tpcc`実行します。同時実行ごとにテストは 2 時間かかります。 diff --git a/troubleshoot-tidb-oom.md b/troubleshoot-tidb-oom.md index 5b85788a6cdd3..92154dad94d41 100644 --- a/troubleshoot-tidb-oom.md +++ b/troubleshoot-tidb-oom.md @@ -99,7 +99,6 @@ OOM 問題のさまざまな原因に応じて、SQL ステートメントのメ - 同時実行数の増加によるメモリ問題を回避するには、同時に読み取る領域の数を減らすか、演算子の同時実行数を減らしてください。対応するシステム変数は次のとおりです。 - [`tidb_distsql_scan_concurrency`](/system-variables.md#tidb_distsql_scan_concurrency) - - [`tidb_index_serial_scan_concurrency`](/system-variables.md#tidb_index_serial_scan_concurrency) - [`tidb_executor_concurrency`](/system-variables.md#tidb_executor_concurrency-new-in-v50) - 問題発生時点付近では、セッションの同時実行性が高すぎます。この場合は、TiDBノードを追加してTiDBクラスターをスケールアウトすることを検討してください。