Solucionar problemas de ingestão do ServiceNow

Esta página descreve problemas comuns com o conector ServiceNow em Databricks LakeFlow Connect e como resolvê-los.

Solução de problemas gerais de pipeline

Se um pipeline falhar durante a execução, clique na etapa que falhou e confirme se a mensagem de erro fornece informações suficientes sobre a natureza do erro.

Você também pode verificar e download os logs cluster na página de detalhes pipeline , clicando em Atualizar detalhes no painel direito e, em seguida, em Logs . Analise os logs em busca de erros ou exceções.

Seleção de colunas usando Databricks ativo Bundles

Problema:

Não é possível usar o recurso de seleção de coluna quando o senhor cria uma ingestão gerenciar pipeline usando Databricks ativo Bundles.

Resolução:

Verifique a versão da CLI do Databricks. Se a versão for abaixo v0.251.0, reinstalar a CLI.

A ingestão de uma tabela específica é lenta

Como primeiro passo, trabalhe com o administrador do ServiceNow para habilitar a indexação na coluna do cursor. A coluna do cursor é selecionada da seguinte lista, por ordem de preferência: sys_updated_on (primeira escolha), sys_created_on (segunda escolha), sys_archived (terceira escolha). Em seguida, tente novamente o seu pipeline de ingestão. Se o problema persistir, abra um chamado. Para obter instruções sobre como habilitar a indexação no ServiceNow, consulte a documentação do ServiceNow.

Por que não vejo as exclusões que esperava ver?

O Databricks usa a tabela sys_audit_delete para rastrear exclusões. Pode levar de 3 a 5 minutos para que as exclusões apareçam na tabela sys_audit_delete no ServiceNow. Aguarde alguns minutos e tente executar o pipeline novamente. Se o problema persistir, abra um chamado de suporte.

Erro de redirect_uri inválido

Isso geralmente significa que há um erro de digitação no URL de redirecionamento no ServiceNow. Tente copiar o URL e colá-lo em um decodificador de URL de sua escolha. Na URL decodificada, confirme se o parâmetro redirect-uri está no seguinte formato:

https://<workspace>/login/oauth/servicenow.html

Erro de autenticação

Erro :

com.databricks.pipelines.execution.conduit.common.DataConnectorException: [SERVICENOW_CONNECTION_ERROR.OAUTH_TOKEN_EXCHANGE] Failed to authenticate to ServiceNow. This can be caused by issues with your UC credentials, ServiceNow OAuth setup, and more...

Etapa 1 :

Confirme se o senhor forneceu o nome de usuário, a senha, o ID do cliente e o segredo do cliente corretos ao criar a conexão do Unity Catalog. O nome de usuário e a senha para autenticação no ServiceNow não são necessariamente seu nome de usuário e senha pessoais para SSO. Esses são os valores de nome de usuário e senha associados a um usuário que se destina à autenticação e ingestão com o serviço externo.

Catalog Explorer

1. Na barra lateral do site Databricks workspace, clique em Catalog .

2. Na parte superior do painel Catálogo , clique no ícone de engrenagem e selecione Conexões no menu.

   Como alternativa, na página de acesso rápido , clique no botão External data (Dados externos ) > e vá para Connections (Conexões ) tab.

3. Clique no nome da conexão.

   Os detalhes da conexão estão listados na Visão geral tab.

curl

executar a seguinte solicitação curl. Substitua os itens entre colchetes pelas suas propriedades de conexão.

curl -X POST "https://<instance-id>.service-now.com/oauth_token.do" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "grant_type=password" \
--data-urlencode "client_id=<client-id>" \
--data-urlencode "client_secret=<client-secret>" \
--data-urlencode "username=<username>" \
--data-urlencode "password=<password>"

Se a solicitação for bem-sucedida (o senhor recebe seus tokens de acesso, tokens refresh e escopo na resposta), as credenciais estão corretas. Prossiga para a próxima etapa de solução de problemas.

Se a solicitação falhar, a seguinte mensagem de erro será retornada:

{"error_description":"access_denied","error":"server_error"}

Etapa 2 :

Confirme se o usuário autenticador tem a função admin. A Databricks também recomenda que o usuário autenticador tenha a função snc_read_only para restringir ainda mais as permissões.

Etapa 3 :

Confirme se o usuário autenticador está marcado como Ativo :

1. No ServiceNow, clique em Organization > Users.

2. Selecione o usuário que você planeja usar para autenticação.

3. Confirme se a caixa de seleção Ativo está marcada.

   

Etapa 4 :

Confirme se o plug-in OAuth 2.0 no ServiceNow está ativo:

1. No ServiceNow, clique em System Definition > Plugins.

2. execute o seguinte script na seção Scripts - Background :

   var oauthActive = gs.getProperty('com.snc.platform.security.oauth.is.active');
   gs.info('OAuth Active: ' + oauthActive);

   Se o script retornar true, a instalação do plug-in foi bem-sucedida. Se esse script retornar false, desinstale-o e reinstale-o.

   

Etapa 5 :

Confirme se o site OAuth endpoint está configurado corretamente:

1. No ServiceNow, visite System OAuth > Application Registry .

2. No canto superior direito, clique em NOVO.

3. Nas opções do aplicativo OAuth, clique em Create an OAuth API endpoint for external clients (Criar um ponto de extremidade da API OAuth para clientes externos ).

   

4. Confirme se a caixa de seleção Ativo está marcada.

   

   Depois de criar o aplicativo OAuth com êxito, ele aparecerá na lista em System OAuth > Application Registry com o tipo OAuth Client .

Etapa 6 :

Se o problema persistir após seguir essas etapas de solução de problemas, envie um ticket de suporte.