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

バックアップの作成

Zilliz Cloud において、バックアップとは、データ損失やシステム障害が発生した際にクラスター全体または特定のコレクションを復元できるようにするデータの複製です。

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

制限​

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

  • バックアップから除外:

    • コレクションの TTL 設定

    • デフォルトユーザー db_admin のパスワード（スナップショットからの復元 中に新しいパスワードが生成されます）

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

  • クラスターシャード設定: バックアップされますが、シャードあたりの CU 制限により、クラスターの CU サイズが縮小された場合、復元時に調整される可能性があります。詳細については、Zilliz Cloud の制限 をご覧ください。

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

    • アクティブまたは保留中の手動バックアップは同時に 1 つのみ可能です。

    • 自動バックアップが有効になっている場合:

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

      • 手動バックアップが既に実行中であっても、自動バックアップは引き続き実行されます。

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

クラスター全体のバックアップを作成し、後でクラスター全体または選択したコレクションを復元することができます。

ウェブコンソール経由​

以下のデモでは、Zilliz Cloud ウェブコンソールでクラスターバックアップを作成する方法を示しています。

RESTful API 経由​

以下の例では、クラスター in01-xxxxxxxxxxxxxx のバックアップを作成します。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/create" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Content-Type: application/json" \
     --data-raw '{
            "backupType": "CLUSTER"
      }'

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

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

Create collection backup​

特定のコレクションまたはクラスター内のコレクションのサブセットをバックアップするには、コレクションレベルのバックアップを作成します。

ウェブコンソール経由​

次のデモでは、ウェブコンソール経由でコレクションバックアップを作成する方法を示します。

RESTful API経由​

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

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

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

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

FAQs​

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

バックアップの所要時間はデータのサイズに依存します。参考として、700 MB のバックアップには通常約 1 秒かかります。クラスターに 1,000 を超えるコレクションが含まれている場合、プロセスはわずかに長くなる可能性があります。

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

バックアップの実行中は、コレクションの作成や削除など、主要な DDL（データ定義言語）操作を避けることを推奨します。これらの操作はプロセスに干渉したり、結果の不整合を引き起こしたりする可能性があるためです。

元のクラスターが削除された場合、バックアップファイルも削除されますか？​

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