Transmite datos desde instancias de ServiceNow

Conectar una instancia de ServiceNow a Datastream te permite replicar datos históricos y cambios incrementales para el análisis y la integración de datos. ServiceNow es una plataforma basada en la nube que ayuda a las organizaciones a administrar y automatizar las operaciones empresariales.

Antes de configurar una fuente de ServiceNow en Datastream, revisa los términos clave, el comportamiento de replicación, las versiones compatibles, los objetos replicados y las limitaciones conocidas.

Términos clave

ServiceNow opera con tablas, registros y campos:

  • Una instancia de ServiceNow es un entorno de nube de ServiceNow dedicado y aislado, por ejemplo, company.service-now.com.
  • Una tabla es una estructura de datos principal en ServiceNow, equivalente a una tabla de base de datos.
  • Un registro es una entrada individual en una tabla, equivalente a una fila en una base de datos.
  • Un campo es un elemento de datos individual dentro de un registro, equivalente a una columna de la base de datos.
  • El conector usa la API de Table como la interfaz RESTful principal para acceder a los datos directamente desde las tablas de ServiceNow.
  • La paginación basada en compensaciones es un método para navegar por los registros de una tabla de ServiceNow pasando un número de compensación a la API de Table. Este método es sensible a las eliminaciones de registros durante la paginación, lo que puede hacer que el conector omita datos.
  • La paginación basada en conjuntos de claves es un método en el que el conector administra la paginación haciendo un seguimiento de los valores de registro únicos, como identificadores o marcas de tiempo, y su orden. Este método es eficaz incluso si se borran registros durante la paginación.

Comportamiento

La compatibilidad con la fuente de ServiceNow en Datastream se basa en la API de REST de tablas de ServiceNow. Datastream admite dos métodos de replicación principales para garantizar la integridad de los datos y el rendimiento.

Reabastecimiento histórico

  • Cuando se replican datos modificados de una instancia de ServiceNow, Datastream realiza una sincronización histórica completa de todos los registros existentes en una tabla.
  • Para garantizar la coherencia de los datos y evitar la pérdida de registros durante las extracciones grandes, el conector usa la paginación basada en conjuntos de claves. El conector administra este proceso mediante el seguimiento de los valores de registro únicos y su orden, lo que hace que la extracción sea sólida para borrar registros y evita que el conector omita o duplique registros.
  • Datastream ordena los datos por las propiedades de registro sys_updated_on y sys_id para proporcionar un orden estable para la carga inicial. Para la tabla sys_journal_field, que contiene registros inmutables y no tiene un campo sys_updated_on, el conector ordena por las propiedades sys_created_on y sys_id.

Sincronización incremental

  • Cuando se replican datos de cambios desde una instancia de ServiceNow, Datastream captura los cambios, como las inserciones y las actualizaciones, que se producen después del reabastecimiento inicial.
  • Sincronización incremental del servidor: El conector consulta la API de ServiceNow para obtener los registros modificados desde la última sincronización correcta con un filtro en las propiedades sys_updated_on y sys_id (o sys_created_on y sys_id para la tabla sys_journal_field).
  • El proceso de sincronización usa un cursor compuesto que consta de marcadores sys_updated_on (o sys_created_on para la tabla sys_journal_field) y sys_id. Los marcadores sys_updated_on y sys_created_on garantizan que solo los registros con una marca de tiempo igual o posterior a una hora especificada se sincronicen en el siguiente ciclo, mientras que el marcador sys_id garantiza la coherencia de los registros con marcas de tiempo iguales.

Versiones

El conector de ServiceNow funciona con la API de Table (V2) de REST de ServiceNow. La funcionalidad que admite Datastream se valida con la versión Zurich.

Objetos replicados

El conector de ServiceNow usa un mecanismo de descubrimiento dinámico para identificar todo el conjunto de tablas (objetos) dentro de una instancia. Para garantizar que solo repliques datos de la empresa de alto valor, el conector aplica un proceso de filtrado de varias capas para excluir la arquitectura interna, los registros técnicos y las tablas de metadatos del sistema.

Lógica de filtrado

  • Acceso al servicio web: Solo puedes replicar tablas que configures de forma explícita con el acceso a los servicios web habilitado (ws_access=true). Si falta esta configuración, el conector no puede recuperar los datos de registro de la tabla.
  • Superclases excluidas: El conector excluye las tablas que heredan de la tabla de configuración del sistema sys_metadata o que forman parte de una jerarquía de tablas rotadas para evitar replicar metadatos técnicos o instantáneas incoherentes.
  • Prefijo del sistema interno: El conector filtra las tablas que comienzan con prefijos técnicos específicos que representan la infraestructura de la plataforma o las funciones heredadas.
  • La lista dorada (excepciones del sistema): Si bien el conector excluye la mayoría de las tablas de sys_, incluye de forma explícita en la lista de entidades permitidas las entidades comerciales críticas, como sys_user, sys_choice y sys_journal_field.

Prefijos del sistema filtrados de forma predeterminada

Categoría Prefijos Descripción
Elementos internos principales v_, ts_, imp_, ecc_, wf_, sh$, bin_, var_, gs_ Tablas virtuales, índices de búsqueda, etapa de pruebas de importación, colas de ECC y contextos de flujo de trabajo.
Analytics y la IA pa_, ua_, ml_, ais_, promin_, di_ Puntuaciones de Performance Analytics, telemetría de proveedores, vectores de AA y perfiles de la Búsqueda con IA.
Módulos técnicos sa_, sla_, atf_, cxs_, automation_, ids_ Patrones de Service Mapping, registros del motor de ANS y registros de auditoría de seguridad.
Heredado y administrador pf_, clone_, upgrade_, rollback_, expert_, dscy_ Historial de aplicación de parches de instancias, registros de actualización y módulos heredados obsoletos.

Tablas del sistema permitidas

  • Usuarios y seguridad: sys_user, sys_user_group, sys_user_grmember, sys_user_role, sys_user_has_role.
  • Referencia principal: sys_choice (opciones desplegables), sys_company, sys_domain, sys_location.
  • Registros de auditoría: sys_journal_field (historial de notas de trabajo y comentarios).

Limitaciones conocidas

Estas son algunas de las limitaciones conocidas para usar ServiceNow como fuente:

  • Datastream no admite la captura de registros borrados.
  • Datastream excluye muchas tablas internas de la plataforma de forma predeterminada, por ejemplo, las tablas que comienzan con ts_, v_ o imp_.
  • Solo puedes replicar tablas que configures de forma explícita con el acceso a los servicios web habilitado (ws_access=true). Esta es la configuración predeterminada para la mayoría de las tablas.
  • El conector replica los valores de los campos de la forma en que aparecen en la instancia de la base de datos de ServiceNow subyacente. Estos valores se denominan valores reales. Esto significa que los valores reales que Datastream replica en el destino pueden diferir de los valores que se muestran en la interfaz de usuario de ServiceNow (denominados valores de visualización). Para obtener más información, consulta la base de conocimiento de ServiceNow.

¿Qué sigue?