メインコンテンツまでスキップ
バージョン: User Guides (Cloud)

バックアップファイルからの復元

Zilliz Cloudの復元機能を使用すると、偶発的なデータ損失、破損、またはシステム障害が発生した場合に、バックアップファイルからデータを回復でき、ビジネスの継続性を確保できます。これは、インシデントからの回復、意図しない変更の元に戻し、または最小限の中断でテスト用のクラスターをクローンするための信頼できる方法です。

このガイドでは、バックアップファイルからクラスター全体または一部を復元する方法を説明します。

📘Notes

この機能は、Dedicatedクラスターでのみ利用可能です。

制限事項

  • アクセス制御: プロジェクト管理者、組織オーナー、またはバックアップ権限を持つカスタムロールである必要があります。

クラスター全体を復元する

すべてのデータベースとコレクションを含むクラスター全体を新しいクラスターに復元できます。これは、テストやリカバリのために環境をクローンするのに役立ちます。クラスター全体を復元するには、バックアップファイルがクラスターバックアップである必要があります。

復元中に、RBAC設定を含めるかどうかを選択できます。

📘Notes

RBACの復元は現在、ウェブコンソール経由でのみサポートされており、RESTful APIではまだサポートされていません。

復元後、db_adminユーザーの新しいパスワードが生成されます。このパスワードを使用して、復元されたクラスターに接続します。

ウェブコンソール経由

以下のデモは、Zilliz Cloudウェブコンソールでクラスター全体を復元する方法を示しています。

RESTful API経由

以下の例は、既存のバックアップファイルからDedicated-01-backupという名前の新しいクラスターにクラスター全体を復元します。RESTful APIの詳細については、Restore Cluster Backupを参照してください。

curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}/restoreCluster" \
--header "Authorization: Bearer ${TOKEN}" \
--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 ${TOKEN}" \
--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キーを使用して、復元前にデータを復号します。したがって、暗号化の有無にかかわらず、バックアップを新しいクラスターに復元できます。

📘Notes

この機能は、ビジネスクリティカルプロジェクトのDedicatedクラスターでのみ利用可能です。

WaApbDlaYoywaMxxUMxcQLAOnDe

暗号化されたバックアップからの復元手順は、Encryption at Rest with CMEKを有効にするかどうかを除いて、通常の復元とほぼ同じです。

V1QJb3SK1oGa11xLljhcxKQEnkc

  • このオプションが有効な場合、復元後に作成されるクラスターは、以下で指定されたKMSキーを使用して暗号化されます。

  • このオプションが無効な場合、復元後に作成されるクラスターは暗号化されません。