メインコンテンツまでスキップ

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

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

📘注意

この機能は、Enterprise プロジェクト内の Dedicated cluster を対象に Private Preview として提供されています。この機能を有効にする方法、または関連する費用については、Zilliz Cloud サポートにお問い合わせください。

始める前に​

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

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

手順​

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

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

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

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

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

    📘注意

    エクスポートできるのは、ステータスが Available のバックアップファイルのみです。

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

    • Cloud Region of Cluster in Backup File: バックアップファイルが作成された cloud region を表示します。

    • Integration: Zilliz Cloud と統合されているオブジェクトストレージプロバイダーを選択します。

    • Integration Configuration: バックアップのエクスポート用に設定した特定のバケットを選択します。

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

  5. 次に、Export をクリックします。

export-backup-file

RESTful API によるエクスポート​

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

bash
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/"
}'

上記のリクエストに対するレスポンスは、次のような Job ID になります。

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

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

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

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

  2. ジョブの Status を監視します。

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

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

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

monitor-export-job

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

ジョブが IN PROGRESS ステータスのままで、続行しないことにした場合は、Actions 列の Cancel をクリックしてジョブをキャンセルできます。

📘注意

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

Ctrl I