upsert()

collection に行をアップサートします。部分更新ではフィールド操作を適用でき、各行は collection スキーマに対して検証されます。

java

public UpsertResp upsert(UpsertReq request)

Request Syntax

java

UpsertReq.builder()
    .data(data)
    .databaseName(databaseName)
    .collectionName(collectionName)
    .partitionName(partitionName)
    .partialUpdate(partialUpdate)
    .fieldOps(fieldOps)
    .build();

BUILDER METHODS:

• data(List<JsonObject> data)

  挿入または更新する行です。すべての部分更新行には主キーを含める必要があります。

• databaseName(String databaseName)

  database の名前です。省略した場合は現在の database がデフォルトで使用されます。

• collectionName(String collectionName)

  対象 collection の名前です。

• partitionName(String partitionName)

  対象 partition の名前です。

• partialUpdate(boolean partialUpdate)

  省略された非主キーフィールドを変更せずに保持するかどうかです。

• fieldOps(List<FieldPartialUpdateOp> fieldOps)

  フィールドレベルの操作です。ARRAY_APPEND と ARRAY_REMOVE は部分更新セマンティクスを意味します。

RETURNS:

UpsertResp

挿入または更新された entity の数を含みます。

EXCEPTIONS:

• MilvusClientException

  リクエストの検証、転送、またはサーバー実行が失敗した場合に発生します。正確な失敗理由については例外メッセージを確認してください。

Example

java

UpsertResp response = client.upsert(UpsertReq.builder()
    .collectionName("books")
    .data(rows)
    .fieldOps(fieldOps)
    .build());