Trasmettere dati in streaming dalle istanze ServiceNow

Datastream supporta la replica degli eventi di modifica da un'istanza ServiceNow. ServiceNow è una piattaforma basata sul cloud per le operazioni aziendali e puoi replicare i dati da questa piattaforma come faresti da altre origini supportate da Datastream.

Questa pagina contiene informazioni su:

  • I termini chiave che devi comprendere quando esegui la replica da ServiceNow.
  • Il comportamento di Datastream nella gestione dei dati estratti da un'istanza ServiceNow.
  • Le versioni di ServiceNow supportate da Datastream.
  • Le limitazioni note per l'utilizzo di ServiceNow come origine.

Termini chiave

ServiceNow funziona utilizzando tabelle, record e campi:

  • Un'istanza ServiceNow è un ambiente cloud ServiceNow dedicato e isolato, ad esempio company.service-now.com.
  • Una tabella è una struttura di dati primaria in ServiceNow, equivalente a una tabella di database.
  • Un record è una singola voce in una tabella, equivalente a una riga in un database.
  • Un campo è un singolo elemento di dati all'interno di un record, equivalente a una colonna di database.
  • Il connettore utilizza l'API Table come interfaccia RESTful principale per accedere ai dati direttamente dalle tabelle ServiceNow.
  • La paginazione basata su offset è un metodo per spostarsi tra i record in una tabella ServiceNow passando un numero di offset all'API Table. Questo metodo è sensibile alle eliminazioni di record durante la paginazione, il che può causare l'omissione dei dati da parte del connettore.
  • La paginazione basata su keyset è un metodo in cui il connettore gestisce la paginazione monitorando i valori dei record univoci, come identificatori o timestamp, e il loro ordine. Questo metodo è efficace anche se si verificano eliminazioni di record durante la paginazione.

Comportamento

Il supporto dell'origine ServiceNow in Datastream si basa sull'API REST Table di ServiceNow. Datastream supporta due metodi di replica principali per garantire l'integrità e le prestazioni dei dati.

Backfill storico

  • Quando esegue la replica dei dati di modifica da un'istanza ServiceNow, Datastream esegue una sincronizzazione storica completa di tutti i record esistenti in una tabella.
  • Per garantire la coerenza dei dati ed evitare la perdita di record durante le estrazioni di grandi dimensioni, il connettore utilizza la paginazione basata su keyset. Il connettore gestisce questo processo monitorando i valori dei record univoci e il loro ordine, il che rende l'estrazione robusta alle eliminazioni di record ed evita che il connettore salti o duplichi i record.
  • Datastream ordina i dati in base alle proprietà dei record sys_updated_on e sys_id per fornire un ordine stabile per il caricamento iniziale. Per la tabella sys_journal_field, che contiene record immutabili e non ha un campo sys_updated_on, il connettore ordina in base alle proprietà sys_created_on e sys_id.

Sincronizzazione incrementale

  • Quando esegue la replica dei dati di modifica da un'istanza ServiceNow, Datastream acquisisce le modifiche, come inserimenti e aggiornamenti, che si verificano dopo il backfill iniziale.
  • Sincronizzazione incrementale lato server: il connettore esegue una query sull'API ServiceNow per i record modificati dall'ultima sincronizzazione riuscita utilizzando un filtro sulle proprietà sys_updated_on e sys_id (o sys_created_on e sys_id per la tabella sys_journal_field).
  • Il processo di sincronizzazione utilizza un cursore composto da indicatori sys_updated_on (o sys_created_on per la tabella sys_journal_field) e sys_id. Gli indicatori sys_updated_on e sys_created_on assicurano che nel ciclo successivo vengano sincronizzati solo i record con un timestamp uguale o successivo a un'ora specificata, mentre l'indicatore sys_id garantisce la coerenza per i record con timestamp uguali.

Versioni

Il connettore ServiceNow funziona con l'API REST Table di ServiceNow (V2). La funzionalità supportata da Datastream viene convalidata rispetto alla release Zurigo.

Oggetti replicati

Il connettore ServiceNow utilizza un meccanismo di rilevamento dinamico per identificare l'intero set di tabelle (oggetti) all'interno di un'istanza. Per assicurarti di replicare solo i dati aziendali di alto valore, il connettore applica un processo di filtraggio multilivello per escludere le tabelle di metadati di architettura interna, log tecnici e di sistema.

Logica di filtro

  • Accesso al servizio web: puoi replicare solo le tabelle che configuri in modo esplicito con l'accesso ai servizi web abilitato (ws_access=true). Se questa configurazione non è presente, il connettore non può recuperare i dati dei record dalla tabella.
  • Superclassi escluse: il connettore esclude le tabelle che ereditano da la tabella di configurazione del sistema sys_metadata o che fanno parte di una gerarchia di tabelle ruotate per evitare di replicare metadati tecnici o snapshot incoerenti.
  • Prefisso di sistema interno: il connettore filtra le tabelle che iniziano con prefissi tecnici specifici che rappresentano la struttura della piattaforma o le funzionalità legacy.
  • La Golden List (eccezioni di sistema): mentre il connettore esclude la maggior parte delle tabelle sys_, consente in modo esplicito le entità aziendali critiche, come sys_user, sys_choice, e sys_journal_field.

Prefissi di sistema filtrati per impostazione predefinita

Categoria Prefissi Descrizione
Interni principali v_, ts_, imp_, ecc_, wf_, sh$, bin_, var_, gs_ Tabelle virtuali, indici di ricerca, staging di importazione, code ECC e contesti di workflow.
Analisi e AI pa_, ua_, ml_, ais_, promin_, di_ Punteggi di Performance Analytics, telemetria dei fornitori, vettori ML e profili di ricerca AI.
Moduli tecnici sa_, sla_, atf_, cxs_, automation_, ids_ Pattern di Service Mapping, log del motore SLA e audit trail di sicurezza.
Legacy e amministrazione pf_, clone_, upgrade_, rollback_, expert_, dscy_ Cronologia delle patch delle istanze, log di upgrade e moduli legacy obsoleti.

Tabelle di sistema consentite

  • Utenti e sicurezza: sys_user, sys_user_group, sys_user_grmember, sys_user_role, sys_user_has_role.
  • Riferimento principale: sys_choice (opzioni del menu a discesa), sys_company, sys_domain, sys_location.
  • Audit trail: sys_journal_field (cronologia di note di lavoro e commenti).

Limitazioni note

Le limitazioni note per l'utilizzo di ServiceNow come origine includono:

  • Datastream non supporta l'acquisizione dei record eliminati.
  • Per impostazione predefinita, Datastream esclude molte tabelle della piattaforma interna, ad esempio le tabelle che iniziano con ts_, v_ o imp_.
  • Puoi replicare solo le tabelle che configuri in modo esplicito con l'accesso ai servizi web abilitato (ws_access=true). Questa è l'impostazione predefinita per la maggior parte delle tabelle.
  • Il connettore replica i valori dei campi così come appaiono nell'istanza del database ServiceNow sottostante. Questi valori sono definiti valori effettivi. Ciò significa che i valori effettivi che Datastream replica nella destinazione potrebbero differire dai valori visualizzati nell'interfaccia utente di ServiceNow (definiti valori di visualizzazione). Per ulteriori informazioni, consulta la Knowledge Base di ServiceNow.

Passaggi successivi