Introducción a las transferencias de Salesforce

Puedes cargar datos de tu Salesforce Sales Cloud a BigQuery con el Servicio de transferencia de datos de BigQuery para Salesforce. Con el Servicio de transferencia de datos de BigQuery, puedes programar trabajos de transferencia recurrentes que agreguen tus datos más recientes de Salesforce Sales Cloud a BigQuery.

Para obtener información sobre cómo programar una transferencia de Salesforce, consulta Carga datos de Salesforce en BigQuery.

Opciones de transferencia de datos

En las siguientes secciones, se proporciona más información sobre las opciones de transferencia de datos cuando configuras una transferencia de datos de Salesforce.

Transferencias completas o incrementales

Para especificar cómo se cargan los datos en BigQuery, selecciona la preferencia de escritura Completa o Incremental en la configuración de transferencia cuando configures una transferencia de Salesforce.

Puedes configurar una transferencia de datos completa para transferir todos los datos de tus conjuntos de datos de Salesforce con cada transferencia de datos.

Como alternativa, puedes configurar una transferencia de datos incremental para transferir solo los datos que se cambiaron desde la última transferencia de datos, en lugar de cargar todo el conjunto de datos con cada transferencia de datos. Si seleccionas Incremental para tu transferencia de datos, debes especificar los modos de escritura Append o Upsert para definir cómo se escriben los datos en BigQuery durante una transferencia de datos incremental. En las siguientes secciones, se describen los modos de escritura disponibles.

Modo de escritura Append

El modo de escritura Append solo inserta filas nuevas en tu tabla de destino. Esta opción agrega estrictamente los datos transferidos sin verificar si existen registros, por lo que este modo puede causar duplicación de datos en la tabla de destino.

Cuando seleccionas el modo Append, debes seleccionar una columna de marca de agua. Se requiere una columna de marca de agua para que el conector de Salesforce realice un seguimiento de los cambios en la tabla de origen.

Selecciona una columna de marca de agua que solo se actualice cuando se creó el registro y que no cambie con las actualizaciones posteriores. Por ejemplo, la columna CreatedDate.

Modo de escritura Upsert

El modo de escritura Upsert actualiza una fila o inserta una fila nueva en tu tabla de destino verificando una clave primaria. Puedes especificar una clave primaria para permitir que el conector de Salesforce determine qué cambios son necesarios para mantener actualizada tu tabla de destino con tu tabla de origen. Si la clave primaria especificada está presente en la tabla de BigQuery de destino durante una transferencia de datos, el conector de Salesforce actualiza esa fila con datos nuevos de la tabla de origen. Si no hay una clave primaria durante una transferencia de datos, el conector de Salesforce inserta una fila nueva.

Cuando seleccionas el modo Upsert, debes seleccionar una columna de marca de agua y una clave primaria:

  • Se requiere una columna de marca de agua para que el conector de Salesforce realice un seguimiento de los cambios en la tabla de origen.

    Selecciona una columna de marca de agua que se actualice cada vez que se modifique una fila. Te recomendamos que uses la columna SystemModstamp o LastModifiedDate.

  • La clave primaria puede ser una o más columnas de tu tabla que son necesarias para que el conector de Salesforce determine si necesita insertar o actualizar una fila.

    Selecciona columnas que contengan valores no nulos que sean únicos en todas las filas de la tabla. Recomendamos columnas que incluyan identificadores generados por el sistema, códigos de referencia únicos (por ejemplo, IDs de incremento automático) o IDs de secuencia inmutables basados en el tiempo.

    Para evitar la posible pérdida o corrupción de datos, las columnas de clave primaria que selecciones deben tener valores únicos. Si tienes dudas sobre la singularidad de la columna de clave primaria elegida, te recomendamos que uses el modo de escritura Append.

Comportamiento de la transferencia incremental

Cuando realizas cambios en el esquema de la tabla en tu fuente de datos, las transferencias de datos incrementales de esas tablas se reflejan en BigQuery de las siguientes maneras:

Cambios en la fuente de datos Comportamiento de la transferencia incremental
Agregar una columna nueva Se agrega una columna nueva a la tabla de BigQuery de destino. Los registros anteriores de esta columna tendrán valores nulos.
Borrar una columna La columna borrada permanece en la tabla de BigQuery de destino. Las entradas nuevas en esta columna borrada se propagan con valores nulos.
Cambiar el tipo de datos en una columna El conector solo admite conversiones de tipos de datos compatibles con la instrucción DDL ALTER COLUMN. Cualquier otra conversión de tipo de datos hace que falle la transferencia de datos.

Si tienes algún problema, te recomendamos que crees una nueva configuración de transferencia.
Cambiar el nombre de una columna La columna original permanece en la tabla de BigQuery de destino tal como está, mientras que se agrega una columna nueva a la tabla de destino con el nombre actualizado.

Asignación de tipos de datos

En la siguiente tabla, se asignan los tipos de datos de Salesforce a los tipos de datos de BigQuery correspondientes:

Tipo de datos de Salesforce Tipo de datos de BigQuery
_bool BOOLEAN
_int INTEGER
_long INTEGER
_double FLOAT
currency FLOAT
percent FLOAT
geolocation (latitude) FLOAT
geolocation (longitude) FLOAT
date DATE
datetime TIMESTAMP
time TIME
picklist STRING
multipicklist STRING
combobox STRING
reference STRING
base64 STRING
textarea STRING
phone STRING
id STRING
url STRING
email STRING
encryptedstring STRING
datacategorygroupreference STRING
location STRING
address STRING
anyType STRING

Precios

Para obtener información sobre los precios de las transferencias de Salesforce, consulta Precios del Servicio de transferencia de datos.

¿Qué sigue?