TiDB Cloud Filesystem
TiDB Cloud Filesystem は、アプリケーション、自動化、AI エージェント向けの永続的で共有可能なクラウドファイルシステムです。ファイルは、それを作成したマシンやプロセスとは独立して利用可能な状態が維持されるため、同じワークスペースをセッションや環境をまたいで再利用できます。
TiDB Cloud Filesystem は、プロセスやサンドボックスの終了後もファイルを利用可能な状態に保つ必要がある場合、ワークフローが複数のマシンや一時的な環境にまたがる場合、または複数のユーザーやワークロードが同じファイルに対して制御されたアクセスを必要とする場合に使用します。
たとえば、ファイルシステムは次のようなタスクに使用できます。
- 異なるマシンや環境から同じファイルにアクセスして変更する。
- ユーザー、アプリケーション、CI ジョブ、または AI エージェントとファイルや結果を共有する。
- ローカルファイルパスを必要とするツール向けに、ファイルシステムをローカルディレクトリとしてマウントする。
- 共有ファイルに適用する前に、レイヤー内でファイル変更を分離する。
TiDB Cloud Filesystem の仕組み
TiDB Cloud Filesystem は、それにアクセスするマシンやプロセスとは独立して TiDB Cloud 内に永続化されます。そのため、認可された異なる環境が、マシン間でファイルをコピーすることなく同じファイルにアクセスできます。
ファイルシステムを作成および管理するには、TiDB Cloud コンソール または TiDB Cloud CLI (ti) を使用できます。TiDB Cloud Filesystem を使用するために、TiDB データベースをプロビジョニングまたは管理する必要はありません。
コンソールでは、ファイルやディレクトリを参照したり、ファイルサイズや更新時刻などのメタデータを確認したりすることもできます。
ファイルの内容を読み取ったり、ファイルやディレクトリを変更したりするには、次のいずれかの方法を使用します。
ti fsコマンドを使用する: ファイルシステムをマウントせずに、コマンドラインから直接ファイルをアップロード、ダウンロード、読み取り、整理、検索できます。- ファイルシステムをローカルディレクトリとしてマウントする: アプリケーションやツールが通常のローカルファイルパスを通じてファイルシステムデータにアクセスできるようにします。
詳細は、ファイルとディレクトリを操作する および ファイルシステムをマウントする を参照してください。
環境間でファイルを共有する
複数のマシンまたは環境が、同時に 1 つのファイルシステムへアクセスできます。各環境は独自のファイルシステムトークンを使用できるため、環境間で認証情報を共有する必要はありません。
たとえば、次のような使い方ができます。
- CI ジョブがビルド出力をファイルシステムに書き込み、別の環境が後でそれを読み取る。
- AI エージェントが、以前のセッションで作成されたファイルに対する作業を継続する。
- レビュアーが特定のディレクトリに対する読み取り専用アクセスを受け取る。
TiDB Cloud Filesystem はオーナートークンとスコープ付きトークンを提供しており、各ユーザーまたはワークロードがアクセスできるファイルや実行できる操作を制御できます。
詳細は、TiDB Cloud Filesystem の認可 および ファイルシステムを共有する を参照してください。
変更を分離して管理する
複数のタスクが共有ベースを変更せずに同じファイルをもとに作業できるようにするために、ファイルシステムのレイヤーを作成できます。
各レイヤーは、変更を独立して行える分離されたビューを提供します。レイヤーのチェックポイントを作成し、後で選択した変更をベースファイルシステムにコミットできます。
詳細は、レイヤーとチェックポイント を参照してください。
使い始める
実行したい内容に応じて、該当する手順を選択してください。
- 新しいファイルシステムを作成する: コンソールでのクイックスタート または CLI でのクイックスタート に従ってください。
- 他のユーザーから共有されたファイルシステムを使用する: 既存のファイルシステムにアクセスする を参照してください。
- サポートされているリージョン、プラットフォーム、および現在の制限事項を確認する: リージョンと制限事項 を参照してください。
- クライアント SDK をアプリケーションに統合する: TiDB Cloud Filesystem SDKs を参照してください。