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 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
Déployez et configurez les propriétés de la source Salesforce dans Cloud Data Fusion. Pour en savoir plus, consultez la section Source de lot Salesforce.
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 expliquent comment configurer le champ Requête SOQL sur la page 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. Il 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 extrait des données d'un objet personnalisé avec une relation enfant-parent:
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 des 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 le SObject 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
- Configurez la source par lot Salesforce dans Cloud Data Fusion.
- Suivez un tutoriel sur les plug-ins Salesforce.