DataWorks:Fonte de dados do Salesforce

Parâmetro

Obrigatório

Descrição

Padrão

source

Sim

Nome da fonte de dados. No modo script, adicione uma fonte de dados. O valor deste parâmetro deve corresponder exatamente ao nome da fonte de dados adicionada.

Nenhum

serviceType

Não

Modo de sincronização. Valores válidos:

• sobject: Consulta um objeto do Salesforce.

• query: Consulta dados por meio de uma instrução SOQL.

• bulk1: Consulta um objeto do Salesforce usando a Bulk API 1.0.

• bulk2: Consulta um objeto do Salesforce usando a Bulk API 2.0.

  Importante

  • Os modos bulk1 e bulk2 não aceitam tipos de dados compostos, como address e geolocation.

  • O modo bulk2 não aceita tarefas distribuídas.

  • O desempenho pode variar entre bulk1 e bulk2. Teste ambos os modos em seu objeto do Salesforce para selecionar o mais adequado.

sobject

table

Sim

Objeto do Salesforce, semelhante a um nome de tabela, como Account, Case ou Group. Obrigatório quando serviceType for sobject, bulk1 ou bulk2.

Nenhum

beginDateTime

Não

• Horários inicial e final para extração de dados. Usado quando serviceType estiver definido como sobject, bulk1 ou bulk2.

• Filtra dados com base na última modificação do objeto do Salesforce. O campo de última modificação é identificado automaticamente pela seguinte ordem de prioridade: SystemModstamp > LastModifiedDate > CreatedDate.

• O intervalo de tempo é fechado à esquerda e aberto à direita.

• String de tempo no formato yyyymmddhhmmss. Combine este parâmetro com parâmetros de agendamento para executar extrações incrementais.

Nenhum

endDateTime

Não

Nenhum

splitPk

Não

• Chave de fragmentação. Aplicável quando serviceType estiver definido como sobject.

• Define um campo para atuar como chave de fragmentação, permitindo tarefas concorrentes e melhorando a eficiência da sincronização de dados.

• Somente os tipos de dados datetime, int e long são aceitos. O uso de outros tipos causará falha na tarefa.

Nenhum

blockCompoundColumn

Não

Define o comportamento ao encontrar um tipo de dado composto. Usado quando serviceType for bulk1 ou bulk2. Valores válidos:

• true: A tarefa falha. Remova o mapeamento da coluna referente ao tipo de dado composto e execute a tarefa novamente.

• false: O tipo de dado composto é lido como NULL.

true

bulkQueryJobTimeoutSeconds

Não

• Tempo limite, em segundos, para a preparação de dados em lote. Aplicável quando serviceType for bulk1 ou bulk2.

• O servidor do Salesforce prepara os dados em lote antes do início da leitura. A tarefa falhará se essa preparação exceder o tempo limite especificado.

86400

batchSize

Não

• Tamanho do lote, correspondente ao número de registros baixados por lote. Usado quando serviceType for bulk1 ou bulk2.

• Para obter desempenho ideal, defina este valor ligeiramente acima do tamanho de lote determinado pela tarefa de preparação de dados do Salesforce.

• Como os dados são transmitidos em fluxo, aumentar este valor não eleva o uso de memória.

• Trata-se de um parâmetro avançado, sem suporte no modo assistente.

300000

where

Não

• Condição de filtro. Usado quando serviceType for sobject, bulk1 ou bulk2.

• Em cenários reais, filtre os dados conforme necessário. Por exemplo, especifique Name != 'Aliyun'.

• Se este parâmetro estiver vazio, o sistema sincronizará todos os dados.

• O valor deve ser uma cláusula WHERE SOQL válida. Por exemplo, limit 10 é inválido, pois LIMIT é uma cláusula separada no SOQL.

Nenhum

query

Não

• Instrução de consulta. Aplicável quando serviceType for query.

• Quando o parâmetro where for insuficiente, use query para fornecer uma instrução de consulta SOQL completa. Se especificado, este parâmetro substitui os parâmetros table, column, beginDateTime, endDateTime, where e splitPk. Exemplo: select Id, Name, IsDeleted from Account where Name!='Aliyun'.

• Parâmetro avançado, sem suporte no modo assistente.

Nenhum

queryAll

Não

• Define se registros excluídos devem ser incluídos na consulta. Usado quando serviceType for sobject ou query.

• Se definido como true, os resultados incluirão registros excluídos, identificáveis pelo campo IsDeleted.

false

column

Sim

Colunas a serem sincronizadas. Especifique as colunas como um array JSON.

• Aceita poda de colunas, permitindo selecionar um subconjunto de colunas para exportação.

• Permite reordenar colunas, possibilitando exportá-las em uma ordem diferente do esquema da tabela.

• É possível configurar constantes. Exemplo:

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

  Nota

  • Id e Name são nomes de colunas regulares.

  • '123' é uma constante inteira. Note que deve estar entre aspas simples.

  • 'abc' é uma constante de string. Note que deve estar entre aspas simples.

• Especifique explicitamente todas as colunas a sincronizar como um array não vazio.

Nenhum

connectTimeoutSeconds

Não

• Tempo limite, em segundos, para estabelecer uma conexão HTTP. A tarefa falhará se a conexão não for estabelecida dentro desse período.

• Parâmetro avançado, sem suporte no modo assistente.

30

socketTimeoutSeconds

Não

• Tempo limite de resposta HTTP, em segundos. A tarefa falhará se o intervalo entre o recebimento de pacotes de dados consecutivos exceder este valor.

• Parâmetro avançado, sem suporte no modo assistente.

600

retryIntervalSeconds

Não

• Intervalo entre tentativas, em segundos.

• Parâmetro avançado, sem suporte no modo assistente.

60

retryTimes

Não

• Número de tentativas de repetição.

• Parâmetro avançado, sem suporte no modo assistente.

3