Pular para o conteúdo principal

Perguntas frequentes sobre conectores ServiceNow

Esta página responde a perguntas frequentes sobre o conector ServiceNow em Databricks LakeFlow Connect.

Perguntas frequentes sobre o conector de gerenciar geral

As respostas nas perguntas frequentes sobre o conector gerenciar se aplicam a todos os conectores gerenciar em LakeFlow Connect. Continue lendo as perguntas frequentes específicas do ServiceNow.

Perguntas frequentes específicas sobre conectores

As respostas nesta seção são específicas para o conector ServiceNow.

Como o conector extrai dados do ServiceNow?

O conector ServiceNow usa a ServiceNow Table API v2.

O uso da API de tabela pode afetar a instância do ServiceNow?

Sim No entanto, o impacto depende da quantidade de dados ingeridos. Por exemplo, normalmente é mais perceptível no Snapshot inicial do que durante uma leitura incremental.

Como o conector extrai dados de forma incremental?

Para que uma tabela possa ser ingerida incrementalmente, ela deve ter uma das seguintes colunas. Caso nenhuma dessas colunas exista, o conector cria um instantâneo da tabela de origem e sobrescreve a tabela de destino.

  • sys_updated_on
  • sys_created_on
  • sys_archived

Por que meu desempenho de ingestão do ServiceNow está lento?

A Databricks recomenda que você trabalhe com o administrador do ServiceNow para habilitar a indexação no campo do cursor no ServiceNow. A coluna do cursor é selecionada da seguinte lista, por ordem de disponibilidade e preferência: sys_updated_on (primeira escolha), sys_created_on (segunda escolha), sys_archived (terceira escolha). Essa é uma abordagem padrão para melhorar o desempenho ao ingerir dados usando as APIs do ServiceNow. A configuração do índice permite que o Databricks evite a varredura completa da coluna sys_updated_on , o que pode causar gargalos em atualizações grandes. Para obter instruções, consulte Criar um índice de tabela na documentação do ServiceNow.

A Databricks também recomenda aumentar o tempo limite de solicitação da API REST Table para mais de 60 segundos. Isso ajuda a evitar exceder o limite de transações, o que pode fazer com que a consulta expire. Se o problema persistir, crie um ticket de suporte.

O conector requer permissões de administrador?

Não. O conector suporta as seguintes opções:

  • Funções de administrador (recomendado): Use a função admin e, opcionalmente, a função snc_read_only . Essa abordagem retorna o esquema completo da tabela em uma única chamada de API por tabela.
  • Funções com privilégios mínimos: Utilize ACLs em nível de tabela. Essa abordagem requer mais chamadas à API para a descoberta do esquema. Escolha esta opção somente se restringir permissões for mais importante do que minimizar o uso da API.

Para obter uma lista completa das permissões necessárias, consulte a configuração da fonte.

Por que o princípio do menor privilégio exige maior utilização da API?

Com privilégios de administrador, o ServiceNow pode retornar o esquema completo da tabela, incluindo os campos herdados, em uma única chamada de API.

Sem funções de administrador, o conector precisa fazer várias chamadas de API para descobrir o esquema. Como as tabelas do ServiceNow usam herança, o conector deve:

  1. Encontre o pai da tabela.
  2. Repita o processo para cada tabela pai até chegar à raiz da hierarquia.
  3. Obtenha as definições de campo para cada tabela na cadeia.

O número de chamadas API aumenta proporcionalmente à profundidade da hierarquia de herança da tabela. Por exemplo, se uma tabela tiver uma hierarquia de três camadas, o conector precisará de pelo menos três chamadas de API para resolver as tabelas pai, além de chamadas adicionais para buscar as definições de campo — em comparação com uma única chamada com acesso administrativo. A descoberta de esquemas com acesso de privilégio mínimo ocorre em cada execução do pipeline, não apenas durante a configuração inicial.