TiDB Cloud Filesystem をコンソールから使い始める
TiDB Cloud Filesystem は、アプリケーション、自動化、AI エージェント向けの永続的で共有可能なクラウドファイルシステムです。ファイルは、それを作成したマシンやプロセスに依存せず利用可能な状態が維持されるため、セッションや環境をまたいでワークスペースを再利用できます。
このクイックスタートでは、TiDB Cloud コンソール を使用してファイルシステムを作成し、macOS または Linux コンピュータにマウントし、テストファイルを書き込み、コンソールでそのメタデータを確認する方法を説明します。
ステップ 1. ファイルシステムを作成する
TiDB Cloud アカウントを持っていない場合は、サインアップしてください。
TiDB Cloud アカウントで TiDB Cloud コンソール にログインします。
左側のナビゲーションペインで組織を選択し、File Systems をクリックします。
右上隅で Create File System をクリックします。
Create File System ページで、ファイルシステム名を入力し、クラウドプロバイダーとリージョンを選択します。概要に表示される使用量制限を確認します。
Create をクリックします。Your File System is Ready! ダイアログが表示されたら、次の手順のためにそのダイアログを開いたままにしておきます。
ステップ 2. ファイルシステムをマウントする
macOS または Linux では、Your File System is Ready! ダイアログの手順に従って TiDB Cloud CLI をインストールし、ファイルシステムをマウントします。Windows では、マウントせずにファイルを操作するには CLI でのクイックスタート に従ってください。
TiDB Cloud CLI
tiをインストールします。curl -fsSL https://github.com/tidbcloud/ti-cli/releases/latest/download/install.sh | sh同じシェルで Mount Your File System の下にあるコマンドをコピーして実行します。このコマンドは、
tiをPATHに追加し、TI_FS_TOKENを設定し、~/tidbcloudfsディレクトリを作成して、そのディレクトリにファイルシステムをマウントします。Start Using It の下にあるコマンドをコピーして実行し、マウントされたディレクトリを一覧表示します。
Done をクリックして、ファイルシステムの概要を開きます。
概要ページで Connect をクリックすると接続ガイダンスを再度開けますが、デフォルトのオーナートークンを後から取得できません。
ステップ 3. ファイルを書き込み、表示する
ファイルシステムをマウントした後、マウントされたディレクトリを使用してテストファイルの書き込みと読み取りを行います。
マウントされたディレクトリにファイルを書き込みます。
echo 'Hello from TiDB Cloud Filesystem' > ~/tidbcloudfs/hello.txt
cat ~/tidbcloudfs/hello.txt
ファイルシステムの左側ナビゲーションペインで Files をクリックします。ルートディレクトリに hello.txt が表示されます。ファイルを検索するか、ファイル名をクリックしてそのメタデータを確認できます。コンソールにはファイル情報が表示されますが、ファイル内容の読み取りやファイルの変更には TiDB Cloud CLI ti またはマウントが必要です。
(オプション)ステップ 4. ファイルシステムをアンマウントする
マウントされたディレクトリからファイルシステムにアクセスする必要がない場合は、アンマウントできます。
ti fs unmount-file-system --mount-path ~/tidbcloudfs
Linux では、FUSE が正常にアンマウントされるまで書き込みをローカルにバッファすることがあります。アンマウントに失敗した場合は、マシンを離れたりローカルキャッシュを削除したりする前に 安全に終了する に従ってください。
次のステップ
- ファイルシステムを管理する: ファイルシステムの確認、名前変更、削除を行います。
- ファイルシステムトークンの管理: 制限付きアクセスのトークンを作成します。
- CLI でのクイックスタート: CLI のみで作成するワークフローを確認します。