📣新登場！TiDB Cloud BYOC、TiDB Cloud Filesystem、PostgreSQL-compatible TiDB Cloud Starter がパブリックプレビュー中。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者
ベストプラクティス
API

TiDB Cloud Filesystem でファイルシステムを管理する

TiDB Cloud コンソール または TiDB Cloud CLI (ti) を使用して、TiDB Cloud Filesystem 内のファイルシステムを作成、確認、削除できます。コンソールではファイルシステム名の変更も可能で、CLI ではアクセス診断を利用できます。

コマンド構文、フラグ、出力フィールドについては、ti fs コマンドリファレンス を参照してください。

前提条件

  • TiDB Cloud コンソール を使用してファイルシステムを管理するには、コンソールにログインして組織を選択します。
  • TiDB Cloud CLI (ti) を使用してファイルシステムを管理するには、CLI でのクイックスタート に従って ti をインストールし、アクセスを設定します。

ファイルシステムを作成する

TiDB Cloud コンソールまたは TiDB Cloud CLI を使用してファイルシステムを作成できます。

    1. TiDB Cloud コンソール の左側のナビゲーションペインで組織を選択し、File Systems をクリックします。

    2. 右上隅で Create File System をクリックします。

    3. Create File System ページで、ファイルシステム名を入力し、Cloud Provider と Region を選択します。

    4. （任意）概要で使用量制限を確認し、編集します。

      使用量制限を編集するには、組織にクレジットカードを追加してください。クレジットカードがない場合、作成時に無料枠の制限は編集できません。詳細は 使用量制限を管理する を参照してください。

    5. Create をクリックします。Your File System is Ready! ダイアログには、TiDB Cloud CLI のインストールと、macOS または Linux でのファイルシステムのマウントに関する任意の手順が表示されます。マウントコマンド内のデフォルトのオーナートークンは一度だけ表示されるため、ダイアログを閉じる前に安全に保存してください。

    ファイルシステムを作成し、準備完了になるまで待機します。

    ti fs create-file-system \
  --display-name agent-workspace \
  --label environment=development \
  --wait

    出力から、file_system_id フィールドでファイルシステム ID を、fs_token フィールドでファイルシステムオーナートークンを取得できます。CLI はファイルシステムオーナートークンを自動的にローカルへ保存します。

    返された file_system_id をコピーし、現在のシェルで以降のコマンドの対象としてそのファイルシステムを選択します。

    export TI_FS_FILE_SYSTEM_ID="<file-system-id>"

    TI_FS_FILE_SYSTEM_ID を設定すると、以降のコマンドでは毎回 --file-system-id を指定しなくても対象のファイルシステムを識別できます。データアクセス用コマンドでは、CLI は選択されたファイルシステムに対してローカルに保存されたファイルシステムトークンを使用します。

    ファイルシステムを一覧表示して確認する

    TiDB Cloud コンソールまたは TiDB Cloud CLI を使用して、ファイルシステムを一覧表示し、その詳細を確認できます。

      1. TiDB Cloud コンソール の左側のナビゲーションペインで組織を選択し、File Systems をクリックします。
      2. File Systems ページで、クラウドプロバイダーとリージョンを選択して、その場所にあるファイルシステムを一覧表示します。Search Name または Status を使用して一覧を絞り込めます。

      ファイルシステムの詳細を表示するには、ファイルシステム名をクリックして概要ページに移動します。

      表示名を変更するには、概要ページの右上隅にある ... をクリックし、Rename を選択します。

      現在のリージョンで利用可能なファイルシステムを一覧表示します。

      ti fs list-file-systems --output text

      ファイルシステムのメタデータを表示します。

      ti fs describe-file-system --file-system-id "<file-system-id>"

      複数のファイルシステムを扱う場合は、次のいずれかの方法で対象のファイルシステムを指定します。

      • 個別のコマンドに --file-system-id "<file-system-id>" を渡します。
      • TI_FS_FILE_SYSTEM_ID を設定して、現在のシェルで以降のコマンドの対象ファイルシステムを選択します。

      CLI は、ファイルシステム数やローカルに保存された認証情報に基づいてファイルシステムを自動選択しません。

      現在の CLI には、作成後にファイルシステムの表示名やラベルを変更するコマンドはありません。これらの値はファイルシステム作成時に選択してください。

      アクセスを確認する

      CLI がファイルシステムにアクセスできるかどうかを確認します。

      ti fs check-file-system --file-system-id "<file-system-id>"

      結果には、全体の status と、ローカル認証情報、エンドポイント選択、バンドルされたファイルシステムランタイム、リモート接続性のチェック結果が含まれます。

      • passed は、すべてのチェックが成功したことを意味します。
      • warning または failed は、注意が必要なチェックを示します。

      一般的なアクセスおよび接続性の問題については、TiDB Cloud Filesystem のトラブルシューティング を参照してください。

      ファイルシステムを削除する

      TiDB Cloud コンソールまたは TiDB Cloud CLI を使用してファイルシステムを削除できます。

        1. TiDB Cloud コンソールで、組織の File Systems ページを開き、対象ファイルシステムの Cloud Provider と Region を選択します。
        2. 対象ファイルシステムの行で ... をクリックし、Delete を選択します。
        3. 確認ダイアログで、要求されたリージョンとファイルシステム名を region/name 形式で入力し、I understand, delete it. をクリックします。

        削除は非同期です。リクエスト送信後、削除が完了するまでファイルシステムは deleting ステータスで表示されたままになる場合があります。

        ID を指定してファイルシステムを削除します。

        ti fs delete-file-system --file-system-id "<file-system-id>"

        ファイルシステムの削除は非同期です。サービスがリクエストを受け付けると、CLI はファイルシステムのステータスを deleting として報告し、一致するローカル保存済み認証情報を削除します。このステータスは削除が開始されたことを意味し、リモートファイルシステムとそのデータがすでに削除されたことを意味するものではありません。

        次のステップ

        このページは役に立ちましたか？