TiDB Cloud Filesystem SDKs

TiDB Cloud Filesystem は、ファイルシステム操作を実行するために Drive9 ワークスペースエンジンを使用します。TiDB Cloud Filesystem は、TiDB Cloud 上で提供される PingCAP 公式のホスト型 Drive9 サービスです。Drive9 は PingCAP が所有するオープンソースのコミュニティベースプロジェクトであり、TiDB Cloud Filesystem はそのマネージドクラウドサービスです。API レイヤーおよび SDK レイヤーでは、TiDB Cloud Filesystem サービスによって公開される drive9 エンドポイントを直接呼び出します。

Drive9 は、mem9-ai/drive9 リポジトリ で管理されているオープンソースプロジェクト（Apache 2.0）です。ワークスペースエンジンに加えて、このリポジトリでは複数のプログラミング言語向けクライアント SDK も公開しています。SDK とそのドキュメントもこのリポジトリで管理されているため、このページに記載されているガイドが、SDK のインストール、設定、および API の詳細に関する信頼できる情報源です。

SDK ガイドでは、サーバー URL と API キーの指定方法を含め、クライアントが Drive9 サーバーに接続する方法を説明しています。

次の表は、使用する TiDB Cloud Filesystem 認証情報を示しています。SDK ガイドで API キーの入力を求められた場合は、ファイルシステムトークンを使用してください。

各 TiDB Cloud Filesystem リージョンでは、次のサーバー URL を使用します。

SDK のサーバー URL は、必ずファイルシステムが配置されているリージョンのエンドポイントに設定してください。サーバー URL を設定しない場合、多くの SDK は https://api.drive9.ai にフォールバックしますが、これは TiDB Cloud Filesystem のエンドポイントではなく、TiDB Cloud Filesystem トークンを受け付けません。ファイルシステムトークンは、自身のリージョンのエンドポイントでのみ使用できます。

利用可能な SDK

SDK は Drive9 プロジェクトとともに開発およびリリースされるため、TiDB Cloud Filesystem サービスより先行する場合があります。TiDB Cloud Filesystem のワークロードで SDK を採用する前に、現在のサーバーエンドポイント、認証情報、およびサポートされている操作について、そのドキュメントを確認してください。

次のステップ

• CLI のインストール、設定、更新については、TiDB Cloud CLI (ti) を参照してください。
• コマンドラインからファイルシステムデータを管理するには、ファイルとディレクトリの操作 を参照してください。
• 自動化ワークフローでファイルシステムを使用するには、自動化と AI エージェントのワークフロー を参照してください。