Diffuser des données depuis des organisations Salesforce

Vous pouvez connecter Datastream à une instance Salesforce pour répliquer les données historiques et les événements de modification à des fins d'analyse et d'intégration des données. Salesforce est une plate-forme de gestion de la relation client dans le cloud, où chaque instance est souvent appelée organisation Salesforce ou organisation Salesforce.

Lorsque vous configurez une source Salesforce dans Datastream, consultez les termes clés, le comportement de réplication, les éditions et versions d'API compatibles, les bonnes pratiques et les limites connues.

Termes clés

Salesforce fonctionne à l'aide d'objets, d'enregistrements et de champs :

  • Un objet est une entité de classe, semblable à une table dans la nomenclature des bases de données relationnelles. Les objets peuvent être standards ou personnalisés. Les objets standards sont inclus par défaut dans Salesforce, tandis que les objets personnalisés sont créés par les utilisateurs pour stocker des données spécifiques à leurs cas d'utilisation.
  • Un enregistrement est une instance spécifique d'un objet, semblable à une ligne dans les bases de données relationnelles.
  • Un champ est un attribut spécifique d'un objet, semblable à une colonne dans les bases de données relationnelles.

Comportement

La compatibilité avec la source Salesforce dans Datastream repose sur les API REST et Bulk 2.0. Salesforce interroge les modifications de la source en fonction de l'intervalle que vous avez défini pour contrôler l'utilisation de l'API.

Lors de la réplication de données à partir d'une source Salesforce, le comportement suivant est observé :

  • Les objets standards réplicables et interrogeables qui comportent le champ SystemModstamp ou LastModifiedDate peuvent être répliqués. Pour qu'un objet puisse être répliqué, il doit accepter les appels d'API getUpdated() et getDeleted(). Pour en savoir plus, consultez Appels d'API pour la réplication des données dans la documentation Salesforce.
  • Les objets personnalisés peuvent être répliqués.
  • Si elle est configurée, toutes les données historiques sont répliquées pour les objets inclus.
  • Toutes les modifications, telles que les insertions, les mises à jour et les suppressions des objets spécifiés, sont répliquées.
  • Datastream interroge les modifications en fonction de l'intervalle d'interrogation configuré. Cela se reflète dans la métrique de fraîcheur des données du flux. La métrique peut augmenter jusqu'à la valeur d'intervalle d'interrogation configurée et reflète le temps écoulé depuis l'interrogation la plus récente.

Versions

Datastream est compatible avec les éditions Salesforce suivantes :

  • Pro Suite
  • Développeur
  • Professionnel
  • Entreprise
  • Illimité

Datastream utilise la version 61.0 de l'API Salesforce.

Pour en savoir plus sur les éditions Salesforce disponibles, consultez la documentation Salesforce.

Bonnes pratiques

Cette section décrit les bonnes pratiques recommandées pour configurer votre source Salesforce afin de l'utiliser avec Datastream.

Gérer l'utilisation des quotas d'API

Salesforce impose des limites sur le nombre de requêtes API pouvant être effectuées sur une fenêtre glissante de 24 heures. L'épuisement de ce quota est un problème courant lors de la réplication de données à partir de Salesforce.

Vous pouvez configurer l'intervalle d'interrogation dans Datastream pour réduire le nombre de requêtes API envoyées à Salesforce. Un intervalle d'interrogation plus court améliore la fraîcheur des données, mais augmente également l'utilisation du quota d'API. Nous vous recommandons de définir un intervalle d'interrogation qui équilibre la fraîcheur des données choisie avec les contraintes de votre quota d'API afin de garantir une réplication durable des données. Si nécessaire, vous pouvez augmenter le quota global de requêtes API dans Salesforce.

Limitations connues

Voici certaines des limitations connues affectant l'utilisation de Salesforce comme source :

  • Seuls les objets interrogeables et réplicables sont acceptés.
  • Les champs composés sont répliqués en tant que champs aplatis.
  • Jusqu'à 600 000 suppressions par minute sont acceptées (limite de Salesforce).
  • Les flux sont limités à 3 000 objets.

  • Les champs calculés (également appelés formules) ne sont que partiellement acceptés. La réplication des champs calculés est soumise aux contraintes suivantes :

    • Les références entre tables ne sont pas acceptées.
    • Les fonctions non déterministes (telles que NOW() ou TODAY()) ne sont pas acceptées, car Datastream ne peut pas déterminer quand les valeurs de ces champs changent.
    • Seul un ensemble spécifique de fonctions autorisées est accepté. Si un champ calculé utilise une fonction qui ne figure pas dans cette liste, il n'est pas répliqué.

    La liste suivante répertorie les fonctions compatibles :

    • Logiques : AND, OR, NOT, IF, CASE, ISNULL, ISBLANK, BLANKVALUE, ISPICKVAL
    • Mathématiques : ABS, CEILING, MCEILING, FLOOR, MFLOOR, ROUND, MOD, SQRT, EXP, LN, LOG, MAX, MIN
    • Texte : BEGINS, BR, CONTAINS, FIND, HYPERLINK, INCLUDES, LEFT, LEN, LOWER, LPAD, MID, RPAD, RIGHT, SUBSTITUTE, TEXT, TRIM, UPPER, VALUE
    • Date et heure : DATE, DATEVALUE, DATETIMEVALUE, DAY, MONTH, YEAR, HOUR, MINUTE, SECOND, MILLISECOND, WEEKDAY, TIMEVALUE, ADDMONTHS
    • Autre : REGEX

  • La récupération de flux n'est pas prise en charge.

Étapes suivantes