メインコンテンツまでスキップ

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

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

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

制限​

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

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

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

復元中に、以下の設定も行えます。

  • RBAC 設定を含めるかどうかを選択します。

  • 復元される新しいクラスターの Milvus バージョンを選択します。

    • 過去 30 日以内に作成されたバックアップファイルの場合、元のクラスターが最新の利用可能な Milvus GA バージョンより古い Milvus 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 による保存時暗号化を有効にするかどうかを選択します。詳細については、Customer-Managed Encryption Keys を参照してください。

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

Web コンソールから​

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

RESTful API 経由​

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

bash
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

復元されたクラスターの Query CU サイズ。

collectionStatus

復元後にコレクションのロード状態を保持するかどうか。利用可能なオプションは次のとおりです。

  • KEEP: 元のコレクション状態を保持します。

  • RELEASE: すべてのコレクションを解放します

restoreVersionPolicy

復元されたクラスターの互換性のある Milvus バージョン。利用可能なオプションは次のとおりです。

  • ORIGINAL: クラスターを元の互換性のある Milvus バージョンに復元します。

  • LATEST: クラスターを利用可能な最新の GA Milvus バージョンに復元します。

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

bash
{
  "code": 0,
  "data": {
    "clusterId": "inxx-xxxxxxxxxxxxxxx",
    "username": "db_admin",
    "password": "xxxxxxxxx",
    "jobId": "job-xxxxxxxxxxxxxx"
  }
}

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

特定のデータベースとコレクションのみを既存のクラスターに復元することもできます。

Web コンソールから​

以下のデモは、Zilliz Cloud Web コンソールでクラスター内の特定のデータベースとコレクションを復元する方法を示しています。

RESTful API 経由​

以下の例では、バックアップファイルからコレクションを既存のクラスター inxx-xxxxxxxxxxxxxxx に復元します。RESTful API の詳細については、Restore Collection Backup を参照してください。

bash
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": "inxx-xxxxxxxxxxxxxxx",
    "dbCollections": [
        {
            "collections": [
                {
                    "collectionName": "medium_articles",
                    "destCollectionName": "restore_medium_articles",
                    "destCollectionStatus": "LOADED"
                }
            ]
        }
    ]
}'

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

bash
{
  "code": 0,
  "data": {
    "jobId": "job-04bf9335838dzkeydpxxxx"
  }
}

FAQ​

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

デフォルトでは、クラスター全体の復元では、Zilliz Cloud がサポートする最新の GA メジャーバージョンで対象クラスターが作成されます。

  • 過去 30 日以内に作成されたバックアップファイルの場合、元のクラスターが最新の利用可能な Milvus GA バージョンより古い Milvus 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 バージョンは変更できません。

Ctrl I