バックアップファイルからのリストア
Zilliz Cloud のリストア機能を使用すると、誤ってデータを失った場合やデータが破損した場合、システム障害が発生した場合などに、バックアップファイルからデータを復旧できます。これにより、ビジネスの継続性を確保できます。この機能は、インシデントからの確実な復旧、意図しない変更の取り消し、または最小限の中断でテスト用にクラスターをクローンするための信頼性の高い方法です。
このガイドでは、バックアップファイルからクラスター全体または一部をリストアする方法について説明します。
この機能はDedicatedクラスターでのみ利用可能です。
制限
- アクセス制御: プロジェクト管理者、組織オーナー、またはバックアップ権限を持つカスタムロールが必要です。
クラスター全体のリストア
すべてのデータベースとコレクションを含むクラスター全体を新しいクラスターにリストアできます。これは、テスト環境のクローン作成や復旧に役立ちます。クラスター全体をリストアするには、バックアップファイルがクラスターバックアップである必要があります。
リストア中には、RBAC 設定を含めるかどうかを選択できます。
RBAC のリストアは現在、ウェブコンソール経由でのみサポートされています。RESTful API ではまだサポートされていません。
リストア後、db_admin ユーザーのパスワードが新たに生成されます。このパスワードを使用してリストアされたクラスターに接続してください。
ウェブコンソール経由
以下のデモは、Zilliz Cloud ウェブコンソール上でクラスター全体をリストアする方法を示しています。
RESTful API経由
以下の例では、既存のバックアップファイルから Dedicated-01-backup という名前の新しいクラスターにクラスター全体をリストアします。RESTful API の詳細については、「Restore Cluster Backup」を参照してください。
export API_KEY="YOUR_API_KEY"
export BASE_URL="https://api.cloud.zilliz.com"
export CLUSTER_ID="your-cluster-id"
curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}/restoreCluster" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Accept: application/json" \
--header "Content-type: application/json" \
--data-raw '{
"targetProjectId": "proj-20e13e974c7d659a83xxxx",
"clusterName": "Dedicated-01-backup",
"cuSize": 1,
"collectionStatus": "KEEP"
}'
以下は出力例です。リストアジョブが生成され、プロジェクトジョブセンターで進行状況を確認できます。
{
"code": 0,
"data": {
"clusterId": "inxx-xxxxxxxxxxxxxxx",
"username": "db_admin",
"password": "xxxxxxxxx",
"jobId": "job-xxxxxxxxxxxxxx"
}
}
部分的なクラスターのリストア
特定のデータベースとコレクションのみを既存のクラスターにリストアすることもできます。
ウェブコンソール経由
以下のデモでは、Zilliz Cloudウェブコンソール上でクラスター内の特定のデータベースとコレクションをリストアする方法を示しています。
RESTful API経由
以下の例では、バックアップファイルからコレクションを既存のクラスター in01-3e5ad8adc38xxxx にリストアします。RESTful APIの詳細については、Restore Collection Backup を参照してください。
curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}/restoreCollection" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Content-Type: application/json" \
-d '{
"destClusterId": "in01-xxxxxxxxxxxxxx",
"dbCollections": [
{
"collections": [
{
"collectionName": "medium_articles",
"destCollectionName": "restore_medium_articles",
"destCollectionStatus": "LOADED"
}
]
}
]
}'
以下は出力例です。リストアジョブが生成され、プロジェクトジョブセンターで進行状況を確認できます。
{
"code": 0,
"data": {
"jobId": "job-04bf9335838dzkeydpxxxx"
}
}
暗号化されたバックアップファイルからの復元
暗号化されたバックアップを新しいクラスターに復元する場合、Zilliz Cloud はバックアップファイルに関連付けられた KMS キーを使用してデータを復号してから復元を行います。したがって、バックアップを暗号化ありまたはなしで新しいクラスターに復元できます。
この機能は、ビジネスクリティカル プロジェクト内の Dedicated クラスターでのみ利用可能です。
暗号化されたバックアップからの復元手順は、CMEK を使用した保存時の暗号化を有効にするかどうかを除き、通常の復元とほぼ同じです。
-
このオプションを有効にした場合、復元後に作成されるクラスターは、以下で指定された KMS キーを使用して暗号化されます。
-
このオプションを無効にした場合、復元後に作成されるクラスターは暗号化されません。
FAQ
復元されたクラスターはどの Milvus バージョンで実行されますか？
復元されたクラスターは、バックアップが作成された際のバージョンに関係なく、復元時点で Zilliz Cloud がサポートする最新の Milvus バージョンで実行されます。例えば、Milvus 2.5.x クラスターのバックアップを作成し、プラットフォームが 2.6.x にアップグレードされた後に復元した場合、復元されたクラスターは Milvus 2.6.x で実行されます。バックアップファイルにはデータのみが含まれており、クラスターのバージョンはプラットフォームによって決定されます。