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

自動バックアップをスケジュールする

Zilliz Cloudでは、クラスターの自動バックアップを有効にすることで、予期せぬ問題が発生した場合のデータ復旧を確実にすることができます。自動バックアップはクラスター全体に適用されます。個々のコレクションを自動的にバックアップすることはサポートされていません。

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

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

📘Notes

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

制限事項​

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

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

    • コレクションのTTL設定

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

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

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

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

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

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

自動バックアップを有効にする​

自動バックアップ設定はクラスター固有であり、デフォルトで無効です。バックアップにはストレージコストがかかるため、Zilliz Cloudがバックアップを作成するタイミングと方法を制御できます。自動バックアップを有効にすると、Zilliz Cloudはすぐに最初のバックアップを生成し、その後、指定されたスケジュールに基づいて定期的なバックアップを行います。

災害復旧のためにバックアップファイルを他のクラウドリージョンにコピーする必要がある場合は、自動バックアップを有効にする際にコピーポリシーを設定できます。詳細については、他のリージョンへのコピーを参照してください。

ウェブコンソール経由​

ウェブコンソールで自動バックアップを有効にすると、Zilliz Cloudはデフォルトで以下の設定になります。

  • 頻度: 毎日バックアップを作成

  • バックアップ時間: 午前8時から午前10時（UTC +08:00）の間

  • 保持期間: 各バックアップを7日間保持

これらの設定は、必要に応じて調整できます。

以下のデモは、自動バックアップを有効にして設定する方法を示しています。

RESTful API経由​

以下の例は、クラスターの自動バックアップを有効にします。RESTful APIの詳細については、バックアップポリシーの設定を参照してください。

export TOKEN="YOUR_API_KEY"
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/policy" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "frequency": "1,2,3,5",
    "startTime": "02:00-04:00",
    "retentionDays": 7,
    "enabled": true
}'

上記ポリシーを使用して作成されたバックアップのクロスリージョンコピーも作成するには、次のようにします。

curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/policy" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "frequency": "1,2,3,5",
    "startTime": "02:00-04:00",
    "retentionDays": 7,
    "enabled": true,
    "crossRegionPolicies": [
        {
            "regionId": "aws-us-west-2",
            "retentionDays": 7,
            "region": "us-west-2"
        },
        {
            "regionId": "aws-us-east-1",
            "retentionDays": 7,
            "region": "us-east-1"
        }
    ]
}'

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

{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "status": "ENABLED"
    }
}

バックアップスケジュールの確認​

自動バックアップが有効になっている場合、そのスケジュールを確認できます。

ウェブコンソール経由​

以下のデモは、Zilliz Cloudウェブコンソールで自動バックアップスケジュールを確認する方法を示しています。

RESTful API経由​

以下の例は、クラスターの自動バックアップポリシーを確認します。RESTful APIの詳細については、Get Backup Policyを参照してください。

curl --request GET \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/policy" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json"

以下は出力例です。

{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "status": "ENABLED",
        "startTime": "02:00-04:00",
        "frequency": "1,2,3,5",
        "retentionDays": 7,
        "crossRegionPolicies": [
            {
                "regionId": "aws-us-west-2",
                "retentionDays": 7,
                "region": "us-west-2"
            },
            {
                "regionId": "aws-us-east-1",
                "retentionDays": 7,
                "region": "us-east-1"
            }
        ]
    }
}

自動バックアップを無効にする​

クラスターの自動バックアップを無効にすることもできます。

ウェブコンソール経由​

以下のデモは、Zilliz Cloudウェブコンソールで自動バックアップスケジュールを確認する方法を示しています。

RESTful API経由​

以下の例は、クラスターの自動バックアップを無効にします。RESTful APIの詳細については、Set Backup Policyを参照してください。

curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/policy" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "enabled": false
}'

以下は出力例です。

{
    "code": 0,
    "data": {
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "status": "DISABLED"
    }
}

よくある質問​

バックアップジョブにはどのくらいの時間がかかりますか？ バックアップの期間は、データのサイズによって異なります。参考として、700 MBのバックアップには通常約1秒かかります。クラスターに1,000を超えるコレクションが含まれている場合、プロセスにはもう少し時間がかかる場合があります。

バックアップ中にDDL（データ定義言語）操作を実行できますか？ バックアップの進行中に、コレクションの作成や削除などの主要なDDL（データ定義言語）操作は避けることをお勧めします。これらの操作はプロセスを妨げたり、一貫性のない結果につながる可能性があります。

自動バックアップファイルの保持期間はどのくらいですか？

自動バックアップのデフォルトの保持期間は7日間で、最大30日間まで調整できます。

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

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