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

CLI を使用して TiDB Cloud Filesystem を使い始める

TiDB Cloud Filesystem は、アプリケーション、自動化、AI エージェント向けの永続的で共有可能なクラウドファイルシステムです。ファイルは、それを作成したマシンやプロセスとは独立して利用可能な状態が維持されるため、セッションや環境をまたいでワークスペースを再利用できます。

このクイックスタートガイドでは、TiDB Cloud CLI を使用してファイルシステムを作成し、ファイルを書き込み・読み取りし、必要に応じてローカルディレクトリとしてマウントする方法を説明します。

前提条件

開始する前に、TiDB Cloud コンソール の TiDB Cloud API Keys ページから TiDB Cloud API の公開キーと秘密キーを取得してください。これらのキーには、組織に対する Organization Owner アクセス権が必要です。

すでに誰かからファイルシステムトークンを受け取っている場合は、リソースの作成をスキップして、既存のファイルシステムにアクセスする に従ってください。

macOS および Linux では Bash または Zsh を、Windows では PowerShell を使用してください。チュートリアル全体を通して同じシェルを開いたままにしてください。エージェントがコマンドごとに新しいシェルを開始する場合は、環境変数と保存したパスの値を各シェルに渡してください。

ステップ 1. TiDB Cloud CLI をインストールする

使用するオペレーティングシステムを選択してください。

    1. TiDB Cloud CLI をインストールします。

      curl -fsSL https://github.com/tidbcloud/ti-cli/releases/latest/download/install.sh | sh -s -- --yes

    2. ti をシェルで使えるようにし、バージョンを確認します。

      export PATH="$HOME/.ti/bin:$PATH"

ti --version

    3. 新しいターミナルでも ti を使えるようにするには、シェルプロファイルに追加します。Zsh の場合は次のとおりです。

      echo 'export PATH="$HOME/.ti/bin:$PATH"' >> ~/.zshrc

      Bash の場合は、同じ export 行をターミナルが使用する起動ファイルに追加してください。一般的には Linux では ~/.bashrc、macOS では ~/.bash_profile です。

    1. TiDB Cloud CLI をインストールします。

      $script = "$env:TEMP\install-ti.ps1"
iwr https://github.com/tidbcloud/ti-cli/releases/latest/download/install.ps1 -OutFile $script
powershell -ExecutionPolicy Bypass -File $script -Yes

    2. ti を現在の PowerShell セッションで使えるようにし、バージョンを確認します。

      $env:Path = "$HOME\.ti\bin;$env:Path"

ti --version

    Windows での永続的な PATH 設定やその他のインストール方法については、TiDB Cloud CLI のインストール、設定、および更新 を参照してください。

    ステップ 2. TiDB Cloud CLI を設定する

    ファイルの保存先として使用するサポートされるリージョンを選択します。たとえば aws-us-west-2 です。無料利用枠では、1 リージョンあたり 1 つのファイルシステムを作成できます。組織ですでに 1 つ作成済みの場合は、それを再利用するか、別のリージョンを選択するか、支払い方法を追加してください。

    1. 対話形式の設定を実行します。

      ti configure

    2. 次の情報を入力します。

      • 選択したリージョン
      • TiDB Cloud API の公開キーと秘密キー

    CLI は認証情報とデフォルトリージョンをローカルに保存します。次のステップの作成コマンドでは、このリージョンが使用されます。

    ステップ 3. ファイルシステムを作成して使用する

    1. ファイルシステムを作成します。

      ti fs create-file-system --display-name agent-workspace --wait

      次のステップで使用するため、返された file_system_id をコピーしてください。CLI はファイルシステムのオーナートークンとリージョンをローカルに保存するため、同じマシンでは再度トークンを入力する必要はありません。

    2. 新しいファイルシステムを選択します。<file-system-id> を返された file_system_id に置き換えてください。

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

        $env:TI_FS_FILE_SYSTEM_ID = "<file-system-id>"

      • ディレクトリを作成し、サンプルファイルをアップロードして、読み戻します。

          ti fs create-directory --path /quick-start
printf 'Hello from TiDB Cloud Filesystem\n' | ti fs copy-file \
  --from-stdin --to-remote /quick-start/hello.txt
ti fs read-file --path /quick-start/hello.txt

          ti fs create-directory --path /quick-start
"Hello from TiDB Cloud Filesystem" | ti fs copy-file `
  --from-stdin --to-remote /quick-start/hello.txt
ti fs read-file --path /quick-start/hello.txt

          read-file の想定出力は次のとおりです。

          Hello from TiDB Cloud Filesystem

          これで、最初のファイルが TiDB Cloud Filesystem に保存されました。別の環境からアクセスするには、既存のファイルシステムにアクセスする を参照してください。別のユーザー、アプリケーション、またはエージェントにアクセス権を付与するには、ファイルシステムを共有する を参照してください。

        ステップ 4. ファイルシステムをマウントする（オプション）

        アプリケーションでローカルファイルパスが必要な場合は、ファイルシステムをマウントします。Windows ではマウントはサポートされていません。Windows を使用している場合、または CLI アクセスのみが必要な場合は、ステップ 5 に進んでください。

        1. マウント用の空のローカルディレクトリを作成します。

          mount_dir="$(mktemp -d "$HOME/ti-fs-quick-start.XXXXXX")"

        2. 使用しているオペレーティングシステムに応じたコマンドで /quick-start ディレクトリをマウントします。

            このコマンドは、macOS に組み込まれている WebDAV サポートを使用します。

            ti fs mount-file-system --remote-path /quick-start \
  --mount-path "$mount_dir" --driver webdav

            Linux では fuse3 パッケージと /dev/fuse へのアクセスが必要です。必要に応じて、マウントコマンドを実行する前に FUSE ユーザースペースツールをインストールする を参照してください。

            ti fs mount-file-system --remote-path /quick-start \
  --mount-path "$mount_dir" --driver fuse

          • ローカルパスを使ってファイルを読み取ります。

            cat "$mount_dir/hello.txt"

            期待される出力:

            Hello from TiDB Cloud Filesystem

          書き込みの検証とトラブルシューティングについては、使用前にマウントを検証する を参照してください。

          ステップ 5. サンプルをクリーンアップする（オプション）

          ステップ 4 でディレクトリをマウントした場合は、それを使用しているアプリケーションを閉じてから、アンマウントし、空のローカルマウントディレクトリを削除します。

          ti fs unmount-file-system --mount-path "$mount_dir"
rmdir "$mount_dir"

          アンマウントに失敗した場合は、続行する前に 安全に終了する を参照してください。

          サンプルディレクトリとそのファイルを削除します。このコマンドは、サポートされているすべてのオペレーティングシステムで動作します。

          ti fs delete-file --path /quick-start --recursive

          ファイルシステムとそのトークンは、再利用できる状態のまま残ります。ファイルシステム全体を削除するには、ファイルシステムを削除する を参照してください。

          次のステップ

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