Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Importante
O conector ServiceNow está em Public Preview.
Este artigo descreve como configurar sua instância ServiceNow para ingestão de Databricks. As etapas dependem do método de autenticação escolhido.
Escolha um método de autenticação
Os seguintes métodos de autenticação são suportados:
- OAuth padrão (recomendado)
- OAuth com atualização automatizada de token (legado)
A Databricks recomenda o OAuth padrão porque é a abordagem mais segura. No entanto, sua conexão ServiceNow expirará quando seu token de autenticação expirar. Por padrão, isso acontece a cada 100 dias. Para reduzir a frequência, você pode modificar o período de expiração no ServiceNow ou usar o OAuth com a atualização automatizada do token.
Você usará os detalhes de autenticação obtidos para criar uma conexão do Databricks Unity Catalog com o ServiceNow. O OAuth com atualização automatizada de token só é suportado para conexões criadas usando APIs do Databricks. Não há suporte na interface do usuário do Databricks.
Confirmar privilégios de usuário
Para capturar exclusões, o usuário do ServiceNow deve ter acesso ao
sys_audit_delete table
, e a tabela que está sendo ingerida deve estar rastreando exclusões (o atributo table não pode ser definido comono_audit_delete=true
no ServiceNow).O seu utilizador ServiceNow deve ter a função
admin
.(Opcional) Para limitar o usuário administrador ao acesso somente leitura, você pode atribuir-lhe a função
snc_read_only
.
Criar um aplicativo OAuth
Esta etapa reúne detalhes de autenticação do ServiceNow para integração com o Databricks.
No menu Todos , procure OAuth do sistema e, em seguida, clique em Registro do aplicativo.
Clique em Novo > Criar ponto de extremidade da API OAuth para clientes externos.
Insira um nome para o aplicativo.
Para o âmbito de autenticação , insira
useraccount
.(Apenas OAuth padrão) Em URL de redirecionamento, digite
https://<databricks-workspace-url>/login/oauth/servicenow.html
. Substitua<databricks-workspace-url>
pelo URL completo do espaço de trabalho Databricks (por exemplo,https://adb-4385079616193792.12.azuredatabricks.net
).Observação
Ignore esta etapa se estiver usando OAuth com atualização automatizada de token.
Clique em Enviar.
Copie a ID do Cliente e o Segredo do Cliente.
Obter o ID da instância
O ID da instância é a primeira parte do URL de login da conta ServiceNow:
https://<instanceid>.service-now.com
Por exemplo, se a página inicial da sua instância ServiceNow estiver https://abc.service-now.com
, o ID da instância será abc
.
(Hereditariedade) Obter um nome de utilizador e uma palavra-passe
Observação
Esta etapa só é necessária para OAuth com atualização automatizada de token. Em vez disso, a Databricks recomenda o uso de OAuth padrão. O OAuth com atualização automatizada de token só é suportado para conexões criadas usando APIs do Databricks. Não há suporte na interface do usuário do Databricks.
Obtenha o nome de usuário e a senha de um usuário ativo do ServiceNow.
Ativar indexação na coluna do cursor
Para melhorar o desempenho de ingestão, o Databricks recomenda trabalhar com o administrador do ServiceNow para habilitar a indexação do lado do ServiceNow no campo do cursor. A coluna do cursor é selecionada na lista a seguir, em 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 usando as APIs do ServiceNow. A configuração do índice permite que o Databricks evite a verificação completa de toda a coluna do cursor, o que pode criar um gargalo em grandes atualizações. Para obter instruções, consulte Criar um índice de tabela na documentação do ServiceNow.