Solucionar problemas do conector Okta
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 :
- Confirme se Domain contém seu domínio da organização Okta, como
company-name.okta.com. - No console de administração do Okta, vá para Security > API > Tokens .
- Confirme que o token está ativo e que o seu proprietário é um administrador ativo.
- 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:
- No console de administração do Okta, vá para Security > API > Tokens .
- Selecione o token de API que a conexão do Unity Catalog usa.
- Em Limites de taxa de tokens , clique em Editar .
- Se a política da sua organização permitir, aumente a porcentagem de cada limite de taxa de API alocada ao token.
- 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.