Transmitir dados de instâncias do ServiceNow

O Datastream permite replicar eventos de mudança de uma instância do ServiceNow. O ServiceNow é uma plataforma baseada na nuvem para operações empresariais. É possível replicar dados dela da mesma forma que de outras fontes compatíveis com o Datastream.

Esta página contém informações sobre:

  • Os termos-chave que você precisa entender ao replicar do ServiceNow.
  • O comportamento de como o Datastream lida com dados extraídos de uma instância do ServiceNow.
  • As versões do ServiceNow compatíveis com o Datastream.
  • Limitações conhecidas para o uso do ServiceNow como fonte.

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 principal 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 principal interface RESTful 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 registros exclusivos, como identificadores ou carimbos de data/hora, e a ordem deles. Esse método é eficaz mesmo que haja exclusões de registros durante a paginação.

Comportamento

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

Preenchimento histórico

  • Ao replicar dados de mudança de uma instância do ServiceNow, o Datastream realiza uma sincronização histórica completa de todos os registros existentes em uma tabela.
  • Para garantir a consistência dos dados e evitar a perda de registros durante grandes extrações, o conector usa paginação baseada em conjunto de chaves. O conector gerencia esse processo rastreando valores de registros exclusivos e a ordem deles, o que torna a extração robusta para exclusões de registros e evita que o conector pule ou duplique registros.
  • O Datastream classifica os dados por 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 mudança de uma instância do ServiceNow, o Datastream captura mudanças, como inserções e atualizações, que ocorrem após o reabastecimento inicial.
  • Sincronização incremental do lado do servidor: o conector consulta a API ServiceNow para 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 apenas 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 com base na 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 multicamadas para excluir arquitetura interna, registros técnicos e tabelas de metadados do sistema.

Lógica de filtragem

  • Acesso a serviços da Web: só é possível replicar tabelas configuradas explicitamente com o acesso a serviços da Web ativado (ws_access=true). Se essa configuração estiver faltando, 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 encanamento da plataforma ou recursos legados.
  • A lista de ouro (exceções do sistema): embora o conector exclua a maioria das tabelas sys_, ele permite explicitamente entidades comerciais críticas, como sys_user, sys_choice e sys_journal_field.

Prefixos do sistema filtrados por padrão

Categoria Prefixos Descrição
Elementos internos principais v_, ts_, imp_, ecc_, wf_, sh$, bin_, var_, gs_ Tabelas virtuais, índices de pesquisa, preparo da importação, filas de ECC e contextos de fluxo de trabalho.
Análises e IA pa_, ua_, ml_, ais_, promin_, di_ Pontuações da análise de performance, telemetria do fornecedor, vetores de ML e perfis de pesquisa de 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 administração pf_, clone_, upgrade_, rollback_, expert_, dscy_ Histórico de aplicação de patch na instância, 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 e comentários de trabalho).

Limitações conhecidas

Limitações conhecidas para o uso do ServiceNow como fonte:

  • O Datastream não é compatível com a captura de registros excluídos.
  • Por padrão, o Datastream exclui muitas tabelas internas da plataforma, por exemplo, as que começam com ts_, v_ ou imp_.
  • Só é possível replicar tabelas que você configura explicitamente com o acesso aos serviços da Web ativado (ws_access=true). Essa é a configuração padrão para a maioria das tabelas.
  • O conector replica os valores de campo da maneira como aparecem na instância do banco de dados do ServiceNow. Esses valores são chamados de valores reais. Isso significa que os valores reais replicados pelo Datastream para o destino podem ser diferentes dos valores mostrados 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