Configuración de Salesforce en una actividad de copia
En este artículo se describe cómo usar la actividad de copia en la canalización de datos para copiar datos desde y hacia Salesforce.
Configuración admitida
Para la configuración de cada pestaña en la actividad de copia, vaya a las secciones siguientes respectivamente.
General
Consulte las instruccionesgenerales para configurar la pestaña de parámetros General.
Source
Las siguientes propiedades son compatibles con Salesforce en la pestaña Origen de una actividad de copia.
Las siguientes propiedades son obligatorias:
- Conexión: seleccione una conexión de Salesforce en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de Salesforce seleccionando Nuevo.
- Usar consulta: seleccione la API de objeto, el informe o la consulta SOQL.
Si selecciona API de objeto:
- API de objeto: especifica el nombre del objeto de Salesforce desde el que se van a recuperar los datos. Seleccione el nombre en la lista desplegable.
Si selecciona Informe:
Id. del informe: especifica el id. del informe de Salesforce desde el que se van a recuperar los datos. No se admite en el destino. Hay limitaciones cuando se usan informes.
Si se selecciona Consulta SOQL:
Consulta SOQL: utilice la consulta personalizada para leer los datos. Solo puede usar una consulta de Salesforce Object Query Language (SOQL) con limitaciones Entender la consulta API Bulk 2.0. Si no se especifica la consulta SOQL, se recuperarán todos los datos del objeto de Salesforce especificado en API de objeto o id. del informe en el conjunto de datos.
En Avanzado, puede especificar los campos siguientes:
- Incluir objetos eliminados: especifica si desea consultar los registros existentes (no seleccionados) o consultar todos los registros, incluidos los eliminados (seleccionados).
- Columnas adicionales: añada columnas de datos adicionales para almacenar la ruta relativa o el valor estático de los archivos de origen. La expresión se admite para este último.
Destino
Las siguientes propiedades son compatibles con Salesforce en la pestaña Destino de una actividad de copia.
Las siguientes propiedades son obligatorias:
- Conexión: seleccione una conexión de Salesforce en la lista de conexiones. Si no existe ninguna conexión, cree una nueva conexión de Salesforce seleccionando Nuevo.
- API de objeto: especifica el nombre del objeto de Salesforce al que se van a escribir los datos. Seleccione el nombre en la lista desplegable.
En Avanzado, puede especificar los campos siguientes:
Comportamiento de escritura: especifica el comportamiento de escritura para la operación. Los valores permitidos son: Insert y Upsert. Puedes elegir un comportamiento en la lista desplegable.
Si selecciona Actualizar/insertar (upsert):
campo de identificador externo: el nombre del campo de identificador externo para la operación de upsert. El campo especificado debe definirse como Campo de identificador externo en el objeto de Salesforce. No puede tener valores NULL en los datos de entrada correspondientes.
Ignorar valores null: especifica si se omiten los valores NULL de los datos de entrada durante una operación de escritura.
- Cuando esta seleccionada: deja los datos del objeto de destino sin cambiar cuando realice una operación actualizar/insertar (upsert), o actualizar. Inserta un valor predeterminado definido al realizar una operación insert.
- Cuando no está seleccionada: actualiza los datos del objeto de destino a NULL cuando realice una operación actualizar/insertar (upsert), o actualizar. Inserta un valor NULL al realizar una operación insert.
Escribir tamaño del lote: especificar el número de filas de datos escritos en Salesforce en cada lote. Sugiera establecer este valor de 10 000 a 200 000. Un número escaso de filas en cada lote reduce el rendimiento de la copia. Demasiadas filas de cada lote pueden provocar un tiempo de espera de la API.
Máximo de conexiones simultáneas: límite superior de conexiones simultáneas establecidas con el almacén de datos durante la ejecución de la actividad. Especifique un valor solo cuando quiera limitar las conexiones simultáneas.
Asignación
Para configurar la pestaña Asignación, consulte Configurar las asignaciones en la pestaña Asignación.
Configuración
Para la configuración de la pestañaConfiguración, vaya a Configurar los otros parámetros en la ficha Configuración .
Resumen de tabla
Las tablas siguientes contienen más información sobre la actividad de copia en Salesforce.
Información de origen
| Nombre | Descripción | Value | Obligatorio | Propiedad de script JSON |
|---|---|---|---|---|
| Connection | La conexión al almacén de datos de origen. | <su conexión de Salesforce> | Sí | conexión |
| Tipo de conexión | El tipo de conexión. Seleccione Objetos de Salesforce. | SalesforceObject | Sí | / |
| Usar consulta | La manera de leer datos de Salesforce. | • API de objeto • Informe • Consulta SOQL |
Sí | / |
| Para API de objeto | ||||
| API de objeto | Especifica el nombre del objeto de Salesforce desde el que se van a recuperar los datos. | < su nombre del objeto > | Sí | objectApiName |
| Para informe | ||||
| Id. del informe | El id. del informe de Salesforce desde el que se van a recuperar los datos. No se admite en el destino. Hay limitaciones cuando se usan informes. | <su id. del informe> | Sí | reportId |
| Para consulta SOQL | ||||
| Consulta SOQL | Utilice la consulta personalizada para leer los datos. Solo puede usar una consulta de Salesforce Object Query Language (SOQL) con limitaciones Entender la consulta API Bulk 2.0. Si no se especifica la consulta SOQL, se recuperarán todos los datos del objeto de Salesforce especificado en API de objeto o id. del informe en el conjunto de datos. | < su consulta SOQL > | Sí | query |
| Incluir objetos eliminados | Indica si se van a consultar los registros existentes o todos, incluso los que se eliminaron. | seleccionado o no seleccionado (valor predeterminado) | No | includeDeletedObjects: true o false (valor predeterminado) |
| Columnas adicionales | Agregue columnas de datos adicionales para almacenar la ruta de acceso relativa o el valor estático de los archivos de origen. La expresión se admite para este último. | • Name • Valor |
No | additionalColumns: • nombre • valor |
Información de destino
| Nombre | Descripción | Value | Obligatorio | Propiedad de script JSON |
|---|---|---|---|---|
| Connection | La conexión al almacén de datos de destino. | <su conexión de Salesforce> | Sí | connection |
| API de objeto | Especifica el nombre del objeto de Salesforce al que se van a escribir los datos. | < su nombre del objeto > | Sí | objectApiName |
| Comportamiento de escritura | El comportamiento de escritura de la operación. Los valores permitidos son: Insert y Upsert. Puedes elegir un comportamiento en la lista desplegable. | • Insertar • Upsert |
No (el valor predeterminado es Insert) | writeBehavior: insert upsert |
| Campo Id. externo | El nombre del campo de identificador externo para la operación de upsert. El campo especificado debe definirse como Campo de identificador externo en el objeto de Salesforce. No puede tener valores NULL en los datos de entrada correspondientes. | < su campo de identificador externo > | Sí para "Upsert" | externalIdFieldName |
| Ignorar valores null | Indica si se omiten los valores NULL de los datos de entrada durante la operación de escritura. | seleccionado o no seleccionado (valor predeterminado) | No | ignoreNullValues: true o false (valor predeterminado) |
| Tamaño del lote de escritura | El recuento de filas de datos escritos en Salesforce en cada lote. Sugiera establecer este valor de 10 000 a 200 000. Un número escaso de filas en cada lote reduce el rendimiento de la copia. Demasiadas filas de cada lote pueden provocar un tiempo de espera de la API. | <número de filas > (entero) |
No (el valor predeterminado es 100 000) | writeBatchSize |
| Número máximo de conexiones simultáneas | Número máximo de conexiones simultáneas establecidas en el almacén de datos durante la ejecución de la actividad. Especifique un valor solo cuando quiera limitar las conexiones simultáneas. | < número máximo de conexiones simultáneas > | No | maxConcurrentConnections |
Límites de la API Salesforce Bulk 2.0
Usamos la API Salesforce Bulk 2.0 para consultar e ingerir datos. En la API Bulk 2.0, los lotes se crean automáticamente. Puede enviar hasta 15 000 lotes por periodo gradual de 24 horas. Si los lotes superan el límite, se producen errores.
En la API Bulk 2.0, solo los trabajos de ingesta consumen lotes. Los trabajos de consulta no. Para obtener más información, consulte Cómo se procesan las solicitudes en la Guía para desarrolladores de API Bulk 2.0.
Para obtener más información, consulte la sección Límites generales en Límites de desarrollador de Salesforce.