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

自動バックアップのスケジュール設定

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

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

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

Notes

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

制限事項​

  • アクセス制御: Project Admin、Organization Owner、またはバックアップ権限を持つカスタムロールである必要があります。

  • バックアップから除外される項目:

    • コレクションの TTL 設定

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

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

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

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

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

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

  • 組織が凍結されると、バックアップは 60 日後に自動的に削除されます。

自動バックアップの有効化​

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

ディザスタリカバリのためにバックアップファイルを他のクラウドリージョンにコピーする必要がある場合は、自動バックアップを有効にする際にコピーポリシーを構成できます。詳細については、クロスリージョンバックアップを参照してください。

Web コンソールでの操作​

以下のデモでは、自動バックアップを有効化して設定する方法を説明します。

1

対象のクラスターに移動します。

2

Backups タブをクリックします。

3

Backup Policy カードのスイッチをオンにします。

4

バックアップスケジュールを設定します。

  • タイムゾーン: スケジュールされたバックアップイベントのトリガーに使用されるタイムゾーンです。

  • スケジュール: スケジュールを定義するには、以下のいずれかのモードを選択します。

    • Basic: 頻度(毎週または毎月)を選択し、曜日と時刻を選択します。

    • Advanced: Cron 式を入力してスケジュールを定義します。詳細については、Cron 式の理解を参照してください。

5

(任意)クロスリージョンバックアップ機能を有効にすることもできます。

6

Save をクリックします。

RESTful API での操作​

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

bash
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
}'

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

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

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

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

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

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

Web コンソールでの操作​

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

RESTful API での操作​

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

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

以下は出力例です。

bash
{
"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"
}
]
}
}

自動バックアップの無効化​

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

Web コンソールでの操作​

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

RESTful API での操作​

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

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

以下は出力例です。

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

よくある質問​

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

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

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

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

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

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