Esta página mostra como usar as consultas de relação SOQL ao usar o Salesforce no Cloud Data Fusion.
A fonte do Salesforce permite que você se conecte facilmente ao Salesforce e carregue grandes quantidades de dados para o Google Cloud. Para simplificar o carregamento de dados, você pode usar Consultas de relação SOQL para recuperar 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 Fonte em 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 relação com chave e limites polimórficos
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
um marcador, para atribuir um valor adequado.
Essa consulta permite acessar os campos obrigatórios usando uma variável de marcador. Ela
limita a quantidade de registros buscados a 100
.
Cenário 2: consulta de relação entre filho e pai com objetos personalizados
A consulta a seguir busca dados de um objeto personalizado com filhos para pai relacionamento:
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
em
Salesforce com o campo de referência Account__r.OwnerId
.
A consulta retorna dados dos campos selecionados no SObject Lead
e o
campos relacionais da pesquisa vinculados ao objeto pai Account
. Você pode
consultar vários campos de dados de um cluster de SObjects relacionais.
Cenário 3: consulta de relação com cláusulas WHERE e OFFSET
A consulta a seguir busca dados de vários SObjects: Account
e
Contacts
, relacionado 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, que é uma
muito eficiente para lidar
com grandes conjuntos de resultados.
A seguir
- Configure a origem em lote do Salesforce no Cloud Data Fusion.
- Siga as etapas do tutorial do plug-in do Salesforce.