Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
bc75245
[create-pull-request] automated change
qiancai Jul 22, 2026
933e62f
retranslate changes in system-variables.md
qiancai Jul 23, 2026
b75d23a
i18n(ja): unify "full-text index" as 全文インデックス
yahonda Jul 23, 2026
aa8fabf
i18n(ja): translate "term frequency" as 単語頻度 instead of 項頻度
yahonda Jul 23, 2026
6d83b0a
i18n(ja): simplify "weight contribution" wording
yahonda Jul 23, 2026
7052992
i18n(ja): reword "index fields" as インデックス列
yahonda Jul 23, 2026
3f3b3b4
i18n(ja): restore dropped particles in the TiDB Cloud definition
yahonda Jul 23, 2026
568644d
i18n(ja): render "your resources" as ご利用のリソース
yahonda Jul 23, 2026
1d128df
i18n(ja): fix "time-based" as 日付ベース (not 時刻ベース)
yahonda Jul 23, 2026
3faf1a2
i18n(ja): translate "release notes" link text as リリースノート
yahonda Jul 23, 2026
c29f822
i18n(ja): translate "classic TiDB" as 従来の TiDB
yahonda Jul 23, 2026
b0feaba
i18n(ja): translate "Architecture" in link text as アーキテクチャ
yahonda Jul 23, 2026
e5c366c
i18n(ja): improve L45 wording and translate "documentation" link text
yahonda Jul 23, 2026
6efedeb
i18n(ja): translate descriptive link texts to match target page titles
yahonda Jul 23, 2026
d0fa178
i18n(ja): unify control plane/data plane katakana, keep UI labels in …
yahonda Jul 23, 2026
ffa0c90
i18n(ja): render "VPC peering" as VPC ピアリング
yahonda Jul 23, 2026
bea9ca2
i18n(ja): restore を dropped after the 二重層データ暗号化 link
yahonda Jul 23, 2026
04c18d8
i18n(ja): fix "hypothetical indexes" mistranslation and a spurious link
yahonda Jul 23, 2026
25d2cd9
i18n(ja): keep "Top RU" in English in the TOC entries too
yahonda Jul 23, 2026
f9f521c
retranslate tidb-cloud/tidb-cloud-intro.md
qiancai Jul 23, 2026
7f8b306
retranslate sync-diff-inspector/sync-diff-inspector-overview.md due t…
qiancai Jul 23, 2026
2927e99
i18n(ja): render "Security" as セキュリティ in the BYOC intro block
yahonda Jul 23, 2026
d632d9f
i18n(ja): translate "architecture" in the BYOC link text as アーキテクチャ
yahonda Jul 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion TOC-tidb-cloud-essential.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
- アラート通知を購読する
Expand Down
7 changes: 6 additions & 1 deletion TOC-tidb-cloud-premium.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
- アラート通知を購読する
Expand Down Expand Up @@ -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)
Expand All @@ -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)
Expand Down Expand Up @@ -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)
Expand All @@ -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)
Expand Down Expand Up @@ -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)
- サポートプラン
Expand Down
46 changes: 27 additions & 19 deletions TOC-tidb-cloud-releases.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,36 @@
<!-- markdownlint-disable MD007 -->

<!-- markdownlint-disable MD041 -->

# 目次

## リリースノート
## 概要

- [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)
123 changes: 119 additions & 4 deletions ai/guides/vector-search-full-text-search-sql.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ TiDBの全文検索機能は、以下の機能を提供します。

全文検索を実行するには、効率的な検索とランキングに必要なデータ構造を提供する全文インデックスが必要です。全文インデックスは、新規テーブルに作成することも、既存のテーブルに追加することもできます。

全文検索インデックス付きのテーブルを作成します
全文インデックス付きのテーブルを作成します

```sql
CREATE TABLE stock_items(
Expand All @@ -54,7 +54,7 @@ CREATE TABLE stock_items(
);
```

または、既存のテーブルに全文検索インデックスを追加します
または、既存のテーブルに全文インデックスを追加します

```sql
CREATE TABLE stock_items(
Expand All @@ -70,13 +70,63 @@ ALTER TABLE stock_items ADD FULLTEXT INDEX (title) WITH PARSER MULTILINGUAL ADD_

`WITH PARSER <PARSER_NAME>`句では、以下のパーサーが受け入れられます。

- `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の多言語パーサーがテキストを自動的に処理します。

Expand Down Expand Up @@ -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機能と組み合わせることができます。
Expand Down
2 changes: 1 addition & 1 deletion best-practices/tidb-best-practices.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)を調整することで増やすことができます

- 逆インデックススキャン

Expand Down
Loading
Loading