Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
f5ef916
[create-pull-request] automated change
qiancai Sep 30, 2026
df6093a
i18n(ja): fix spurious rewrites, a dropped line, and literal terms in…
yahonda Oct 1, 2026
f65dfd1
i18n(ja): translate the export verb in the Essential data pipeline guide
yahonda Oct 1, 2026
3a02f4f
i18n(ja): translate residual English and fix katakana spacing in the …
yahonda Oct 1, 2026
ac58a98
i18n(ja): unify the tiered storage term in the tiered storage docs an…
yahonda Oct 1, 2026
a795438
i18n(ja): keep the capitalized Segment layer name literal in the tier…
yahonda Oct 1, 2026
5401d9e
i18n(ja): translate flush, reload, compaction, and regions in the tie…
yahonda Oct 1, 2026
46cad89
i18n(ja): fix residual English, headings, and fluency in the Essentia…
yahonda Oct 1, 2026
f0405a6
i18n(ja): fix residual English, headings, and table headers in the ex…
yahonda Oct 1, 2026
6dc7296
i18n(ja): fix residual English, terms, and fluency in TOC, release no…
yahonda Oct 1, 2026
e6222e8
i18n(ja): translate private preview in the tiered storage docs
yahonda Oct 1, 2026
dd11ba4
i18n(ja): unify the external stage wording in the Alibaba Cloud data …
yahonda Oct 1, 2026
829b8b2
i18n(ja): align the Premium and Essential alert tables in the built-i…
yahonda Oct 1, 2026
768a4b7
i18n(ja): use the common rendering for reload in the tiered storage docs
yahonda Oct 1, 2026
6f779b7
i18n(ja): remove a stray space before a particle in the tiered storag…
yahonda Oct 1, 2026
02bf3ee
i18n(ja): translate integration in the Essential data pipeline guide …
yahonda Oct 1, 2026
f178ecc
i18n(ja): translate the See also heading in the Essential data pipeli…
yahonda Oct 1, 2026
9687ac3
i18n(ja): apply the EN billing note changes that the sync failed to t…
yahonda Oct 1, 2026
79a3441
i18n(ja): align two term renderings across the tiered storage docs
yahonda Oct 1, 2026
c1584b4
i18n(ja): fix stray spaces, missing newlines, and incomplete term fix…
yahonda Oct 1, 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
5 changes: 4 additions & 1 deletion TOC-tidb-cloud-essential.md
Original file line number Diff line number Diff line change
Expand Up @@ -144,9 +144,12 @@
- [Amazon S3からのデータインポート中に発生するアクセス拒否エラーのトラブルシューティング](/tidb-cloud/troubleshoot-import-access-denied-error.md)
- [AWS DMSをTiDB Cloudに接続する](/tidb-cloud/tidb-cloud-connect-aws-dms.md)
- ストリームデータ ![PREVIEW](/media/tidb-cloud/blank_transparent_placeholder.png)
- [変更フィードの概要](/tidb-cloud/essential-changefeed-overview.md)
- [変更フィード](/tidb-cloud/essential-changefeed-overview.md)
- [MySQLへのシンク](/tidb-cloud/essential-changefeed-sink-to-mysql.md)
- [Apache Kafkaへのシンク](/tidb-cloud/essential-changefeed-sink-to-kafka.md)
- [TiDB Cloud Lake へのシンク](/tidb-cloud/data-pipeline-essential-sink-to-lake.md)
- 参照
- [TiDB Cloud Lake 向け Data Pipeline SQL 互換性](/tidb-cloud/data-pipeline-lake-sql-compatibility.md)
- セキュリティ
- [セキュリティ概要](/tidb-cloud/security-overview.md)
- IDアクセス制御
Expand Down
18 changes: 17 additions & 1 deletion TOC-tidb-cloud-premium.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,14 +139,21 @@
- [Amazon S3からのデータインポート中に発生するアクセス拒否エラーのトラブルシューティング](/tidb-cloud/troubleshoot-import-access-denied-error.md)
- [AWS DMSをTiDB Cloudに接続する](/tidb-cloud/tidb-cloud-connect-aws-dms.md)
- ストリームデータ
- [変更フィードの概要](/tidb-cloud/changefeed-overview.md)
- [概要](/tidb-cloud/stream-data-overview.md)
- [変更フィード](/tidb-cloud/changefeed-overview.md)
- [Data Pipeline](/tidb-cloud/data-pipeline.md)
- [MySQLシンクへ](/tidb-cloud/changefeed-sink-to-mysql.md)
- [Kafkaシンクへ](/tidb-cloud/changefeed-sink-to-apache-kafka.md)
- [Cloud Storage へ](/tidb-cloud/changefeed-sink-to-cloud-storage.md)
- [TiDB Cloud Lake へ](/tidb-cloud/data-pipeline-sink-to-lake.md)
- 参照
- [AWSでセルフホスト型のKafkaプライベートリンクサービスをセットアップする](/tidb-cloud/setup-aws-self-hosted-kafka-private-link-service.md)
- [Changefeeds用のプライベートエンドポイントを設定する](/tidb-cloud/premium/set-up-sink-private-endpoint-premium.md)
- [AWS PrivateLink 経由で Amazon MSK Provisioned クラスターをセットアップする](/tidb-cloud/setup-aws-msk-provisioned-private-link-service.md)
- [TiDB Cloud Data Pipeline 用の外部 stage を設定する (AWS)](/tidb-cloud/data-pipeline-configure-external-stage-aws.md)
- [TiDB Cloud Data Pipeline 用の外部 stage を設定する (Alibaba Cloud)](/tidb-cloud/data-pipeline-configure-external-stage-alibaba-cloud.md)
- [TiDB Cloud Lake 向け Data Pipeline SQL 互換性](/tidb-cloud/data-pipeline-lake-sql-compatibility.md)
- [Data Pipeline FAQ](/tidb-cloud/data-pipeline-lake-faq.md)
- セキュリティ
- [セキュリティ概要](/tidb-cloud/security-overview.md)
- IDアクセス制御
Expand Down Expand Up @@ -503,3 +510,12 @@
- よくある質問
- [TiDB Cloudよくある質問](/tidb-cloud/tidb-cloud-faq.md)
- [用語集](/tidb-cloud/tidb-cloud-glossary.md)

