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

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

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

このガイドでは、バックアップファイルからクラスターの完全または部分的な復元を行う方法について説明します。

制限

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

クラスター全体の復元

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

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

📘Notes

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

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

ウェブコンソール経由

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

RESTful API経由

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

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 の詳細については、コレクションバックアップの復元 を参照してください。

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"
}
}

FAQ

復元されたクラスターはどの Milvus バージョンで実行されますか?

復元されたクラスターは、バックアップ作成時に使用されたバージョンに関係なく、復元時点で Zilliz Cloud がサポートする最新の Milvus バージョンで実行されます。例えば、Milvus 2.5.x クラスターのバックアップを作成し、プラットフォームが 2.6.x にアップグレードされた後に復元した場合、復元されたクラスターは Milvus 2.6.x で実行されます。バックアップファイルにはデータのみが含まれており、クラスターのバージョンはプラットフォームによって決定されます。