Configurar o Salesforce em uma atividade de cópia
Este artigo descreve como usar a atividade de cópia no pipeline de dados para copiar dados de e para o Salesforce.
Configuração suportada
Para a configuração de cada guia em atividade de cópia, vá para as seções a seguir, respectivamente.
- General (Geral)
- Source
- Destino
- Mapeamento
- Definições
Geral
Consulte as orientações de configurações gerais para configurar a guia Configurações gerais.
Origem
As propriedades a seguir são suportadas para o Salesforce na guia Origem de uma atividade de cópia.
As seguintes propriedades são necessárias:
- Conexão: selecione uma conexão do Salesforce na lista de conexões. Se não houver conexão, crie uma nova conexão do Salesforce selecionando Novo.
- Usar consulta: Selecione a partir da API de objeto, Relatório ou Consulta SOQL.
Se você selecionar API de objeto:
- API de objeto: especifique o nome do objeto Salesforce do qual recuperar dados. Selecione o nome na lista suspensa.
Se você selecionar Denunciar:
ID do relatório: especifique a ID do relatório do Salesforce do qual recuperar dados. Não é suportado no destino. Há limitações quando você usa relatórios.
Se você selecionar Consulta SOQL:
Consulta SOQL: use a consulta personalizada para ler dados. Você só pode usar a consulta SOQL (Salesforce Object Query Language) com limitações Noções básicas sobre consulta em massa da API 2.0. Se você não especificar a consulta SOQL, todos os dados do objeto Salesforce especificado em API de objeto ou ID de relatório serão recuperados.
Em Avançado, você pode especificar os seguintes campos:
- Incluir objetos excluídos: especifique se deseja consultar os registros existentes (não selecionados) ou consultar todos os registros, incluindo os excluídos (selecionados).
- Colunas adicionais: adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão é suportada para este último.
Destino
As propriedades a seguir são compatíveis com o Salesforce na guia Destino de uma atividade de cópia.
As seguintes propriedades são necessárias:
- Conexão: selecione uma conexão do Salesforce na lista de conexões. Se não houver conexão, crie uma nova conexão do Salesforce selecionando Novo.
- API de objeto: especifique o nome do objeto Salesforce no qual gravar dados. Selecione o nome na lista suspensa.
Em Avançado, você pode especificar os seguintes campos:
Comportamento de gravação: especifique o comportamento de gravação para a operação. Os valores permitidos são Insert e Upsert. Você pode escolher um comportamento na lista suspensa.
Se você selecionar Upsert:
Campo ID externo: o nome do campo ID externo para a operação de upsert. O campo especificado deve ser definido como Campo de ID Externo no objeto Salesforce. Ele não pode ter valores NULL nos dados de entrada correspondentes.
Ignorar valores nulos: especifique se os valores NULL devem ser ignorados dos dados de entrada durante uma operação de gravação.
- Quando for selecionado: Deixe os dados no objeto de destino inalterados quando você fizer uma operação de upsert ou atualização. Insira um valor padrão definido quando você fizer uma operação de inserção.
- Quando estiver desmarcado: atualize os dados no objeto de destino para NULL quando você fizer uma operação de upsert ou atualização. Insira um valor NULL quando você fizer uma operação de inserção.
Tamanho do lote de gravação: especifique a contagem de linhas de dados gravados no Salesforce em cada lote. Sugira definir esse valor de 10.000 a 200.000. Poucas linhas em cada lote reduzem o desempenho da cópia. Muitas linhas em cada lote podem causar o tempo limite da API.
Máximo de conexões simultâneas: o limite superior de conexões simultâneas estabelecido para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas.
Mapeamento
Para a configuração da guia Mapeamento , consulte Configurar seus mapeamentos na guia mapeamento.
Definições
Para Configuração da guia Configurações , vá para Configurar suas outras configurações na guia Configurações.
Resumo da tabela
As tabelas a seguir contêm mais informações sobre a atividade de cópia no Salesforce.
Fonte da informação
| Nome | Descrição | valor | Necessário | Propriedade de script JSON |
|---|---|---|---|---|
| Ligação | Sua conexão com o armazenamento de dados de origem. | <sua conexão com o Salesforce> | Sim | ligação |
| Tipo de ligação | O seu tipo de ligação. Selecione objetos do Salesforce. | SalesforceObject | Sim | / |
| Utilizar consulta | A maneira de ler dados do Salesforce. | • API de objeto • Relatório • Consulta SOQL |
Sim | / |
| Para API de objeto | ||||
| API de objeto | Especifique o nome do objeto Salesforce do qual recuperar dados. | < o nome do objeto > | Sim | objectApiName |
| Para relatório | ||||
| ID do relatório | A ID do relatório do Salesforce do qual recuperar dados. Não é suportado no destino. Há limitações quando você usa relatórios. | <o seu ID de relatório> | Sim | reportId |
| Para consulta SOQL | ||||
| Consulta SOQL | Use a consulta personalizada para ler dados. Você só pode usar a consulta SOQL (Salesforce Object Query Language) com limitações Noções básicas sobre consulta em massa da API 2.0. Se você não especificar a consulta SOQL, todos os dados do objeto Salesforce especificado em API de objeto ou ID de relatório serão recuperados. | < sua consulta SOQL > | Sim | query |
| Incluir objetos excluídos | Indica se os registros existentes devem ser consultados ou consultados todos os registros, incluindo os excluídos. | selecionado ou desmarcado (padrão) | Não | includeDeletedObjects: true ou false (padrão) |
| Colunas adicionais | Adicione colunas de dados adicionais para armazenar o caminho relativo ou o valor estático dos arquivos de origem. A expressão é suportada para este último. | • Nome • Valor |
Não | adicionaisColunas: • nome • valor |
Informações sobre o destino
| Nome | Descrição | valor | Necessário | Propriedade de script JSON |
|---|---|---|---|---|
| Ligação | Sua conexão com o armazenamento de dados de destino. | <sua conexão com o Salesforce> | Sim | ligação |
| API de objeto | Especifique o nome do objeto Salesforce no qual gravar dados. | < o nome do objeto > | Sim | objectApiName |
| Comportamento de escrita | O comportamento de gravação para a operação. Os valores permitidos são Insert e Upsert. Você pode escolher um comportamento na lista suspensa. | • Inserir • Upsert |
Não (o padrão é Inserir) | writeBehavior: insert Upsert |
| Campo ID externo | O nome do campo ID externo para a operação de upsert. O campo especificado deve ser definido como Campo de ID Externo no objeto Salesforce. Ele não pode ter valores NULL nos dados de entrada correspondentes. | < o seu campo de ID externo > | Sim para "Upsert" | externalIdFieldName |
| Ignorar valores nulos | Indica se os valores NULL devem ser ignorados dos dados de entrada durante uma operação de gravação. | selecionado ou desmarcado (padrão) | Não | ignoreNullValues: true ou false (padrão) |
| Tamanho do lote de gravação | A contagem de linhas de dados gravados no Salesforce em cada lote. Sugira definir esse valor de 10.000 a 200.000. Poucas linhas em cada lote reduzem o desempenho da cópia. Muitas linhas em cada lote podem causar o tempo limite da API. | <número de linhas> (inteiro) |
Não (o padrão é 100.000) | writeBatchSize |
| Máximo de conexões simultâneas | O limite superior de conexões simultâneas estabelecidas para o armazenamento de dados durante a execução da atividade. Especifique um valor somente quando quiser limitar conexões simultâneas. | <Máximo de conexões simultâneas> | Não | maxConcurrentConnections |
Limites da API em massa do Salesforce 2.0
Usamos o Salesforce Bulk API 2.0 para consultar e ingerir dados. Na API em massa 2.0, os lotes são criados para você automaticamente. Você pode enviar até 15.000 lotes por período de 24 horas. Se os lotes excederem o limite, você encontrará falhas.
Na API em massa 2.0, apenas os trabalhos de ingestão consomem lotes. Os trabalhos de consulta não. Para obter detalhes, consulte Como as solicitações são processadas no Guia do desenvolvedor da API em massa 2.0.
Para obter mais informações, consulte a seção Limites gerais em Limites do desenvolvedor do Salesforce.