Cas d'utilisation : requêtes SOQL pour la source Salesforce

Cette page explique comment utiliser les requêtes de relations SOQL lorsque vous utilisez la source Salesforce dans Cloud Data Fusion.

La source Salesforce vous permet de vous connecter facilement à Salesforce et de charger de grands grandes quantités de données dans Google Cloud. Pour simplifier le chargement des données, vous pouvez utiliser des requêtes de relations SOQL pour récupérer des enregistrements et réduire le nombre d'appels d'API dans Salesforce.

Avant de commencer

  1. Déployer et configurer les propriétés de la source Salesforce dans Cloud Data Fusion. Pour en savoir plus, consultez la section Source de lot Salesforce.

  2. Dans le nœud Salesforce de votre pipeline, cliquez sur Properties (Propriétés). La page des propriétés du plug-in Salesforce s'ouvre.

Les sections suivantes décrivent comment configurer le champ de requête SOQL sur la Propriétés.

Scénario 1 : Requête de relation avec clé polymorphe et limites

L'exemple de requête de relation suivant comporte une clé polymorphe et une limite:

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

Cette requête extrait des données d'un sObject Task associé à Owner. Il lit les données des champs sélectionnés dans l'objet Task. Elle comporte une clause WHERE et un espace réservé auquel vous pouvez attribuer une valeur appropriée.

Cette requête vous permet d'accéder aux champs obligatoires à l'aide d'une variable d'espace réservé. Il limite la quantité d'enregistrements récupérés à 100.

Scénario 2 : Requête de relation enfant-parent avec des objets personnalisés

La requête suivante récupère les données d'un objet personnalisé avec un objet "enfant à parent" relation:

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

Cette requête utilise une clause SELECT pour extraire les données du SObject Lead dans Salesforce avec le champ de référence Account__r.OwnerId.

La requête renvoie les données des champs sélectionnés dans l'objet Lead et les champs relationnels de la table de correspondance associée à l'objet parent Account. Vous pouvez interroger plusieurs champs de données à partir d'un cluster d'objets S relationnels.

Scénario 3 : Requête de relation avec les clauses WHERE et OFFSET

La requête suivante extrait des données de plusieurs SObjects : Account et Contacts, en lien avec un type Industry et une clause OFFSET spécifiques :

SELECT Name, (SELECT LastName FROM Contacts WHERE CreatedBy.Alias = 'x') FROM Account WHERE Industry = 'media'
offset 4

La clause OFFSET vous permet de renvoyer des résultats sur plusieurs pages, ce qui constitue un moyen efficace de gérer de grands ensembles de résultats.

Étape suivante