バックアップファイルからの復元
Contact Sales to Enable BYOC

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

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

制限

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

クラスター全体の復元

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

復元中に、次の項目も設定できます。

RBAC 設定を含めるかどうかを選択します。
復元後に作成される新しいクラスターの Milvus バージョンを選択します。
- 過去 30 日以内に作成されたバックアップファイルで、元のクラスターが利用可能な最新の Milvus GA バージョンより前の GA バージョンを使用していた場合、復元後のクラスターで使用する Milvus バージョンを選択できます。デフォルトでは、Zilliz Cloud は最新の GA Milvus バージョンに復元します。
- 30 日より前に作成されたバックアップファイル、またはすでに最新の Milvus GA バージョンを使用しているバックアップファイルでは、ターゲット Milvus バージョンを変更できません。
たとえば、利用可能な最新の Milvus GA バージョンが 2.6.x であるとします。
- 過去 30 日以内に作成された 2.5.x のバックアップファイルから復元する場合、Zilliz Cloud はデフォルトで新しいクラスターを 2.6.x に復元しますが、2.5.x に復元するよう選択できます。
- 30 日より前に作成された 2.5.x のバックアップファイルから復元する場合、Zilliz Cloud はデフォルトで新しいクラスターを 2.6.x に復元し、ターゲット Milvus バージョンは変更できません。
- 2.6.x のバックアップファイルから復元する場合、Zilliz Cloud は新しいクラスターを 2.6.x に復元し、ターゲット Milvus バージョンは変更できません。
CMEK による保存時暗号化を有効にするかどうかを選択します。詳細については、カスタマー管理暗号化キーを参照してください。

復元後、新しいパスワードが 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",
        "restoreVersionPolicy": "ORIGINAL"
      }'

次の表は、各パラメーターについて説明しています。

パラメーター	説明
`targetProjectId`	復元後のクラスターを作成するターゲットプロジェクトの ID。
`clusterName`	復元後のクラスター名。
`cuSize`	復元後のクラスターのクエリ CU サイズ。
`collectionStatus`	復元後にコレクションのロード状態を保持するかどうか。使用可能なオプションは次のとおりです。 `KEEP`: 元のコレクション状態を保持します。 `RELEASE`: すべてのコレクションを解放します。
`restoreVersionPolicy`	復元後のクラスターで使用する互換 Milvus バージョン。使用可能なオプションは次のとおりです。 `ORIGINAL`: クラスターを元の互換 Milvus バージョンに復元します。 `LATEST`: 利用可能な最新の GA Milvus バージョンに復元します。

復元ジョブが生成され、進捗状況はプロジェクトジョブセンターで確認できます。

{
  "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 がサポートする最新の GA メジャーバージョンでターゲットクラスターが作成されます。

過去 30 日以内に作成されたバックアップファイルで、元のクラスターが利用可能な最新の Milvus GA バージョンより前の GA バージョンを使用していた場合、復元後のクラスターで使用する Milvus バージョンを選択できます。デフォルトでは、Zilliz Cloud は最新の GA Milvus バージョンに復元します。
30 日より前に作成されたバックアップファイル、またはすでに最新の Milvus GA バージョンを使用しているバックアップファイルでは、ターゲット Milvus バージョンを変更できません。

たとえば、利用可能な最新の Milvus GA バージョンが 2.6.x であるとします。

過去 30 日以内に作成された 2.5.x のバックアップファイルから復元する場合、Zilliz Cloud はデフォルトで新しいクラスターを 2.6.x に復元しますが、2.5.x に復元するよう選択できます。
30 日より前に作成された 2.5.x のバックアップファイルから復元する場合、Zilliz Cloud はデフォルトで新しいクラスターを 2.6.x に復元し、ターゲット Milvus バージョンは変更できません。
2.6.x のバックアップファイルから復元する場合、Zilliz Cloud は新しいクラスターを 2.6.x に復元し、ターゲット Milvus バージョンは変更できません。

制限​

クラスター全体の復元​

ウェブコンソール経由​

RESTful API経由​

クラスタの一部を復元する​

ウェブコンソール経由​

RESTful API経由​

FAQ​

制限

クラスター全体の復元

ウェブコンソール経由

RESTful API経由

クラスタの一部を復元する

ウェブコンソール経由

RESTful API経由

FAQ