TiDB Cloudサーバーレスブランチの管理

このドキュメントでは、 TiDB Cloudコンソール使用してTiDB Cloud Serverless ブランチを管理する方法について説明します。TiDB TiDB Cloud CLI を使用して管理するには、 ticloud branch参照してください。

必要なアクセス

ブランチを作成するまたはブランチに接続する実行するには、組織のOrganization Ownerのロールまたは対象プロジェクトのProject Ownerのロールに所属している必要があります。
プロジェクト内のクラスターをブランチを表示作成するには、そのプロジェクトに属している必要があります。

権限の詳細については、ユーザーロール参照してください。

注記：
2023 年 7 月 5 日以降に作成されたTiDB Cloud Serverless クラスターに対してのみブランチを作成できます。その他の制限については制限と割り当て参照してください。

ブランチを作成するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲットのTiDB Cloud Serverless クラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで[ブランチ]をクリックします。
「ブランチ」ページの右上隅にある「ブランチの作成」をクリックします。ダイアログが表示されます。
または、既存の親ブランチからブランチを作成するには、対象の親ブランチの行を見つけて、 [アクション] 列で[...] > [ブランチの作成]をクリックします。
ブランチの作成ダイアログで、次のオプションを設定します。
- 名前: ブランチの名前を入力します。
- 親ブランチ: 元のクラスターまたは既存のブランチを選択します。2 main現在のクラスターを表します。
- 最大データを含める: 次のいずれかを選択します。
  - 現在の時点: 現在の状態からブランチを作成します。
  - 特定の日時: 指定された時間からブランチを作成します。
[作成]をクリックします。

クラスター内のデータサイズに応じて、ブランチの作成は数分で完了します。

クラスターのブランチを表示するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲットのTiDB Cloud Serverless クラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで[ブランチ]をクリックします。
クラスターのブランチリストが右側のペインに表示されます。

ブランチに接続するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲットのTiDB Cloud Serverless クラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで[ブランチ]をクリックします。
接続するターゲットブランチの行で、 [アクション] 列の[...]をクリックします。
ドロップダウンリストで[接続]をクリックします。接続情報のダイアログが表示されます。
ルートパスワードを作成またはリセットするには、 [パスワードの生成]または[パスワードのリセット]をクリックします。
接続情報を使用してブランチに接続します。

あるいは、クラスターの概要ページから接続文字列を取得することもできます。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲットのTiDB Cloud Serverless クラスターの名前をクリックして、その概要ページに移動します。
右上隅の「接続」をクリックします。
Branchドロップダウンリストから接続するブランチを選択します。
ルートパスワードを作成またはリセットするには、 [パスワードの生成]または[パスワードのリセット]をクリックします。
接続情報を使用してブランチに接続します。

ブランチを削除するには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲットのTiDB Cloud Serverless クラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで[ブランチ]をクリックします。
削除するターゲットブランチの行で、 [アクション] 列の[...]をクリックします。
ドロップダウンリストで「削除」をクリックします。
削除を確認します。

ブランチをリセットすると、その親の最新データと同期されます。

注記：
この操作は元に戻せません。ブランチをリセットする前に、重要なデータを必ずバックアップしてください。

ブランチをリセットするには、次の手順を実行します。

TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲットのTiDB Cloud Serverless クラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで[ブランチ]をクリックします。
リセットするターゲットブランチの行で、 [アクション] 列の[...]をクリックします。
ドロップダウンリストで「リセット」をクリックします。
リセットを確認します。