MERGE combina, em uma única instrução, atualizações quando há correspondência e inserções quando não há. A chave de destino define qual linha é considerada a mesma entidade. Essa chave precisa estar clara antes de você decidir quais valores da origem devem substituir os do destino.
Um feed de atualizações pode conter várias versões de um mesmo cliente. O BigQuery gera um erro quando várias linhas da origem correspondem a uma linha de destino em uma atualização ou exclusão. Reduza primeiro a origem a uma linha por chave. Um padrão comum é ROW_NUMBER ordenado por revisão ou carimbo de data/hora; adicione um critério de desempate estável se os valores de ordenação puderem empatar.
Os dados de atualização fornecidos têm uma revisão mais antiga e outra mais recente para cada cliente alterado. Escolha a revisão mais recente e depois faça o upsert dela em um snapshot pequeno. Execute o mesmo upsert duas vezes ao testar: a segunda execução deve deixar as mesmas linhas e os mesmos valores. Idempotência significa que uma nova tentativa não cria clientes duplicados nem repete uma alteração aditiva.
Escolha a versão atual da origem antes de procurar a correspondência dela no snapshot.