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

バックアップファイルのエクスポート
Private Preview

Zilliz Cloud コンソールを使用して、バックアップファイルをオブジェクトストレージにエクスポートできます。

📘Notes

この機能は、Enterprise プロジェクト内の Dedicated クラスター向けに プライベートプレビュー として提供されています。この機能を有効化する方法や関連コストについて詳しく知るには、Zilliz Cloud サポートまでお問い合わせください。

開始前の準備​

  • Zilliz Cloud をオブジェクトストレージと統合済みであること。詳細な手順については、AWS S3 との統合、Azure Blob Storage との統合、または Google Cloud Storage との統合 を参照してください。

  • プロジェクトに対して 組織オーナー または プロジェクト管理者 のアクセス権を持っていること。必要な権限がない場合は、Zilliz Cloud 管理者にお問い合わせください。

手順​

Zilliz Cloud からバックアップファイルをエクスポートするには、Zilliz Cloud コンソールまたは RESTful API のいずれかを使用できます。

Zilliz Cloud コンソールからエクスポートする​

  1. Zilliz Cloud コンソール にログインします。

  2. 左側のナビゲーションペインで Backups を選択します。

  3. 表示されたページで、対象のバックアップファイルを見つけ、Actions 列の ... をクリックし、Export を選択します。

    📘Notes

    Available ステータスのバックアップファイルのみエクスポート可能です。

  4. Export Backup File ダイアログボックスで、バックアップ設定を構成します：

    • クラウドリージョン of Cluster in Backup File: バックアップファイルが作成されたクラウドリージョンが表示されます。

    • Integration: Zilliz Cloud と統合済みのオブジェクトストレージプロバイダーを選択します。

    • 統合設定: バックアップエクスポート用に設定したバケットを指定します。

    • Directory: エクスポートされたバックアップファイルを保存するオブジェクトストレージバケット内のディレクトリパスを入力します。

  5. Export をクリックします。

export-backup-file

RESTful API からエクスポートする​

Export Backup Files RESTful API エンドポイントを使用して Zilliz Cloud からバックアップファイルをエクスポートする前に、AWS S3 バケットのいずれかを Zilliz Cloud と統合し、その統合IDを取得しておく必要があります。詳細については、統合IDの取得 を参照してください。

export BASE_URL="https://api.cloud.zilliz.com"
export TOKEN="YOUR_API_KEY"
export CLUSTER_ID="inxx-xxxxxxxxxxxxxxx"
export BACKUP_ID="backup-xxxxxxxxxxxxxxx"

curl --request POST \
--url "${BASE_URL}/v2/clusters/${CLUSTER_ID}/backups/${BACKUP_ID}/export" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Content-Type: application/json" \
-d '{
    "integrationId": "inter-xxxxxxx",
    "directory": "destdir/"
}'

上記リクエストに対するレスポンスは、以下のようなジョブIDになります。

{
    "code": 0,
    "data": {
        "jobId": "job-0396450098cglufig6afm9"
    }
}

エクスポートの進行状況を監視する​

Export をクリックすると、自動的にエクスポートジョブが生成されます。

  1. 左側のナビゲーションペインから ジョブ ページに移動します。

  2. ジョブの Status を確認します。

    • IN PROGRESS: ファイルがエクスポート中です。

    • SUCCESSFUL: バックアップファイルが正常にエクスポートされました。指定した S3 バケットからアクセスできます。

    • ERROR: ジョブが失敗しました。これは、エクスポート処理で使用されるリソース（ロール ARN やバックアップファイルなど）がジョブ実行中に削除された場合に発生することがあります。

monitor-export-job

エクスポートジョブをキャンセルする​

ジョブが IN PROGRESS の状態のまま継続しており、処理を中止したい場合は、Actions 列の Cancel をクリックしてジョブをキャンセルできます。

📘Notes

途中でキャンセルしても、すでにバケットにアップロードされたデータは削除されません。