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

挿入 (V1)

ノート

1 つ以上のエンティティをコレクションに挿入します。一度に追加できるエンティティは最大 100 件です。大量のデータを挿入する場合は、bulk-insert API の使用を推奨します。詳細は、Data Import を参照してください。

POST/v1/vector/insert
接続エンドポイント

https://${CLUSTER_ENDPOINT}

📘ノート
  • ${CLUSTER_ENDPOINT} を、あなたのZilliz Cloudクラスターのエンドポイントに置き換える必要があります。
  • エンドポイントを取得するには、Describe Cluster APIを使用してレスポンスから値を抽出してください。
shell
export CLUSTER_ENDPOINT=""
パラメータ
Authorizationstringheader必要

認証トークンは、適切な権限を持つ API key または username:password のようにコロンで連結された username と password の組である必要があります。

値の例： Bearer {{TOKEN}}
リクエスト・ボディapplication/json
dbNamestring

データベースの名前。

collectionNamestring必要

エンティティの挿入先コレクションの名前。

partitionNamestring

この操作が適用されるパーティションの名前。

dataoneOf必要

エンティティオブジェクト、またはエンティティオブジェクトの配列。エンティティオブジェクト内のキーはコレクションスキーマと一致している必要があることに注意してください

単一のエンティティ。その構造は対象コレクションのスキーマと一致している必要があります。

bash
export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v1/vector/insert" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "my_collection",
    "data": {
        "id": 1,
        "vector": [
            0.1,
            0.2,
            0.3,
            0.5,
            0.6
        ]
    }
}'
bash
export TOKEN="db_admin:xxxxxxxxxxxxx"

curl --request POST \
--url "${CLUSTER_ENDPOINT}/v1/vector/insert" \
--header "Authorization: Bearer ${TOKEN}" \
--header "Request-Timeout: 5" \
--header "Content-Type: application/json" \
-d '{
    "collectionName": "my_collection",
    "data": [
        {
            "id": 1,
            "vector": [
                0.1,
                0.2,
                0.3,
                0.5,
                0.6
            ]
        },
        {
            "id": 2,
            "vector": [
                0.2,
                0.3,
                0.4,
                0.6,
                0.7
            ]
        }
    ]
}'
レスポンス200 OK - application/json

挿入されたエンティティ数とそれらの ID の配列を返します。

codeinteger

レスポンスコード。

dataobject

挿入結果の統計情報を含むレスポンスペイロード。

insertCountinteger

挿入されたエンティティ数。

insertIdsarray

挿入されたエンティティの ID の配列を含むレスポンスペイロード。

[]insertIdsstring

挿入されたエンティティの ID。

エラーメッセージを返します。

codeinteger

レスポンスコード。

messagestring

エラーメッセージ。

Successjson
{
    "code": 200,
    "data": {
        "insertCount": 4,
        "insertIds": [
            "id1",
            "id2"
        ]
    }
}
Ctrl I