DataWorks:Origen de datos de Salesforce

Parámetro

Obligatorio

Descripción

Predeterminado

datasource

Sí

Nombre del origen de datos. En el modo de script, puede agregar un origen de datos. El valor de este parámetro debe coincidir con el nombre del origen de datos agregado.

Ninguna

serviceType

No

Modo de sincronización. Valores válidos:

• sobject: consulta un objeto de Salesforce.

• query: consulta datos mediante una instrucción SOQL.

• bulk1: consulta un objeto de Salesforce mediante Bulk API 1.0.

• bulk2: consulta un objeto de Salesforce mediante Bulk API 2.0.

  Importante

  • Los modos bulk1 y bulk2 no admiten tipos de datos compuestos, como address y geolocation.

  • El modo bulk2 no admite tareas distribuidas.

  • El rendimiento puede variar entre bulk1 y bulk2. Pruebe ambos modos en su objeto de Salesforce para seleccionar el óptimo.

sobject

table

Sí

Objeto de Salesforce, similar a un nombre de tabla, como Account, Case o Group. Es obligatorio si serviceType es sobject, bulk1 o bulk2.

Ninguna

beginDateTime

No

• Horas de inicio y fin para la extracción de datos. Este parámetro se usa cuando serviceType se establece en sobject, bulk1 o bulk2.

• Filtra los datos según la última hora de modificación del objeto de Salesforce. El campo de última hora de modificación se identifica automáticamente con el siguiente orden de prioridad: SystemModstamp > LastModifiedDate > CreatedDate.

• El intervalo de tiempo es cerrado por la izquierda y abierto por la derecha.

• Cadena de tiempo con el formato yyyymmddhhmmss. Puede usar este parámetro con parámetros de programación para ejecutar una extracción incremental.

Ninguna

endDateTime

No

Ninguna

splitPk

No

• Clave de fragmentación. Este parámetro se usa cuando serviceType se establece en sobject.

• Especifica un campo para usarlo como clave de fragmentación durante la división de datos. Esto permite ejecutar tareas simultáneas y mejora la eficiencia de la sincronización de datos.

• Solo se admiten los tipos de datos datetime, int y long. Si utiliza otros tipos, el trabajo fallará.

Ninguna

blockCompoundColumn

No

Especifica el comportamiento cuando se encuentra un tipo de dato compuesto. Este parámetro se usa cuando serviceType se establece en bulk1 o bulk2. Valores válidos:

• true: el trabajo falla. Debe eliminar la asignación de columnas del tipo de dato compuesto y volver a ejecutar el trabajo.

• false: el tipo de dato compuesto se lee como NULL.

true

bulkQueryJobTimeoutSeconds

No

• Tiempo de espera para la preparación de datos por lotes, en segundos. Este parámetro se usa cuando serviceType se establece en bulk1 o bulk2.

• El servidor de Salesforce prepara los datos por lotes antes de que comience la lectura. El trabajo falla si esta preparación supera el tiempo de espera especificado.

86400

batchSize

No

• Tamaño del lote, es decir, la cantidad de registros que se descargan por lote. Este parámetro se usa cuando serviceType se establece en bulk1 o bulk2.

• Para obtener un rendimiento óptimo, establezca este valor ligeramente por encima del tamaño de lote determinado por la tarea de preparación de datos de Salesforce.

• Como los datos se transmiten en flujo, aumentar este valor no incrementa el uso de memoria.

• Este es un parámetro avanzado y no se admite en el modo de asistente.

300000

where

No

• Condición de filtro. Este parámetro se usa cuando serviceType se establece en sobject, bulk1 o bulk2.

• En escenarios empresariales reales, puede filtrar datos. Por ejemplo, puede especificar Name != 'Aliyun'.

• Si este parámetro está vacío, el sistema sincroniza todos los datos.

• El valor debe ser una cláusula WHERE de SOQL válida. Por ejemplo, limit 10 no es válido porque LIMIT es una cláusula independiente en SOQL.

Ninguna

query

No

• Instrucción de consulta. Este parámetro se usa cuando serviceType se establece en query.

• Cuando el parámetro where resulta insuficiente, use query para proporcionar una instrucción de consulta SOQL completa. Si se especifica, este parámetro anula los parámetros table, column, beginDateTime, endDateTime, where y splitPk. Ejemplo: select Id, Name, IsDeleted from Account where Name!='Aliyun'.

• Este es un parámetro avanzado y no se admite en el modo de asistente.

Ninguna

queryAll

No

• Indica si se incluyen los registros eliminados en la consulta. Este parámetro se usa cuando serviceType se establece en sobject o query.

• Si se establece en true, los resultados incluyen los registros eliminados, los cuales se identifican mediante el campo IsDeleted.

false

column

Sí

Columnas que desea sincronizar. Especifique las columnas como una matriz JSON.

• Admite la reducción de columnas, lo que le permite seleccionar un subconjunto de columnas para exportar.

• Admite la reordenación de columnas, lo que le permite exportarlas en un orden distinto al esquema de la tabla.

• Puede configurar constantes. Ejemplo:

  [
    {
      "name": "Id",
      "type": "STRING"
    },
    {
      "name": "Name",
      "type": "STRING"
    },
    {
      "name": "'123'",
      "type": "LONG"
    },
    {
      "name": "'abc'",
      "type": "STRING"
    }
  ]

  Nota

  • Id y Name son nombres de columna normales.

  • '123' es una constante entera. Tenga en cuenta que debe encerrarse entre comillas simples.

  • 'abc' es una constante de cadena. Tenga en cuenta que debe encerrarse entre comillas simples.

• Debe especificar explícitamente todas las columnas que desea sincronizar como una matriz no vacía.

Ninguna

connectTimeoutSeconds

No

• Tiempo de espera para establecer una conexión HTTP, en segundos. El trabajo falla si la conexión no se establece dentro de este tiempo.

• Este es un parámetro avanzado y no se admite en el modo de asistente.

30

socketTimeoutSeconds

No

• Tiempo de espera de respuesta HTTP, en segundos. El trabajo falla si el tiempo transcurrido entre la recepción de paquetes de datos consecutivos supera este valor.

• Este es un parámetro avanzado y no se admite en el modo de asistente.

600

retryIntervalSeconds

No

• Intervalo entre reintentos, en segundos.

• Este es un parámetro avanzado y no se admite en el modo de asistente.

60

retryTimes

No

• Número de intentos de reintento.

• Este es un parámetro avanzado y no se admite en el modo de asistente.

3