📣
TiDB Cloud Premium はパブリックプレビュー中です。エンタープライズワークロード向けの無制限のスケーリング、即時の弾力性、高度なセキュリティを提供します。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者
ベストプラクティス
API

TiDB Cloud Filesystem CLI コマンドリファレンス

ti fs を使用して TiDB Cloud Filesystem リソースをプロビジョニングし、コマンドまたはローカルマウントからそのデータにアクセスできます。

コマンド構文では、角括弧（[]）は省略可能な項目を囲みます。丸括弧は必須の選択肢をグループ化し、縦棒（|）は代替候補を区切ります。たとえば、(--ttl <duration> | --no-expiration) は、2 つのオプションのうちちょうど 1 つを指定する必要があることを意味します。

リソースとトークンのコマンド

コマンド説明
create-file-systemFilesystem とその初期オーナートークンを作成します。
list-file-systems有効なリージョン内の Filesystem を一覧表示します。
describe-file-systemID で 1 つの Filesystem の詳細を表示します。
check-file-systemFilesystem の選択、ルーティング、認証情報、およびデータプレーンアクセスを確認します。
delete-file-systemFilesystem を完全に削除します。
import-file-system-token既存の Filesystem トークンをローカルにインポートして選択します。
generate-file-system-token追加のオーナートークンを生成します。
generate-file-system-scoped-tokenパス、操作、および有効期間で制限されたトークンを生成します。
list-file-system-tokensシークレットを含まないトークンメタデータを一覧表示します。
enable-file-system-token無効化されたトークンを再度有効にします。
disable-file-system-tokenトークンを一時的に無効にします。
delete-file-system-tokenトークンを完全に失効させます。
refresh-file-system-tokenトークンをローテーションし、その置き換えトークンを 1 回だけ返します。

トークン管理の認可

オーナートークンがトークン管理を認可している場合、そのトークンはトークンの一覧表示、スコープ付きトークンの作成、およびオーナートークンまたはスコープ付きトークンの失効を実行できます。有効化または無効化できるのはスコープ付きトークンのみです。TiDB Cloud API 認証情報は、どちらの種類のトークンでも有効化、無効化、または失効できます。

AI プロバイダー設定コマンド

これらのコマンドは、メディアファイルからコンテンツを抽出し、埋め込みを生成するためのオプションのプロバイダーを設定します。通常の Filesystem リソース操作およびファイル操作では、AI プロバイダー設定は不要です。

コマンド説明
describe-file-system-extract-configurationメディア抽出プロバイダーの設定を表示します。
update-file-system-extract-configurationメディアコンテンツの抽出に使用するプロバイダーを更新します。
describe-file-system-embedding-configuration埋め込みプロバイダーの設定を表示します。
update-file-system-embedding-configuration埋め込みの生成に使用するプロバイダーを更新します。

データおよび名前空間のコマンド

コマンド説明
copy-fileローカルストレージと Filesystem の間、または Filesystem 内でファイルをコピーします。
read-fileリモートファイルまたはバイト範囲を読み取ります。
list-filesリモートパス配下のエントリを一覧表示します。
describe-fileリモートファイルまたはディレクトリの詳細を表示します。
move-fileリモートパスを移動または名前変更します。
delete-fileリモートファイルまたはディレクトリを削除します。
create-directoryリモートディレクトリを作成します。
chmod-filePOSIX スタイルのモードメタデータを変更します。
create-symlinkシンボリックリンクを作成します。
create-hardlinkハードリンクを作成します。
search-file-content抽出されたファイルコンテンツと説明を検索します。
find-files名前、タグ、日付、サイズ、またはタイプでファイルを検索します。

レイヤーとポータビリティのコマンド

コマンド説明
create-layer分離された書き込み可能なレイヤーを作成します。
list-layersFilesystem 内のレイヤーを一覧表示します。
fork-layer親の tip またはチェックポイントから子レイヤーをフォークします。
list-layer-chainレイヤーの固定された祖先チェーンを一覧表示します。
describe-layerID でレイヤーの詳細を表示します。
diff-layerレイヤーに記録された変更を一覧表示します。
create-layer-checkpointレイヤー内に永続的なチェックポイントを作成します。
delete-layerレイヤーを論理的に破棄します。
rollback-layer変更をコミットせずにレイヤーをロールバックします。
commit-layerレイヤーの変更をベース Filesystem に適用します。
pack-file-system選択したローカルオーバーレイ状態を Filesystem にアーカイブします。
unpack-file-systemアーカイブからローカルオーバーレイ状態を復元します。

レイヤー参照

レイヤー参照には、レイヤー ID、一意のレイヤー名、または tag:<key>=<value> 形式のタグ参照を使用できます。たとえば tag:run=123 です。名前とタグ参照は曖昧になる可能性があるため、自動化ではレイヤー ID を使用してください。

マウントプロファイルとローカルオーバーレイ

ローカルオーバーレイには、マウントプロファイルがリモート名前空間ではなくローカルマシン上に保持するファイルが保存されます。マウントプロファイルは、どのパスでそのオーバーレイを使用するかを定義します。

マウントプロファイル動作
coding-agentバージョン管理メタデータ、依存関係ディレクトリ、キャッシュ、ビルド出力、および一般的な一時パスをローカルオーバーレイに保持します。自動パックパスは選択しません。
portablecoding-agent と同じローカルパスルールを使用し、デフォルトで完全なオーバーレイをパックまたは unpack するため、マシン間やサンドボックスセッション間で移動できます。
noneローカルオーバーレイのパスルーティングと、自動パックまたは unpack の動作を無効にします。

マウントコマンド

コマンド説明
mount-file-systemローカルパスに Filesystem をマウントします。
drain-file-system稼働中の FUSE マウントから保留中の書き込みをフラッシュします。
unmount-file-systemFilesystem をフラッシュしてアンマウントします。

コマンドエイリアス

以下の ti fs コマンドには Unix スタイルのエイリアスがあります。たとえば、ti fs cp は ti fs copy-file と同等です。表に記載されていないコマンド（pack-file-system や unpack-file-system を含む）にはエイリアスがありません。

エイリアス正規コマンド
cpcopy-file
catread-file
lslist-files
statdescribe-file
mvmove-file
rmdelete-file
mkdircreate-directory
chmodchmod-file
symlinkcreate-symlink
hardlinkcreate-hardlink
grepsearch-file-content
findfind-files
mountmount-file-system
draindrain-file-system
umountunmount-file-system

エイリアスは、正規コマンドと同じオプション、認証、出力、クエリ、およびエラー動作を使用します。

関連情報

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