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

バックアップの作成

Zilliz Cloud では、バックアップとはデータのコピーであり、データ損失やシステム障害が発生した際にクラスター全体または特定のコレクションを復元するために使用されます。

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

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

📘Notes

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

制限

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

  • バックアップから除外されるもの:

    • コレクションの TTL 設定

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

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

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

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

    • 手動バックアップは一度に 1 つだけアクティブまたは保留中の状態にできます。

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

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

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

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

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

ウェブコンソール経由

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

RESTful API経由

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

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

コレクションのバックアップを作成する

クラスタ内の特定のコレクション、またはコレクションのサブセットをバックアップするには、コレクションレベルのバックアップを作成します。障害復旧のためにバックアップファイルを他のクラウドリージョンにコピーする必要がある場合は、バックアップ作成時にコピーポリシーを設定できます。詳細については、他のリージョンへのコピーを参照してください。

ウェブコンソール経由

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

RESTful API経由

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

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

よくある質問

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

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

バックアップ中に DDL(データ Definition 言語)操作を実行できますか?

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

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

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

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

暗号化されたクラスターをバックアップすると、暗号化範囲内のすべてのデータは引き続き暗号化された状態で保存され、Backup File 列の名前の横に鍵アイコンが表示されます。

TiPxbigzIo8wUQxsJ9wcOP3pnAb

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

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