MERGE combina en una sola instrucción las actualizaciones cuando hay coincidencia y las inserciones cuando no la hay. La clave de destino define qué fila se considera la misma entidad. Debes tener clara esa clave antes de decidir qué valores del origen deben reemplazar los del destino.
Un flujo de actualizaciones puede contener varias versiones de un cliente. BigQuery genera un error cuando varias filas del origen coinciden con una fila de destino para una actualización o eliminación. Reduce primero el origen a una fila por clave. Un patrón habitual es usar ROW_NUMBER con ordenación por revisión o marca de tiempo; añade un criterio de desempate estable si los valores de ordenación pueden coincidir.
Los datos de actualización proporcionados tienen una revisión anterior y otra más reciente para cada cliente modificado. Elige la revisión más reciente y, después, actualízala o insértala en una instantánea pequeña. Ejecuta la misma operación dos veces al hacer pruebas: la segunda ejecución debe dejar las mismas filas y valores. La idempotencia significa que un reintento no crea clientes duplicados ni repite un cambio aditivo.
Elige la versión actual del origen antes de buscar su coincidencia en la instantánea.