DataWorks:Salesforce data source

Parâmetro

Obrigatório

Descrição

Padrão

datasource

Sim

O nome da fonte de dados. No modo de script, é possível adicionar uma fonte de dados. O valor deste parâmetro deve corresponder ao nome da fonte de dados adicionada.

Nenhum

serviceType

Não

O modo de sincronização. Valores válidos:

• sobject: Consulta um objeto do Salesforce.

• query: Consulta dados usando uma instrução SOQL.

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

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

  Importante

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

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

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

sobject

table

Sim

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

Nenhum

beginDateTime

Não

• Os horários de início e término para extração de dados. Este parâmetro é aplicável quando serviceType está definido como sobject, bulk1 ou bulk2.

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

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

• Uma string de tempo no formato yyyymmddhhmmss. Use este parâmetro junto com parâmetros de agendamento para realizar extração incremental.

Nenhum

endDateTime

Não

Nenhum

splitPk

Não

• A chave de fragmentação. Este parâmetro é aplicável quando serviceType está definido como sobject.

• Especifique um campo para usar como chave de fragmentação na partição de dados. Isso ativa tarefas concorrentes e melhora a eficiência da sincronização de dados.

• Somente os tipos de dados datetime, int e long são suportados. O uso de outros tipos faz com que a tarefa falhe.

Nenhum

blockCompoundColumn

Não

Define o comportamento quando um tipo de dado composto é encontrado. Este parâmetro é aplicável quando serviceType está definido como bulk1 ou bulk2. Valores válidos:

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

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

true

bulkQueryJobTimeoutSeconds

Não

• O período de timeout para a preparação de dados em lote, em segundos. Este parâmetro é aplicável quando serviceType está definido como bulk1 ou bulk2.

• O servidor do Salesforce prepara os dados em lote antes do início da leitura. A tarefa falha se essa preparação ultrapassar o timeout especificado.

86400

batchSize

Não

• O tamanho do lote, ou seja, o número de registros a baixar por lote. Este parâmetro é aplicável quando serviceType está definido como bulk1 ou bulk2.

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

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

• Este é um parâmetro avançado e não tem suporte no modo assistente.

300000

where

Não

• A condição de filtro. Este parâmetro é aplicável quando serviceType está definido como sobject, bulk1 ou bulk2.

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

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

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

Nenhum

query

Não

• A instrução de consulta. Este parâmetro é aplicável quando serviceType está definido como query.

• Quando o parâmetro where for insuficiente, use query para fornecer uma instrução 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'.

• Este é um parâmetro avançado e não tem suporte no modo assistente.

Nenhum

queryAll

Não

• Indica se os registros excluídos devem ser incluídos na consulta. Este parâmetro é aplicável quando serviceType está definido como sobject ou query.

• Quando definido como true, os resultados incluem registros excluídos, identificáveis pelo campo IsDeleted.

false

column

Sim

As colunas a sincronizar. Especifique-as como um array JSON.

• Suporta remoção de colunas, permitindo selecionar um subconjunto de colunas para exportar.

• Suporta reordenação de colunas, permitindo exportá-las em uma ordem diferente do esquema da tabela.

• Configure constantes conforme o 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. Observe que deve ser colocada entre aspas simples.

  • 'abc' é uma constante de string. Observe que deve ser colocada entre aspas simples.

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

Nenhum

connectTimeoutSeconds

Não

• O timeout para estabelecer uma conexão HTTP, em segundos. A tarefa falha se a conexão não for estabelecida dentro desse prazo.

• Este é um parâmetro avançado e não tem suporte no modo assistente.

30

socketTimeoutSeconds

Não

• O timeout de resposta HTTP, em segundos. A tarefa falha se o intervalo entre pacotes de dados consecutivos recebidos ultrapassar este valor.

• Este é um parâmetro avançado e não tem suporte no modo assistente.

600

retryIntervalSeconds

Não

• O intervalo entre tentativas de repetição, em segundos.

• Este é um parâmetro avançado e não tem suporte no modo assistente.

60

retryTimes

Não

• O número de tentativas de repetição.

• Este é um parâmetro avançado e não tem suporte no modo assistente.

3