スキルOfficialdatabase
💾backup
- プラグイン
- zilliz
- ソース
- GitHub で見る ↗
説明
次のような場合に使用: ユーザーが Zilliz Cloud 上でバックアップの作成、一覧表示、詳細確認、削除、エクスポート、またはリストアを行いたい場合、あるいはバックアップポリシーを管理したい場合。
原文を表示
Use when the user wants to create, list, describe, delete, export, or restore backups, or manage backup policies on Zilliz Cloud.
ユースケース
- ✓Zilliz Cloud上でバックアップを作成したい
- ✓バックアップの一覧表示・詳細確認したい
- ✓バックアップを削除またはエクスポートしたい
- ✓バックアップからリストアしたい
- ✓バックアップポリシーを管理したい
本文(日本語訳)
前提条件
- CLIがインストール済みでログイン済みであること(セットアップスキルを参照)。
- クラスターコンテキストは不要 -- バックアップ操作では
--cluster-idを直接使用します。
コマンドリファレンス
バックアップの作成
zilliz backup create --cluster-id <cluster-id>
# オプション:
# --database <database-name>
# --collection <collection-name>
# --backup-type <CLUSTER|COLLECTION>
# または生JSONで指定: --body '{...}'
バックアップ一覧の取得
zilliz backup list
# オプション:
# --project-id <project-idでフィルタリング>
# --cluster-id <cluster-idでフィルタリング>
# --creation-method <MANUAL|AUTO>
# --backup-type <CLUSTER|COLLECTION>
# ページネーション: --page-size <n> --page <n>
# 全ページを取得: --all
バックアップの詳細取得
zilliz backup describe --cluster-id <cluster-id> --backup-id <backup-id>
バックアップの削除
zilliz backup delete --cluster-id <cluster-id> --backup-id <backup-id-to-delete>
バックアップのエクスポート
zilliz backup export \
--cluster-id <cluster-id> \
--backup-id <backup-id> \
--integration-id <storage-integration-id>
# オプション: --directory <directory>
新規クラスターへのリストア
zilliz backup restore-cluster \
--cluster-id <source-cluster-id> \
--backup-id <backup-id-to-restore> \
--project-id <target-project-id> \
--name <new-cluster-name> \
--cu-size <compute-units-for-new-cluster> \
--collection-status <LOADED|NOT_LOADED>
特定コレクションのリストア
zilliz backup restore-collection \
--cluster-id <source-cluster-id> \
--backup-id <backup-id> \
--dest-cluster-id <destination-cluster-id>
# または生JSONで指定: --body '{"collections": [{"source": "col1", "target": "col1_restored"}]}'
バックアップポリシーの詳細取得
zilliz backup describe-policy --cluster-id <cluster-id>
バックアップポリシーの更新
zilliz backup update-policy --cluster-id <cluster-id> --auto-backup <true|false>
# オプション:
# --frequency <frequency>
# --start-time <start-time>
# --retention-days <バックアップ保持日数>
# または生JSONで指定: --body '{...}'
バックアップポリシーのフォーマット
頻度: daily | weekdays | weekends | 1-7(1=月曜、7=日曜)、例: 1,3,5
開始時刻: HH:MM または HH:MM-HH:MM(時間帯ウィンドウ)、例: 02:00 または 03:00-05:00
利用ガイダンス
- バックアップタイプは自動的に判別されます。
--collectionが指定された場合は COLLECTION バックアップ、指定がない場合は CLUSTER バックアップとなります。 - バックアップの作成・エクスポート・リストア操作は非同期です。開始後は
backup describeを使用して進捗を確認してください。 - エクスポート時の
--integration-idは、Zilliz Cloud コンソールで設定済みのクラウドストレージインテグレーションを指します(設定方法はインポートスキルを参照)。 - バックアップを削除する前に、ユーザーへ確認を取ってください -- この操作は元に戻せません。
- リストア時は、クラスターリストア(新規クラスターへのリストア)とコレクションリストア(既存クラスターへのリストア)の違いをユーザーに説明してください。
- 本番クラスターにはバックアップポリシーの設定を推奨してください。
原文(English)を表示
Prerequisites
- CLI installed and logged in (see setup skill).
- No cluster context required -- backup operations use
--cluster-iddirectly.
Commands Reference
Create a Backup
zilliz backup create --cluster-id <cluster-id>
# Optional:
# --database <database-name>
# --collection <collection-name>
# --backup-type <CLUSTER|COLLECTION>
# Or use raw JSON: --body '{...}'
List Backups
zilliz backup list
# Optional:
# --project-id <filter-by-project-id>
# --cluster-id <filter-by-cluster-id>
# --creation-method <MANUAL|AUTO>
# --backup-type <CLUSTER|COLLECTION>
# Pagination: --page-size <n> --page <n>
# Fetch all pages: --all
Describe a Backup
zilliz backup describe --cluster-id <cluster-id> --backup-id <backup-id>
Delete a Backup
zilliz backup delete --cluster-id <cluster-id> --backup-id <backup-id-to-delete>
Export a Backup
zilliz backup export \
--cluster-id <cluster-id> \
--backup-id <backup-id> \
--integration-id <storage-integration-id>
# Optional: --directory <directory>
Restore to a New Cluster
zilliz backup restore-cluster \
--cluster-id <source-cluster-id> \
--backup-id <backup-id-to-restore> \
--project-id <target-project-id> \
--name <new-cluster-name> \
--cu-size <compute-units-for-new-cluster> \
--collection-status <LOADED|NOT_LOADED>
Restore Specific Collections
zilliz backup restore-collection \
--cluster-id <source-cluster-id> \
--backup-id <backup-id> \
--dest-cluster-id <destination-cluster-id>
# Or use raw JSON: --body '{"collections": [{"source": "col1", "target": "col1_restored"}]}'
Describe Backup Policy
zilliz backup describe-policy --cluster-id <cluster-id>
Update Backup Policy
zilliz backup update-policy --cluster-id <cluster-id> --auto-backup <true|false>
# Optional:
# --frequency <frequency>
# --start-time <start-time>
# --retention-days <days-to-retain-backups>
# Or use raw JSON: --body '{...}'
Backup Policy Format
Frequency: daily | weekdays | weekends | 1-7 (1=Mon, 7=Sun), e.g. 1,3,5
Start time: HH:MM or HH:MM-HH:MM (time window), e.g. 02:00 or 03:00-05:00
Guidance
- The backup type is automatically derived: if
--collectionis provided, it's a COLLECTION backup; otherwise it's a CLUSTER backup. - Backup creation, export, and restore operations are asynchronous. After starting, use
backup describeto check progress. - The
--integration-idfor export refers to a cloud storage integration configured in the Zilliz Cloud console (see import skill for setup guidance). - Before deleting a backup, confirm with the user -- this is irreversible.
- When restoring, explain the difference between cluster restore (new cluster) and collection restore (into existing cluster).
- Suggest setting up a backup policy for production clusters.
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。