Caso de uso: consultas SOQL para a fonte do Salesforce

Esta página mostra como usar consultas de relacionamento SOQL ao usar a fonte do Salesforce no Cloud Data Fusion.

A origem do Salesforce permite que você se conecte ao Salesforce e carregue grandes quantidades de dados em Google Cloud. Para simplificar o carregamento dos dados, use consultas de relacionamento SOQL para extrair 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 de 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 relacionamento com chave polimórfica e limites

O exemplo de consulta de relacionamento 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 de posição, que pode ser atribuído a um valor adequado.

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

Cenário 2: consulta de relacionamento com objetos personalizados entre filhos e pais

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

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

Esta 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 dos 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 extrai dados de vários SObjects: Account e Contacts, relacionados a um tipo específico de Industry e 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, o que é uma maneira eficiente de processar grandes conjuntos de resultados.

A seguir