SKILLOfficialdatabase

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 <プロジェクトIDで絞り込み>
#   --cluster-id <クラスター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 <KEEP|RELEASE>
# オプション: --restore-version-policy <LATEST|ORIGINAL>

特定のコレクションを復元

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 <days-to-retain-backups>
# または 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 が指定されると「コレクションバックアップ」、指定されなければ「クラスターバックアップ」になります
バックアップの作成、エクスポート、復元は非同期処理です。開始後は backup describe コマンドで進行状況を確認してください
エクスポート時の --integration-id は、Zilliz Cloudコンソールで設定したクラウドストレージ連携を指します（セットアップの詳細はインポートスキルを参照）
バックアップ削除前に必ずユーザーに確認してください — 削除は取り消せません
復元時には「クラスター復元（新しいクラスターを作成）」と「コレクション復元（既存クラスターに復元）」の違いを説明してください
本番環境のクラスターについては、バックアップポリシー（自動バックアップ）の設定を勧めてください

原文（English）を表示

Prerequisites

CLI installed and logged in (see setup skill).
No cluster context required -- backup operations use --cluster-id directly.

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 <KEEP|RELEASE>
# Optional: --restore-version-policy <LATEST|ORIGINAL>

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 --collection is provided, it's a COLLECTION backup; otherwise it's a CLUSTER backup.
Backup creation, export, and restore operations are asynchronous. After starting, use backup describe to check progress.
The --integration-id for 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 による自動翻訳です。