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

バックアップの作成

Zilliz Cloud におけるバックアップは、データ損失やシステム障害時にクラスター全体または特定のコレクションを復元するためのデータコピーです。

バックアップの作成には追加の料金が発生し、料金はバックアップの保存先クラウドリージョンによって決まります。すべてのバックアップファイルは、ソースクラスターと同じクラウドリージョンに保存されます。たとえば、AWS us-west-2 のクラスターのバックアップは AWS us-west-2 に保存されます。

このガイドでは、手動でバックアップを作成する方法を説明します。バックアップ作成を自動化するには、自動バックアップのスケジュールを参照してください。

📘Notes

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

制限事項​

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

  • バックアップ対象外:

    • コレクションの TTL 設定

    • デフォルトユーザー db_admin のパスワード（復元時に新しいパスワードが生成されます）

    • クラスターの動的スケーリングおよびスケジュールされたスケーリングの設定

  • クラスターシャード設定: バックアップに含まれますが、復元時にクラスターの CU サイズが縮小される場合、CU あたりのシャード数制限により調整されることがあります。詳細は Zilliz Cloud の制限事項を参照してください。

  • バックアップジョブの制限:

    • 同時に実行中または保留中にできる手動バックアップは1 つだけです。

    • 自動バックアップが有効な場合:

      • 自動バックアップの実行中は、手動バックアップを開始できません。

      • 手動バックアップが実行中の場合でも、自動バックアップは通常通り実行されます。

  • 請求書の未払いにより組織が凍結された場合、その 60 日後にバックアップは自動的に削除されます。

クラスターバックアップの作成​

クラスター全体のバックアップを作成しておけば、後からクラスター全体または選択したコレクションを復元できます。ディザスタリカバリのためにバックアップファイルを他のクラウドリージョンへコピーする必要がある場合は、バックアップ作成時にコピーポリシーを設定できます。詳細は他のリージョンへのコピーを参照してください。

Web コンソールを使用する場合​

以下のデモでは、Zilliz Cloud Web コンソールでクラスターバックアップを作成する方法を紹介します。

RESTful API を使用する場合​

次の例では、クラスター in01-xxxxxxxxxxxxxx のバックアップを作成します。RESTful API の詳細については、バックアップの作成を参照してください。

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/create" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Content-Type: application/json" \
     --data-raw '{
            "backupType": "CLUSTER"
      }'

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

bash
{
  "code": 0,
  "data": {
    "backupId": "backup0_c7b18539b97xxxx",
    "backupName": "Dedicated-01_backup2",
    "jobId": "job-031a8e3587ba7zqkadxxxx"
  }
}

コレクションバックアップの作成​

クラスター内の特定のコレクションまたは一部のコレクションのみをバックアップするには、コレクションレベルのバックアップを作成します。ディザスタリカバリのためにバックアップファイルを他のクラウドリージョンへコピーする必要がある場合は、バックアップ作成時にコピーポリシーを設定できます。詳細は他のリージョンへのコピーを参照してください。

Web コンソールを使用する場合​

以下のデモでは、Web コンソールでコレクションバックアップを作成する方法を紹介します。

RESTful API を使用する場合​

次の例では、クラスター in01-xxxxxxxxxxxxxx 内のコレクション medium_articles のバックアップを作成します。RESTful API の詳細については、バックアップの作成を参照してください。

bash
curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/create" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Content-Type: application/json" \
-d '{
    "backupType": "COLLECTION",
    "dbCollections": [
        {
            "collectionNames": [
                "medium_articles"
            ]
        }
    ]
}'

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

bash
{
  "code": 0,
  "data": {
    "backupId": "backup0_c7b18539b97xxxx",
    "backupName": "Dedicated-01_backup2",
    "jobId": "job-031a8e3587ba7zqkadxxxx"
  }
}

よくある質問​

バックアップジョブにはどのくらいの時間がかかりますか？​

バックアップの所要時間はデータサイズによって異なります。目安として、700 MB のバックアップには通常約 1 秒かかります。クラスターに 1,000 を超えるコレクションが含まれる場合は、処理に少し時間がかかることがあります。

バックアップ中に DDL（データ定義言語）操作を実行できますか？​

バックアップの実行中は、コレクションの作成や削除といった大規模な DDL（データ定義言語）操作を避けることを推奨します。これらの操作はバックアップ処理に影響を与えたり、不整合な結果を引き起こしたりする可能性があります。

元のクラスターを削除すると、バックアップファイルも削除されますか？​

これはバックアップファイルの作成方法によって異なります。すべての自動バックアップは元のクラスターとともに削除されます。一方、手動で作成したクラスターバックアップは永続的に保持され、クラスターを削除しても消去されません。不要になった場合は手動で削除する必要があります。

暗号化されたクラスターをバックアップするとどうなりますか？​

暗号化されたクラスターをバックアップすると、暗号化スコープ内のすべてのデータは暗号化された状態のままとなり、バックアップファイル列の名前の横に鍵アイコンが表示されます。

TiPxbigzIo8wUQxsJ9wcOP3pnAb

暗号化されたバックアップを新しいクラスターに復元する際、Zilliz Cloud はバックアップファイルに関連付けられた KMS キーを使用してデータを復号してから復元を行います。そのため、暗号化の有無にかかわらず、バックアップを新しいクラスターに復元できます。

詳細については、暗号化されたバックアップからの復元を参照してください。

Ctrl I