Inserts an entity into the table, or updates it if an entity with the given primary key already exists.
Returns the primary key of the inserted/updated item.
// Insert a new entity
const aliceId = await upsert(userTable, { id: uuid(), name: "Alice", age: 23 });
// Update the entity we just created
await upsert(userTable, { id: aliceId, name: "Alice", age: 16 });| Parameter | Description |
|---|---|
table
|
The table created by createTable() .
|
item
| The item to insert/update. |
Consider upsertMany() if you want to upsert many items at once.