insert()

この操作は、特定の collection にデータを挿入します。

javascript
await milvusClient.insert(data: InsertReq)

Request Syntax

javascript
await milvusClient.insert({
    collection_name: string,
    data: RowData | RowData[],
    partition_name?: string,
    db_name?: string,
    timeout?: number,
})

PARAMETERS:

db_name (string) -

対象の collection を保持するデータベースの名前。
collection_name (string) -

[REQUIRED]

既存の collection の名前。

data (RowData[]) -

現在の collection に挿入するデータ。

挿入するデータは、現在の collection のスキーマに一致する辞書、またはそのような辞書のリストである必要があります。

次のコードは、現在の collection のスキーマに id と vector という名前の 2 つのフィールドがあることを前提としています。前者は主フィールドであり、後者は 5 次元の vector 埋め込みを保持するためのフィールドです。

javascript
// A dictionary, or
data={
    'id': 0,
    'vector': [
        0.6186516144460161,
        0.5927442462488592,
        0.848608119657156,
        0.9287046808231654,
        -0.42215796530168403
    ]
}

// A list of dictionaries
data = [
    {
        'id': 1,
        'vector': [
            0.37417449965222693,
            -0.9401784221711342,
            0.9197526367693833,
            0.49519396415367245,
            -0.558567588166478
        ]
    },
    {
        'id': 2,
        'vector': [
            0.46949086179692356,
            -0.533609076732849,
            -0.8344432775467099,
            0.9797361846081416,
            0.6294256393761057
        ]
    }
]

timeout (number)

この操作のタイムアウト時間。

これを None に設定すると、何らかの応答が到着するか、何らかのエラーが発生した時点でこの操作はタイムアウトします。
partition_name (string | None) -

現在の collection 内の partition の名前。

指定した場合、データは指定された partition に挿入されます。

RETURNS Promise<MutationResult>

このメソッドは、MutationResult オブジェクトに解決される promise を返します。

typescript
{
    succ_index: number[],
    err_index: number[],
    acknowledged: boolean,
    insert_cnt: string,
    delete_cnt: string,
    upsert_cnt: string,
    timestamp: string,
    IDs: { int_id?: { data: number[] }, str_id?: { data: string[] }, id_field: 'int_id' | 'str_id' },
    status:  ResStatus
}

PARAMETERS:

succ_index (number[]) -
正常に挿入された行の、入力データ内における 0 始まりの位置。
err_index (number[]) -
拒否された行の 0 始まりの位置。すべての行が成功した場合、このリストは空です。
acknowledged (boolean) -
書き込みが Milvus によって確認されたかどうか。
insert_cnt (string) -
挿入された行数。文字列としてフォーマットされます。
delete_cnt (string) -
この操作によって削除された行数。insert() では常に "0" です。
upsert_cnt (string) -
この操作によって upsert された行数。insert() では常に "0" です。
timestamp (string) -
書き込みが可視になった時点のハイブリッドタイムスタンプ。time-travel クエリにはこの値を使用します。
IDs (StringArrayId | NumberArrayId) -
挿入された行に割り当てられた主キー。autoID collection の場合、Milvus がこれらの値を生成します。それ以外の場合は、入力キーがそのまま返されます。
- int_id ({ data: number[] }) -
  
  主キーが整数フィールドの場合に設定されます。
- str_id ({ data: string[] }) -
  
  主キーが VARCHAR フィールドの場合に設定されます。
- id_field ('int_id' | 'str_id') -
  
  2 つの id 配列のうち、どちらが値を保持しているかを示します。
ResStatus
ResStatus オブジェクト。
- code (number) -
  
  操作結果を示すコード。この操作が成功した場合、0 のままです。
- error_code (string | number) -
  
  発生したエラーを示すエラーコード。この操作が成功した場合、Success のままです。
- reason (string) -
  
  報告されたエラーの理由を示す理由。この操作が成功した場合、空文字列のままです。

Example

javascript
import { MilvusClient } from '@zilliz/milvus2-sdk-node';

const milvusClient = new MilvusClient({
    address: 'YOUR_CLUSTER_ENDPOINT',
    token: 'YOUR_CLUSTER_TOKEN',
});

const res = await milvusClient.insert({
    collection_name: 'my_collection',
    data: [
        { id: 1, vector: [0.1, 0.2, 0.3, 0.4, 0.5], text: 'Hello' },
        { id: 2, vector: [0.6, 0.7, 0.8, 0.9, 1.0], text: 'World' },
    ],
});

console.log(res.insert_cnt); // '2'

Request Syntax​

Example​

Request Syntax

Example