Provide `upsertMany`/ `upsertFirst` operation in the client API

Problem

I’m frustrated when I want to do an upsert of a specific row, but I don’t have fields that are in <Model>WhereUniqueInput - I only have fields that, according to my business logic, will find a unique row. Currently, I have to do a findFirst to find the ID of the row, then either a create if it doesn’t exist or an update if it does.

Suggested solution

Add a CRUD query upsertMany. If the where clause finds at least one row, then an update is performed, else, a create is performed.

export type UserUpsertManyArgs = {
  select?: UserSelect | null
  include?: UserInclude | null
  where?: UserWhereInput | null
  create: UserCreateInput
  update: UserUpdateInput
}

I’m not sure what it should return, some possibilities are:

• the number of updated objects (probably 0 if a create is done); in which case don’t have the select or include parameters
• a list of the updated objects, or the object itself if a create is done
• the number of updated objects, or the object itself if a create is done

[MattGson]

I would suggest that upsertMany should be reserved for a function that can bulk upsert multiple rows at once so the name of this operation should probably be something like upsertFirst.

[Lizhooh]

Currently using sql instead

$prisma.$executeRawUnsafe`
  insert into user(id, name, list) values
    ('abc1', 'xxxx', '["a","b"]'),
    ('abc2', 'abc2', '[1,2]')
  on duplicate key update
    name = values(name),
    list = values(list)
`