Transmitir dados de instâncias do ServiceNow

Ao conectar uma instância do ServiceNow ao Datastream, é possível replicar dados históricos e mudanças incrementais para análise e integração de dados. O ServiceNow é uma plataforma baseada na nuvem que ajuda as organizações a gerenciar e automatizar as operações corporativas.

Antes de configurar uma origem do ServiceNow no Datastream, revise os termos principais, o comportamento de replicação, as versões compatíveis, os objetos replicados e as limitações conhecidas.

Termos-chave

O ServiceNow opera usando tabelas, registros e campos:

  • Uma instância do ServiceNow é um ambiente de nuvem dedicado e isolado do ServiceNow, por exemplo, company.service-now.com.
  • Uma tabela é uma estrutura de dados primária no ServiceNow, equivalente a uma tabela de banco de dados.
  • Um registro é uma entrada individual em uma tabela, equivalente a uma linha em um banco de dados.
  • Um campo é um elemento de dados individual em um registro, equivalente a uma coluna de banco de dados.
  • O conector usa a API Table como a interface RESTful principal para acessar dados diretamente das tabelas do ServiceNow.
  • A paginação baseada em deslocamento é um método de navegação pelos registros em uma tabela do ServiceNow transmitindo um número de deslocamento para a API Table. Esse método é sensível a exclusões de registros durante a paginação, o que pode fazer com que o conector pule dados.
  • A paginação baseada em conjunto de chaves é um método em que o conector gerencia a paginação rastreando valores de registro exclusivos, como identificadores ou carimbos de data/hora, e a ordem deles. Esse método é eficaz mesmo se houver exclusões de registros durante a paginação.

Comportamento

O suporte à origem do ServiceNow no Datastream depende da API REST Table do ServiceNow. O Datastream oferece dois métodos principais de replicação para garantir a integridade de dados e o desempenho.

Preenchimento histórico

  • Ao replicar dados de alteração de uma instância do ServiceNow, o Datastream realiza uma sincronização histórica completa de todos os registros em uma tabela.
  • Para garantir a consistência dos dados e evitar a perda de registros durante extrações grandes, o conector usa a paginação baseada em conjunto de chaves. O conector gerencia esse processo rastreando valores de registro exclusivos e a ordem deles, o que torna a extração robusta para exclusões de registros e impede que o conector pule ou duplique registros.
  • O Datastream classifica os dados pelas propriedades de registro sys_updated_on e sys_id para fornecer uma ordem estável para a carga inicial. Para a tabela sys_journal_field, que contém registros imutáveis e não tem um campo sys_updated_on, o conector classifica pelas propriedades sys_created_on e sys_id.

Sincronização incremental

  • Ao replicar dados de alteração de uma instância do ServiceNow, o Datastream captura alterações, como inserções e atualizações, que ocorrem após o preenchimento inicial.
  • Sincronização incremental do lado do servidor: o conector consulta a API ServiceNow em busca de registros modificados desde a última sincronização bem-sucedida usando um filtro nas propriedades sys_updated_on e sys_id (ou sys_created_on e sys_id para a tabela sys_journal_field).
  • O processo de sincronização usa um cursor composto que consiste em marcadores sys_updated_on (ou sys_created_on para a tabela sys_journal_field) e sys_id. Os marcadores sys_updated_on e sys_created_on garantem que somente os registros com um carimbo de data/hora igual ou posterior a um horário especificado sejam sincronizados no próximo ciclo, enquanto o marcador sys_id garante a consistência dos registros com carimbos de data/hora iguais.

Versões

O conector do ServiceNow funciona com a API Table (V2) REST do ServiceNow. A funcionalidade compatível com o Datastream é validada em relação à versão Zurich.

Objetos replicados

O conector do ServiceNow usa um mecanismo de descoberta dinâmica para identificar todo o conjunto de tabelas (objetos) em uma instância. Para garantir que você replique apenas dados da empresa de alto valor, o conector aplica um processo de filtragem em várias camadas para excluir arquitetura interna, registros técnicos e tabelas de metadados do sistema.

Lógica de filtragem

  • Acesso ao serviço da Web: só é possível replicar tabelas que você configura explicitamente com o acesso aos serviços da Web ativado (ws_access=true). Se essa configuração estiver ausente, o conector não poderá recuperar dados de registro da tabela.
  • Superclasses excluídas: o conector exclui tabelas que herdam da tabela de configuração do sistema sys_metadata ou fazem parte de uma hierarquia de tabelas rotacionadas para evitar a replicação de metadados técnicos ou snapshots inconsistentes.
  • Prefixo do sistema interno: o conector filtra tabelas que começam com prefixos técnicos específicos que representam recursos legados ou de encanamento da plataforma.
  • A lista de ouro (exceções do sistema): embora o conector exclua a maioria das tabelas sys_, ele permite explicitamente entidades empresariais críticas, como sys_user, sys_choice e sys_journal_field.

Prefixos do sistema filtrados por padrão

Categoria Prefixos Descrição
Aspectos internos do núcleo v_, ts_, imp_, ecc_, wf_, sh$, bin_, var_, gs_ Tabelas virtuais, índices da Pesquisa, preparo de importação, filas ECC e contextos de fluxo de trabalho.
Análise e IA pa_, ua_, ml_, ais_, promin_, di_ Pontuações do Performance Analytics, telemetria do fornecedor, vetores de ML e perfis na Pesquisa com IA.
Módulos técnicos sa_, sla_, atf_, cxs_, automation_, ids_ Padrões de mapeamento de serviços, registros do mecanismo de SLA e trilhas de auditoria de segurança.
Legado e administrador pf_, clone_, upgrade_, rollback_, expert_, dscy_ Histórico de aplicação de patches de instâncias, registros de upgrade e módulos legados obsoletos.

Tabelas do sistema permitidas

  • Usuários e segurança: sys_user, sys_user_group, sys_user_grmember, sys_user_role, sys_user_has_role.
  • Referência principal: sys_choice (opções do menu suspenso), sys_company, sys_domain, sys_location.
  • Trilhas de auditoria: sys_journal_field (histórico de notas de trabalho e comentários).

Limitações conhecidas

As limitações conhecidas do uso do ServiceNow como origem incluem:

  • O Datastream não é compatível com a captura de registros excluídos.
  • O Datastream exclui muitas tabelas de plataforma interna por padrão, por exemplo, tabelas que começam com ts_, v_ ou imp_.
  • Só é possível replicar tabelas que você configurar explicitamente com o acesso aos serviços da Web ativado (ws_access=true). Esse é o padrão para a maioria das tabelas.
  • O conector replica os valores de campo da maneira como eles aparecem na instância do banco de dados do ServiceNow. Esses valores são chamados de valores reais. Isso significa que os valores reais que o Datastream replica para o destino podem ser diferentes dos valores exibidos na interface do usuário do ServiceNow (chamados de valores de exibição). Para mais informações, consulte a base de conhecimento do ServiceNow.

A seguir