Diffuser des données à partir d'instances ServiceNow

La connexion d'une instance ServiceNow à Datastream vous permet de répliquer les données historiques et les modifications incrémentielles pour l'analyse et l'intégration des données. ServiceNow est une plate-forme cloud qui aide les organisations à gérer et à automatiser les opérations d'entreprise.

Avant de configurer une source ServiceNow dans Datastream, consultez les termes clés, le comportement de réplication, les versions compatibles, les objets répliqués et les limites connues.

Termes clés

ServiceNow fonctionne à l'aide de tables, d'enregistrements et de champs :

  • Une instance ServiceNow est un environnement cloud ServiceNow dédié et isolé, par exemple company.service-now.com.
  • Une table est une structure de données principale dans ServiceNow, équivalente à une table de base de données.
  • Un enregistrement est une entrée individuelle dans une table, l'équivalent d'une ligne dans une base de données.
  • Un champ est un élément de données individuel d'un enregistrement, équivalent à une colonne de base de données.
  • Le connecteur utilise l'API Table comme interface RESTful principale pour accéder aux données directement à partir des tables ServiceNow.
  • La pagination basée sur un décalage est une méthode de navigation dans les enregistrements d'une table ServiceNow en transmettant un numéro de décalage à l'API Table. Cette méthode est sensible aux suppressions d'enregistrements pendant la pagination, ce qui peut amener le connecteur à ignorer des données.
  • La pagination basée sur un ensemble de clés est une méthode par laquelle le connecteur gère la pagination en suivant les valeurs d'enregistrement uniques, telles que les identifiants ou les codes temporels, et leur ordre. Cette méthode est efficace même si des enregistrements sont supprimés pendant la pagination.

Comportement

La compatibilité de la source ServiceNow dans Datastream repose sur l'API REST Table de ServiceNow. Datastream accepte deux méthodes de réplication principales pour garantir l'intégrité et les performances des données.

Remplissage de données historiques

  • Lors de la réplication des données modifiées à partir d'une instance ServiceNow, Datastream effectue une synchronisation complète de l'historique de tous les enregistrements existants dans une table.
  • Pour assurer la cohérence des données et éviter la perte d'enregistrements lors d'extractions volumineuses, le connecteur utilise la pagination basée sur un ensemble de clés. Le connecteur gère ce processus en suivant les valeurs d'enregistrement uniques et leur ordre, ce qui rend l'extraction robuste pour enregistrer les suppressions et empêche le connecteur d'ignorer ou de dupliquer des enregistrements.
  • Datastream trie les données par propriétés d'enregistrement sys_updated_on et sys_id pour fournir un ordre stable pour le chargement initial. Pour la table sys_journal_field, qui contient des enregistrements immuables et ne comporte pas de champ sys_updated_on, le connecteur trie par propriétés sys_created_on et sys_id.

Synchronisation incrémentielle

  • Lors de la réplication des données modifiées à partir d'une instance ServiceNow, Datastream capture les modifications, telles que les insertions et les mises à jour, qui se produisent après le remplissage initial.
  • Synchronisation incrémentielle côté serveur : le connecteur interroge l'API ServiceNow pour obtenir les enregistrements modifiés depuis la dernière synchronisation réussie à l'aide d'un filtre sur les propriétés sys_updated_on et sys_id (ou sys_created_on et sys_id pour la table sys_journal_field).
  • Le processus de synchronisation utilise un curseur composé de repères sys_updated_on (ou sys_created_on pour la table sys_journal_field) et sys_id. Les repères sys_updated_on et sys_created_on garantissent que seuls les enregistrements dont le code temporel est égal ou postérieur à une heure spécifiée sont synchronisés au cours du cycle suivant, tandis que le repère sys_id garantit la cohérence des enregistrements dont les codes temporels sont identiques.

Versions

Le connecteur ServiceNow fonctionne avec l'API Table (V2) REST de ServiceNow. La fonctionnalité compatible avec Datastream est validée par rapport à la version Zurich.

Objets répliqués

Le connecteur ServiceNow utilise un mécanisme de découverte dynamique pour identifier l'ensemble des tables (objets) d'une instance. Pour s'assurer que vous ne répliquez que des données d'entreprise de grande valeur, le connecteur applique un processus de filtrage multicouche pour exclure l'architecture interne, les journaux techniques et les tables de métadonnées système.

Logique de filtrage

  • Accès au service Web : vous ne pouvez répliquer que les tables que vous configurez explicitement avec l'accès aux services Web activé (ws_access=true). Si cette configuration est manquante, le connecteur ne peut pas récupérer les données d'enregistrement de la table.
  • Superclasses exclues : le connecteur exclut les tables qui héritent de la table de configuration système sys_metadata ou qui font partie d'une hiérarchie de tables alternées pour éviter de répliquer des métadonnées techniques ou des instantanés incohérents.
  • Préfixe du système interne : le connecteur filtre les tables commençant par des préfixes techniques spécifiques représentant la plomberie de la plate-forme ou d'anciennes fonctionnalités.
  • Liste d'exceptions (exceptions système) : bien que le connecteur exclue la plupart des tables sys_, il autorise explicitement les entités commerciales critiques, telles que sys_user, sys_choice et sys_journal_field.

Préfixes système filtrés par défaut

Catégorie Préfixes Description
Éléments internes de base v_, ts_, imp_, ecc_, wf_, sh$, bin_, var_, gs_ Tables virtuelles, index de recherche, préproduction d'importation, files d'attente ECC et contextes de workflow.
Analyse et IA pa_, ua_, ml_, ais_, promin_, di_ Scores Performance Analytics, télémétrie des fournisseurs, vecteurs de ML et profils dans la Recherche optimisée par l'IA.
Modules techniques sa_, sla_, atf_, cxs_, automation_, ids_ Modèles de mappage de services, journaux du moteur de SLA et pistes d'audit de sécurité.
Ancien et administrateur pf_, clone_, upgrade_, rollback_, expert_, dscy_ Historique des correctifs d'instance, journaux de mise à niveau et anciens modules obsolètes.

Tables système autorisées

  • Utilisateurs et sécurité : sys_user, sys_user_group, sys_user_grmember, sys_user_role, sys_user_has_role.
  • Référence principale : sys_choice (options du menu déroulant), sys_company, sys_domain, sys_location.
  • Pistes d'audit : sys_journal_field (historique des notes de travail et des commentaires).

Limitations connues

Voici quelques-unes des limites connues liées à l'utilisation de ServiceNow comme source :

  • Datastream ne permet pas de capturer les enregistrements supprimés.
  • Par défaut, Datastream exclut de nombreuses tables de plate-forme internes, par exemple celles commençant par ts_, v_ ou imp_.
  • Vous ne pouvez répliquer que les tables que vous configurez explicitement avec l'accès aux services Web activé (ws_access=true). Il s'agit de la valeur par défaut pour la plupart des tables.
  • Le connecteur réplique les valeurs des champs telles qu'elles apparaissent dans l'instance de base de données ServiceNow sous-jacente. Ces valeurs sont appelées valeurs réelles. Cela signifie que les valeurs réelles que Datastream réplique vers la destination peuvent différer des valeurs affichées dans l'interface utilisateur de ServiceNow (appelées valeurs d'affichage). Pour en savoir plus, consultez la base de connaissances ServiceNow.

Étapes suivantes