## _BUILD_ALLOWLIST

- 階層型ストレージを使用する
- [階層型ストレージの概要](/tidb-cloud/tiered-storage-overview.md)
- [階層型ストレージの設定と管理](/tidb-cloud/tiered-storage-guide.md)
- [階層型ストレージの可観測性](/tidb-cloud/tiered-storage-observability.md)
- [階層型ストレージの制限事項](/tidb-cloud/tiered-storage-limitations.md)
- [階層型ストレージに関する FAQ](/tidb-cloud/tiered-storage-faq.md)
1 change: 1 addition & 0 deletions TOC-tidb-cloud-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@
## TiDB X KERNEL リリースノート

- [TiDB Cloud Premium 向けカーネルバージョニング](/tidb-cloud/releases/tidb-cloud-kernel-versioning.md)
- [TiDB-X-CLOUD.202603.1 リリースノート](/tidb-cloud/releases/tidb-x-cloud.202603.1.md)
- [TiDB-X-CLOUD.202510.1 リリースノート](/tidb-cloud/releases/tidb-x-cloud.202510.1.md)

## メンテナンス通知
Expand Down
4 changes: 3 additions & 1 deletion TOC-tidb-cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,17 +191,19 @@
- [データアプリ設定ファイル](/tidb-cloud/data-service-app-config-files.md)
- [応答とステータスコード](/tidb-cloud/data-service-response-and-status-code.md)
- ストリームデータ
- [変更フィードの概要](/tidb-cloud/changefeed-overview.md)
- [変更フィード](/tidb-cloud/changefeed-overview.md)
- [MySQLシンクへ](/tidb-cloud/changefeed-sink-to-mysql.md)
- [Kafkaシンクへ](/tidb-cloud/changefeed-sink-to-apache-kafka.md)
- [Pulsarシンクへ](/tidb-cloud/changefeed-sink-to-apache-pulsar.md)
- [TiDB Cloud Sinkへ](/tidb-cloud/changefeed-sink-to-tidb-cloud.md)
- [クラウドストレージへ](/tidb-cloud/changefeed-sink-to-cloud-storage.md)
- [TiDB Cloud Lake へ](/tidb-cloud/data-pipeline-dedicated-sink-to-lake.md)
- 参照
- [AWSでセルフホスト型のKafkaプライベートリンクサービスをセットアップする](/tidb-cloud/setup-aws-self-hosted-kafka-private-link-service.md)
- [Azureでセルフホスト型Kafkaプライベートリンクサービスをセットアップする](/tidb-cloud/setup-azure-self-hosted-kafka-private-link-service.md)
- [Google Cloud でセルフホスト型の Kafka プライベートサービスコネクトを設定する](/tidb-cloud/setup-self-hosted-kafka-private-service-connect.md)
- [Changefeeds用のプライベートエンドポイントを設定する](/tidb-cloud/set-up-sink-private-endpoint.md)
- [TiDB Cloud Lake 向け Data Pipeline SQL 互換性](/tidb-cloud/data-pipeline-lake-sql-compatibility.md)
- セキュリティ
- [セキュリティ概要](/tidb-cloud/security-overview.md)
- IDアクセス制御
Expand Down
6 changes: 3 additions & 3 deletions TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -816,7 +816,7 @@
- [日付と時刻の種類](/data-type-date-and-time.md)
- [文字列型](/data-type-string.md)
- [JSONタイプ](/data-type-json.md)
- [ベクトルタイプ](/ai/reference/vector-search-data-types.md)
- [ベクトル型](https://docs.pingcap.com/ai/vector-search-data-types/)
- 関数と演算子
- [概要](/functions-and-operators/functions-and-operators-overview.md)
- [式評価における型変換](/functions-and-operators/type-conversion-in-expression-evaluation.md)
Expand All @@ -830,7 +830,7 @@
- [暗号化および圧縮機能](/functions-and-operators/encryption-and-compression-functions.md)
- [ロック機能](/functions-and-operators/locking-functions.md)
- [情報関数](/functions-and-operators/information-functions.md)
- [ベクトル関数と演算子](/ai/reference/vector-search-functions-and-operators.md)
- [ベクトル関数と演算子](https://docs.pingcap.com/ai/vector-search-functions-and-operators/)
- JSON関数
- [概要](/functions-and-operators/json-functions.md)
- [JSONを作成する関数](/functions-and-operators/json-functions/json-functions-create.md)
Expand All @@ -853,7 +853,7 @@
- [OracleとTiDBの関数と構文の比較](/oracle-functions-to-tidb.md)
- [クラスター化インデックス](/clustered-indexes.md)
- [グローバルインデックス](/global-indexes.md)
- [ベクトルインデックス](/ai/reference/vector-search-index.md)
- [ベクトルインデックス](https://docs.pingcap.com/ai/vector-search-index/)
- [制約](/constraints.md)
- [生成列](/generated-columns.md)
- [SQLモード](/sql-mode.md)
Expand Down
12 changes: 7 additions & 5 deletions ai/ti/guides/ti-git-workspace-for-agents-example.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,21 @@
---
title: TiDB Cloud Filesystem 上でエージェント向けの Git ワークスペースを準備する
summary: 大規模な Git ワークスペースをすばやく利用可能にし、クリーンオブジェクトをバックグラウンドで hydrate して、完全なダウンロードが終わる前にエージェントが作業を開始できるようにします。
summary: 大規模な Git リポジトリのダウンロードが完了する前にエージェントタスクを開始し、マシンを削除する前に作業を保持する方法を学びます。
---

# TiDB Cloud Filesystem 上でエージェント向けの Git ワークスペースを準備する

このワークフローでは、エージェントタスクの開始におけるクリティカルパスから、大規模リポジトリのクローンを取り除きます。完全なダウンロードが完了する前に、一時的なエージェントが大規模リポジトリを調査または変更する必要がある場合に使用します。
大規模なリポジトリのダウンロードが完了する前にエージェントタスクを開始します。一時的なマシン上のエージェントがすぐにファイルを調査または編集する必要がある場合は、バックグラウンド hydration を有効にした blobless Git ワークスペースを使用します。

> **Note:**
>
> TiDB Cloud CLI (`ti`) は現在パブリックプレビューです。機能およびコマンドラインインターフェースは、予告なく変更される場合があります。

## 仕組み {#how-it-works}

`ti fs-git clone-git-workspace --blobless --hydrate background` は、置き換え可能なエージェントランタイム間で共有できる Git ワークスペースを登録し、すべてのクリーン ブロブのダウンロードが完了する前にそのファイルツリーを公開します。このコマンドはすぐに戻るため、`ti` がバックグラウンドでクリーンツリーとローカル Git オブジェクトデータベースを hydrate している間に、エージェントはパスを調査して作業を開始できます。通常の clone とは異なり、初期オブジェクト転送はワークフロー全体をブロックしません。ネイティブの blobless partial clone のみを使う場合と異なり、バックグラウンド hydration により、エージェントのクリティカルパス上で繰り返し発生するオンデマンドフェッチを減らせます。hydration の完了前に到着した読み取りは、正確性を保つために引き続き Git の lazy fetch にフォールバックします。編集、commit、fetch、push は通常どおり Git が担当します。
`ti fs-git clone-git-workspace --blobless --hydrate background` は Git ワークスペースを登録し、すべてのクリーンブロブのダウンロードが完了する前にそのファイルツリーを公開します。`ti` が残りのクリーンなファイル内容をダウンロードしてローカル Git オブジェクトデータベースにデータを格納している間に、エージェントは作業を開始できます。hydration と呼ばれるこのバックグラウンドプロセスにより、繰り返し発生するオンデマンドフェッチが減ります。hydration が完了する前の読み取りでは、不足しているデータを取得するために Git の lazy fetch が使用されます。

置き換え後のエージェントランタイムは、登録済みのワークスペースにアクセスできます。元のマシンを破棄する前に、以下のクリーンアップガイダンスで説明されているように、ローカル Git 履歴を保持してください。ファイルの編集には通常のツールを使用し、commit、fetch、push には Git コマンドを使用します。

## 前提条件 {#prerequisites}

Expand Down Expand Up @@ -71,7 +73,7 @@ ti fs-git add-git-worktree \
git -C /path/to/workspace/tidb-agent-task status
```

worktree を削除する前に、必要な変更を commit または push してください。
worktree を削除する前に、必要な変更を commit してください。マシンを破棄する前に、push またはローカル Git メタデータの検証済みバックアップを使用して、[Git 履歴を保持して検証](/tidb-cloud-filesystem/manage-git-workspaces.md#preserve-work-before-leaving-a-machine)してください。

## クリーンアップ {#cleanup}

Expand All @@ -88,7 +90,7 @@ ti fs unmount-file-system --mount-path /path/to/workspace

- リポジトリ認証情報は `ti` ではなく Git によって管理されます。
- `coding-agent` マウントプロファイルは、パフォーマンスのために Git メタデータ、依存関係ディレクトリ、キャッシュ、ビルド出力、およびその他の生成ファイルをローカルマシン上に保持します。
- `coding-agent` プロファイルによってローカルに保持されるファイルは、一時的なマシンとともに消えます。必要な Git の変更は commit または push し、再構築できないその他のローカルファイルを保持するには、明示的な `--path` 値を指定して [`pack-file-system`](/ai/ti/reference/ti-fs-pack-file-system.md) を使用してください。
- `coding-agent` プロファイルによってローカルに保持されるファイルは、一時的なマシンとともに消えます。ローカル commit だけでは、マシン間で Git 履歴は保持されません。必要な commit は push して検証し、再構築できないその他のローカルファイルを保持するには、明示的な `--path` 値を指定して [`pack-file-system`](/ai/ti/reference/ti-fs-pack-file-system.md) を使用してください。

## 次のステップ {#what-s-next}

Expand Down
8 changes: 4 additions & 4 deletions ai/ti/reference/ti-fs-copy-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,13 +50,13 @@ ti fs copy-file

## オプション {#options}

- `--append`: ローカルファイルの内容を TiDB Cloud ファイルシステム内のファイルに追記します。
- `--create-parents`: TiDB Cloud ファイルシステムからコピーする際に、不足しているローカルの親ディレクトリを作成します。
- `--append`: ローカルファイルの内容をファイルシステム内のファイルに追記します。
- `--create-parents`: ファイルシステムからコピーする際に、不足しているローカルの親ディレクトリを作成します。
- `--description <string>`: `--to-remote` 操作のファイル説明です。
- `--dry-run`: 変更を適用せずにリクエストを検証します。
- `--file-system-id <string>`: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
- `--from-local <string>`: ローカルのソースパスです。
- `--from-remote <string>`: TiDB Cloud ファイルシステム内のソースパスです。
- `--from-remote <string>`: ファイルシステム内のソースパスです。
- `--from-stdin`: 標準入力から読み取り、`--to-remote` に書き込みます。
- `--fs-token <string>`: ファイルシステムトークンを設定します。省略した場合、コマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、選択したファイルシステム用にローカルに保存されているトークンを使用します。
- `--help`: ヘルプ情報を表示します。
Expand All @@ -66,7 +66,7 @@ ti fs copy-file
- `--resume`: 実行中のコピー操作を再開します。
- `--tag <string>`: `--to-remote` 操作用に `key=value` 形式のタグを作成します。複数回指定できます。
- `--to-local <string>`: ローカルの宛先パスです。
- `--to-remote <string>`: TiDB Cloud ファイルシステム内の宛先パスです。
- `--to-remote <string>`: ファイルシステム内の宛先パスです。
- `--to-stdout`: `--from-remote` を標準出力に書き込みます。
- `--version`: バージョン情報を表示します。

Expand Down
4 changes: 2 additions & 2 deletions ai/ti/reference/ti-fs-create-hardlink.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@ ti fs create-hardlink

## オプション {#options}

- `--link-path <string>`: TiDB Cloud ファイルシステム内で作成するハードリンクのファイルパスです。\[required]
- `--source-path <string>`: TiDB Cloud ファイルシステム内の既存のファイルパスです。\[required]
- `--link-path <string>`: ファイルシステム内で作成するハードリンクのファイルパスです。\[required]
- `--source-path <string>`: ファイルシステム内の既存のファイルパスです。\[required]
- `--dry-run`: 変更を適用せずにリクエストを検証します。
- `--file-system-id <string>`: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
- `--fs-token <string>`: ファイルシステムトークンを設定します。省略した場合、このコマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、このコマンドは選択したファイルシステム用にローカルに保存されているトークンを使用します。
Expand Down
2 changes: 1 addition & 1 deletion ai/ti/reference/ti-fs-create-layer.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ ti fs create-layer

## オプション {#options}

- `--base-root-path <string>`: TiDB Cloud ファイルシステム内のベースルートパスです。\[required]
- `--base-root-path <string>`: ファイルシステム内のベースルートパスです。\[required]
- `--actor-id <string>`: レイヤーの所有者を識別するアクター ID です(例: エージェント名)。
- `--dry-run`: 変更を適用せずにリクエストを検証します。
- `--durability-mode <string>`: レイヤーの耐久性モードを設定します。明示的にサポートされている値は `restore-safe` のみで、これを指定するとリモートレイヤー内の変更が保持され、ローカル環境の終了後もレイヤーを復元できます。省略した場合、サービスは `restore-safe` を使用します。
Expand Down
2 changes: 1 addition & 1 deletion ai/ti/reference/ti-fs-delete-file-system-token.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ ti fs delete-file-system-token

- `--file-system-id <string>`: トークンを所有するファイルシステムを指定します。TiDB Cloud API 認証情報を使用する場合は必須です。オーナートークンが ID を提供する場合は省略可能です。
- `--token-id <string>`: list コマンドが返す不変のトークン ID を指定します。このオプションは必須です。
- `--fs-token <string>`: ファイルシステムのオーナートークンを使用してリクエストを認可します。省略した場合、コマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、コマンドは選択したファイルシステム用にローカルに保存されたトークンを使用します。利用可能なファイルシステムトークンがない場合、コマンドは設定済みの TiDB Cloud API キーを使用します。
- `--fs-token <string>`: ファイルシステムのオーナートークンを使用してリクエストを認可します。省略した場合、コマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、コマンドは TiDB Cloud API 認証情報と `--file-system-id` を必要とします。ローカルに保存されたオーナートークンは自動的には使用されません。
- `--dry-run`: トークンを取り消さずに、認証情報、識別子、および既知のローカルマウント競合を検証します。
- `--help`: ヘルプ情報を表示します。
- `--version`: バージョン情報を表示します。
Expand Down
2 changes: 1 addition & 1 deletion ai/ti/reference/ti-fs-delete-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ ti fs delete-file

## オプション {#options}

- `--path <string>`: TiDB Cloud ファイルシステム内のファイルまたはディレクトリのパス。\[required]
- `--path <string>`: ファイルシステム内のファイルまたはディレクトリのパス。\[required]
- `--dry-run`: 変更を適用せずにリクエストを検証します。
- `--file-system-id <string>`: ファイルシステムを選択します。`TI_FS_FILE_SYSTEM_ID` を設定することもできます。
- `--fs-token <string>`: ファイルシステムトークンを設定します。省略した場合、このコマンドは `TI_FS_TOKEN` 環境変数を使用します。どちらも指定されていない場合、このコマンドは選択したファイルシステム用にローカルに保存されたトークンを使用します。
Expand Down
Loading
Loading