データのインポート (RESTful API)
Contact Sales to Enable BYOC

このページでは、Zilliz Cloud RESTful API を使用して準備したデータをインポートする方法を紹介します。

開始前の準備

以下の条件が満たされていることを確認してください。

クラスター用の APIキーを取得していること。詳細については、APIキーを参照してください。
サポートされている形式のいずれかでデータを準備していること。

データの準備方法の詳細については、ストレージオプションおよび形式オプションを参照してください。また、エンドツーエンドのノートブックデータインポート Hands-On も参考にしてください。
サンプルデータセットと一致するスキーマでコレクションを作成していること。

コレクションの作成の詳細については、コレクションの管理 (コンソール) を参照してください。

データのインポート

外部ストレージからファイルをインポートするには、まずファイルをオブジェクトストレージバケットにアップロードする必要があります。アップロード後、リモートバケット内のファイルへのパスと、Zilliz Cloud がバケットからデータをプルするためのバケット認証情報を取得します。サポートされているオブジェクトパスの詳細については、ストレージオプションを参照してください。

データセキュリティ要件に応じて、データインポート時に長期認証情報または短期認証情報のいずれかを使用できます。

認証情報の取得の詳細については、以下を参照してください。

Amazon S3: 長期認証情報を使用した認証
Google Cloud Storage: サービスアカウントの HMAC キーの管理
Azure Blob Storage: アカウントアクセスキーの表示

セッショントークンの使用の詳細については、この FAQ を参照してください。

📘Notes

データのインポートを成功させるには、対象のコレクションの実行中または保留中のインポートジョブが 10,000 件未満であることを確認してください。

オブジェクトパスとバケット認証情報を取得したら、以下のように API を呼び出します。

# replace url and token with your own
curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/vectordb/jobs/import/create" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     -d '{
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "collectionName": "medium_articles",
        "partitionName": "",
        "objectUrl": "https://assets.zilliz.com/docs/example-data-import.json",
        "accessKey": "",
        "secretKey": ""
    }'

特定のパーティションにデータをインポートするには、リクエストに partitionName を含める必要があります。

Zilliz Cloud が上記のリクエストを処理した後、ジョブ ID が返されます。このジョブ ID を使用して、次のコマンドでインポートの進捗状況を監視できます。

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/vectordb/jobs/import/get_progress" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     -d '{
        "clusterId": "inxx-xxxxxxxxxxxxxxx",
        "jobId": "job-xxxxxxxxxxxxxxxxxxxxx"
    }'

詳細については、インポートおよびインポート進捗の取得を参照してください。

結果の確認

コマンドの出力が以下のようであれば、インポートジョブは正常に送信されています。

{
    "code": 0,
    "data": {
        "jobId": "job-xxxxxxxxxxxxxxxxxxxxx"
    }
}

RESTful API を呼び出して、現在のインポートジョブの進捗状況を取得したり、すべてのインポートジョブを一覧表示したりすることもできます。または、Zilliz Cloud コンソールのジョブセンターに移動して、結果とジョブの詳細を確認することもできます。

開始前の準備​

データのインポート​

結果の確認​

開始前の準備

データのインポート

結果の確認