メインコンテンツまでスキップ
バージョン: 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

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