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 no Propriedades.
Cenário 1: consulta de relação com chave e limites polimórficos
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. Ela
limita a quantidade de registros buscados a 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 objeto S Lead
e dos campos relacionais da pesquisa vinculada 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, 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 as etapas do tutorial do plug-in do Salesforce.