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 <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-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 <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 --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 による自動翻訳です。