Pular para o conteúdo principal

Solucionar problemas do conector Okta

info

Beta

Este recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect para Okta na página Previews . Consulte Gerenciar prévias do Databricks.

Resolva erros de autenticação, permissão, limite de taxa e erros temporários de serviço do conector Okta gerenciado no Lakeflow Connect.

Para obter orientação geral de solução de problemas que se aplica a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

Falha do pipeline ao autenticar​

Causa : O Okta retornou uma resposta HTTP 401. O token da API de domínio ou SSWS na conexão do Unity Catalog não é válido, o token foi revogado ou o administrador que criou o token foi desativado.

Solução :

  1. Confirme se Domain contém seu domínio da organização Okta, como company-name.okta.com.
  2. No console de administração do Okta, vá para Security > API > Tokens .
  3. Confirme que o token está ativo e que o seu proprietário é um administrador ativo.
  4. Se necessário, crie um token e atualize o valor do Token SSWS na conexão do Unity Catalog.

Para obter detalhes da configuração, consulte Configurar autenticação para Okta e Criar uma conexão Okta.

O pipeline falha com um erro de permissão​

Causa : o Okta retornou uma resposta HTTP 403 porque o administrador proprietário do token de API não pode ler um recurso que o pipeline ingere.

Solução :

Crie o tokens de API com uma account de administrador que atenda aos pré-requisitos e, em seguida, atualize o valor do Token SSWS na conexão do Unity Catalog. Como alternativa, remova as tabelas afetadas do pipeline.

Limite de taxa da API do Okta excedido​

Causa : o Okta retornou uma resposta HTTP 429 porque as solicitações excederam um limite de taxa da API do Okta.

Solução :

O conector espera até que o limite de taxa seja Reset e tenta novamente automaticamente. Se a limitação de taxa continuar:

  1. No console de administração do Okta, vá para Security > API > Tokens .
  2. Selecione o token de API que a conexão do Unity Catalog usa.
  3. Em Limites de taxa de tokens , clique em Editar .
  4. Se a política da sua organização permitir, aumente a porcentagem de cada limite de taxa de API alocada ao token.
  5. Reduza o número de pipelines concorrentes que usam o mesmo token.

API do Okta temporariamente indisponível​

Causa : o Okta retornou um erro de servidor HTTP 5xx.

Solução :

O conector tenta novamente erros temporários do servidor automaticamente. Se o problema persistir após as novas tentativas terminarem, aguarde e faça a execução do pipeline novamente.