Caso de uso: consultas SOQL para a origem do Salesforce

Nesta página, mostramos como usar consultas de relação SOQL ao usar a fonte do Salesforce no Cloud Data Fusion.

A origem do Salesforce permite que você se conecte facilmente ao Salesforce e carregue grandes quantidades de dados no Google Cloud. Para simplificar o carregamento dos dados, use as consultas de relação SOQL para recuperar registros e reduzir o número de chamadas de API no Salesforce.

Antes de começar

  1. Implante e configure as propriedades da origem do Salesforce no Cloud Data Fusion. Para mais informações, consulte Origem em lote do Salesforce.

  2. No nó do Salesforce no pipeline, clique em Propriedades. A página de propriedades do plug-in do Salesforce será aberta.

As seções a seguir descrevem como configurar o campo consulta SOQL na página Propriedades.

Cenário 1: consulta de relação com chave polimórfica e limites

O exemplo de consulta de relação a seguir tem uma chave polimórfica e um limite:

SELECT Id, Owner.Name FROM Task WHERE Owner.FirstName like 'B%' Limit 100

Esta consulta busca dados de um SObject Task relacionado a Owner. Ele lê dados dos campos selecionados no SObject Task. Ele tem uma cláusula WHERE e um marcador, ao qual você pode atribuir um valor adequado.

Ela permite acessar os campos obrigatórios usando uma variável de marcador de posição. Isso limita a quantidade de registros buscados para 100.

Cenário 2: consulta de relacionamento com pai e mãe com objetos personalizados

A consulta a seguir busca dados de um objeto personalizado com uma relação filho-pai:

SELECT Email,newsales__c,Account__r.OwnerId FROM lead WHERE Account__r.Lead Source LIKE 'C%

Essa consulta usa uma cláusula SELECT para buscar dados do SObject Lead no Salesforce com o campo de referência, Account__r.OwnerId.

A consulta retorna dados dos campos selecionados no SObject Lead e os campos relacionais da pesquisa vinculada ao objeto pai Account. É possível consultar vários campos de dados de um cluster de SObjects relacionais.

Cenário 3: consulta de relacionamento com cláusulas WHERE e OFFSET

A consulta a seguir busca dados de vários SObjects: Account e Contacts, relacionados a um tipo Industry específico e a uma cláusula OFFSET:

SELECT Name, (SELECT LastName FROM Contacts WHERE CreatedBy.Alias = 'x') FROM Account WHERE Industry = 'media'
offset 4

A cláusula OFFSET permite retornar resultados em várias páginas, essa é uma maneira eficiente de lidar com grandes conjuntos de resultados.

A seguir