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
Implante e configure as propriedades da origem do Salesforce no Cloud Data Fusion. Para mais informações, consulte Origem de lote do Salesforce.
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
- Configure a origem em lote do Salesforce no Cloud Data Fusion.
- Siga um tutorial do plug-in do Salesforce.