Exemplo de utilização: consultas SOQL para a origem do Salesforce

Esta página mostra como usar consultas de relações SOQL quando usa a origem do Salesforce no Cloud Data Fusion.

A origem do Salesforce permite-lhe estabelecer ligação perfeita ao Salesforce e carregar grandes quantidades de dados para o Google Cloud. Para simplificar o carregamento dos dados, pode usar consultas de relações SOQL para obter registos e reduzir o número de chamadas API no Salesforce.

Antes de começar

  1. Implemente e configure as propriedades da origem do Salesforce no Cloud Data Fusion. Para mais informações, consulte o artigo Origem de lotes do Salesforce.

  2. No nó Salesforce no seu pipeline, clique em Propriedades. É apresentada a página de propriedades do plug-in do Salesforce.

As secções seguintes 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 seguinte tem uma chave polimórfica e um limite:

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

Esta consulta obtém dados de um SObject do Task relacionado com Owner. Lê dados dos campos selecionados no SObject Task. Tem uma cláusula WHERE e um marcador de posição ao qual pode atribuir um valor adequado.

Esta consulta permite-lhe aceder aos campos obrigatórios através de uma variável de marcador de posição. Limita a quantidade de registos obtidos a 100.

Cenário 2: consulta de relação de filho para pai com objetos personalizados

A consulta seguinte obtém dados de um objeto personalizado com uma relação hierárquica 

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

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

A consulta devolve dados dos campos selecionados no Lead SObject e os campos relacionais da pesquisa associada ao Account objeto principal. 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 seguinte obtém dados de vários SObjects: Account e Contacts, relacionados com um tipo Industry específico 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-lhe devolver resultados em várias páginas, o que é uma forma eficiente de processar grandes conjuntos de resultados.

O que se segue?