milvus-logo
LFAI
< Docs
  • Go

Upsert()

This method upserts entities into Milvus. An upsert is a data-level operation that will overwrite an existing entity if a specified field already exists in a collection, and insert a new entity if the specified value doesn’t already exist.

Invocation

client.Upsert(ctx, collName, partName, data)

Parameters

ParameterDescriptionType
ctxContext to control API invocation processcontext.Context
collNameName of the collection to upsert data into.String
partNameName of the partition to upsert data into.
Data will be upserted into default partition if it is left empty.
String
dataData to upsert in each field.
Data must be converted into columns for different fields.
Variadic slice of entity.Column

Return

Entity.Column that represents the IDs of the upserted data.

Errors

err: error in the process (if any). Possible errors are listed below:

  • ErrClientNotReady, error that the client is not connected.

  • ErrCollectionNotExists, error that the collection with the specified name does not exist.

  • error that the specified field is not valid.

  • error that API invocation failed.

Example

bookIDs := make([]int64, 0, 2000)
wordCounts := make([]int64, 0, 2000)
bookIntros := make([][]float32, 0, 2000)
for i := 0; i < 2000; i++ {
    bookIDs = append(bookIDs, int64(i))
    wordCounts = append(wordCounts, int64(i+10000))
    v := make([]float32, 0, 2)
    for j := 0; j < 2; j++ {
        v = append(v, rand.Float32())
    }
    bookIntros = append(bookIntros, v)
}
idColumn := entity.NewColumnInt64("book_id", bookIDs)
wordColumn := entity.NewColumnInt64("word_count", wordCounts)
introColumn := entity.NewColumnFloatVector("book_intro", 2, bookIntros)
_, err = milvusClient.Upsert(
    context.Background(),
    "book",
    "",
    idColumn,
    wordColumn,
    introColumn,
)
if err != nil {
    log.Fatal("failed to upsert data:", err.Error())
}

Try Managed Milvus for Free

Zilliz Cloud is hassle-free, powered by Milvus and 10x faster.

Get Started
Feedback

Was this page helpful?