TiDB Xインスタンスのプロジェクト移行に関するFAQ
TiDB Xインスタンスは、 TiDB Xアーキテクチャ上に構築されたサービス指向のTiDB Cloud製品であり、 TiDB Cloud StarterとTiDB Cloud Essentialインスタンスが含まれます。
このFAQTiDB CloudコンソールTiDB Cloud StarterおよびEssentialインスタンスを TiDB X プロジェクトに移行するよう促す理由、移行プロセス中に発生する変更点、および必要なフォローアップアクションについて説明します。
TiDB Cloudコンソールで、TiDB Cloud StarterとEssentialインスタンスを移動するように促されるのはなぜですか?
2026年4月15日以前は、 TiDB Cloudは単一のTiDB専用プロジェクトタイプを使用してすべてのTiDB Cloudリソースを管理していました。このようなプロジェクトには、TiDB Cloud DedicatedクラスタとTiDB Xインスタンスが混在することができました。しかし、1つのプロジェクトに異なるリソースタイプを混在させると、次のような理由で管理が複雑化しました。
- TiDB専用プロジェクトは、元々 TiDB Cloud Dedicatedクラスター向けに設計されたものです。
- TiDB XインスタンスとTiDB Cloud Dedicatedクラスタは、動作と管理モデルが異なります。
2026年4月15日より、 TiDB Cloudは異なるリソースタイプを明確に区別するために、個別のプロジェクトタイプを導入します。各プロジェクトタイプは、それぞれ独自のリソースタイプをホストするようになります。
- TiDB専用プロジェクト: TiDB Cloud Dedicatedクラスター向け
- TiDB Xプロジェクト:TiDB Xインスタンス向け
- TiDB X仮想プロジェクト:どのTiDB Xプロジェクトにもグループ化されていないTiDB Xインスタンス用
TiDB Xプロジェクトは軽量で、TiDB Xインスタンスではオプションですが、 TiDB Cloud Dedicatedクラスタでは専用プロジェクトが必須です。これらのリソースを分離することで、より一貫性のあるユーザーエクスペリエンスが実現し、どのプロジェクト機能が適用されるかについての混乱が解消されます。
この分離の結果、専用プロジェクトにはTiDB Xインスタンスを含めることができなくなりました。組織が専用プロジェクトに既存のTiDB Cloud StarterまたはEssentialリソースを持っている場合、 TiDB Cloudは新しいリソースモデルに合わせてそれらをTiDB Xプロジェクトに移動するように促します。
TiDB Cloudではどのようなプロジェクトタイプが利用できますか?
TiDB Cloudは、異なるリソースタイプとユースケースに対応するため、3種類のプロジェクトタイプを提供しています。
TiDB専用プロジェクト:このプロジェクトタイプは、 TiDB Cloud Dedicatedクラスターでのみ使用されます。
- この機能を使うと、RBAC、ネットワーク、メンテナンス、アラート購読、暗号化アクセスなど、 TiDB Cloud Dedicatedクラスタの設定をプロジェクトごとに個別に管理できます。
- 各TiDB Cloud Dedicatedクラスターは、専用プロジェクトに属していなければなりません。
- TiDB Cloud Dedicatedクラスターは、インフラストラクチャの結合により、プロジェクト間で移動することはできません。
TiDB Xプロジェクト:このプロジェクトタイプは、TiDB Xインスタンスでのみ使用されます。
- これは、プロジェクトごとにTiDB XインスタンスのRBAC(ロールベースアクセス制御)を管理するのに役立ちます。
- TiDB Xプロジェクトは軽量でオプションなので、プロジェクトに割り当てずにTiDB Xインスタンスを作成することもできます。
- プロジェクトは、TiDB Xインスタンスを整理したりグループ化したりする場合に役立ちますが、必須ではありません。
- TiDB Xインスタンスは、TiDB Xプロジェクト間、または組織レベルに戻して移動できます。
TiDB X仮想プロジェクト:このプロジェクトは仮想プロジェクトであり、管理機能は提供していません。
- これは、どのプロジェクトにも属さないTiDB Xインスタンスの論理コンテナとして機能するため、プロジェクトIDを使用することで、 TiDB Cloud APIを介してこれらのインスタンスにアクセスできます。
- 各組織には固有の仮想プロジェクトIDが付与されています。
- この ID は、TiDB Cloud API のアクセス可能なプロジェクトをすべて一覧表示します。
以下の表は、これらのプロジェクトタイプ間の違いを示しています。
TiDB Cloud StarterおよびEssentialインスタンスを移行する必要はありますか?
それは、現在のプロジェクトの構造によって異なります。
- プロジェクトにTiDB Cloud StarterおよびEssentialインスタンスのみが含まれている場合、 TiDB Cloudは2026年4月15日に自動的にプロジェクトをTiDB Xプロジェクトに変換します。追加の操作は必要ありません。
- プロジェクトにTiDB Cloud DedicatedクラスターとTiDB Cloud StarterまたはEssentialインスタンスの両方が含まれている場合、 TiDB Cloudコンソールは、上部のバナーにある[移動とロック解除]をクリックして、 TiDB Cloud StarterおよびEssentialインスタンスを新しい TiDB X プロジェクトに移動するように促します。
誰が移行作業を実行できますか?
Organization Ownerロールを持つユーザーのみが移行を開始および完了できます。
プロジェクトにTiDB Cloud StarterとEssentialインスタンスのみが含まれている場合はどうなりますか?
TiDB Cloud StarterおよびEssentialインスタンスのみを含むプロジェクトは、2026年4月15日に自動的にTiDB Xプロジェクトに変換されます。
移行後に何が変わるのか:
- このプロジェクトはTiDB Xプロジェクトになります。
- 新しいTiDB Xプロジェクトには、ネットワーク設定、CMEK設定、メンテナンス構成などの専用のプロジェクト設定は含まれていません。
移行後も変わらないもの:
- 既存のインスタンスとそのデータ、可用性、およびパフォーマンス。
- お客様の請求額と利用状況。
- プロジェクト名とプロジェクトID。
プロジェクトにTiDB Cloud DedicatedクラスターとTiDB Cloud StarterまたはEssentialインスタンスの両方が含まれている場合、どうなりますか?
TiDB Cloudのリソースごとに異なるプロジェクトタイプが導入されたことにより、専用プロジェクトではTiDB Xインスタンスをホストできなくなりました。
プロジェクトにTiDB Cloud DedicatedクラスターとTiDB Cloud StarterまたはEssentialインスタンスの両方が含まれている場合、 TiDB Cloud は上部のバナーで、プロジェクト内のTiDB Cloud StarterおよびEssentialインスタンスを新しいTiDB X プロジェクトに移動するように促します。
注記:
TiDB Cloud Dedicatedクラスターは、移行後も元のプロジェクト内に残ります。したがって、この移行はTiDB Cloud Dedicatedクラスターに影響を与えません。
あなたがOrganization Ownerの場合は、上部のバナーにある[移動とロック解除]をクリックし、移行ウィザードに従って移行を完了してください。
移行ウィザードには、移行対象となるTiDB Cloud StarterおよびEssentialインスタンスのリストが表示され、新しい TiDB X プロジェクトの新しい名前を指定できます。
移行後に何が変わるのか:
- TiDB Cloud StarterおよびEssentialインスタンスは、新しく作成されたTiDB Xプロジェクトに移行されます。
- 移行後のインスタンスは、新しいプロジェクトIDに属します。
- プロジェクトレベルのRBAC権限は、新しいプロジェクトにコピーされます。
移行後も変わらないもの:
- インスタンスデータ。
- インスタンスの可用性。
- インスタンスのパフォーマンス。
- お客様の請求額と利用状況。
- インスタンスの基盤となるインフラストラクチャ。
- TiDB Cloud Dedicatedクラスターは、現在のプロジェクトに留まり、移動されることはありません。
この移行には追加費用はかかりません。
移行後、TiDB XインスタンスはTiDB Xプロジェクト(または組織レベル)を通じて管理でき、 TiDB Cloud Dedicatedクラスタは専用プロジェクトを通じて引き続き管理できます。
移行後にはどのような対応が必要ですか?
TiDB Cloud StarterまたはEssentialインスタンスを新しい TiDB X プロジェクトに移行した場合は、以下の項目など、元のプロジェクト ID または元のプロジェクト レベルの設定に依存するものを確認してください。
- 自動化またはスクリプト
- 統合
- プロジェクトベースの運用ワークフロー
- ユーザーアクセスとRBACの割り当て
- データサービスの設定
- データアプリ
- データサービスAPIキー
プロジェクトレベルのRBAC権限は新しいプロジェクトにコピーされますが、移行後もアクセス権限を確認し、ユーザーとワークフローが期待どおりに機能することを確認する必要があります。
TiDB Cloud API を使用してインスタンスを管理する場合は、 TiDB Cloud StarterおよびEssential向けプロジェクトAPI移行ガイドを参照して API 呼び出しを更新してください。
どこで助けを得られますか?
自動化、統合、またはデータサービスの設定が元のプロジェクトIDに依存しているかどうか不明な場合は、移行を開始する前に、 TiDB Cloudサポート( support@pingcap.comにお問い合わせください。