Aller au contenu principal
Dernière mise à jour le

Dépanner le connecteur Okta

info

Bêta

Cette fonctionnalité est en bêta. Pour l'utiliser, un administrateur de workspace doit activer Lakeflow Connect for Okta depuis la page Aperçus . Consultez Gérer les aperçus Databricks.

Résoudre les erreurs d’authentification, d’autorisation, de limitation du débit et de service temporaire à partir du connecteur Okta géré dans Lakeflow Connect.

Pour obtenir des conseils de dépannage généraux qui s’appliquent à tous les pipelines d’ingestion managés, consultez la section Dépanner les pipelines d’ingestion managés.

Le pipeline ne parvient pas à s’authentifier​

Cause : Okta a renvoyé une réponse HTTP 401. Le domaine ou le jeton d’API SSWS dans la connexion au Unity Catalog n’est pas valide, le jeton a été révoqué ou l’administrateur qui a créé le jeton est désactivé.

Solution :

  1. Vérifiez que le domaine contient votre domaine d’organisation Okta, par exemple company-name.okta.com.
  2. Dans la console d’administration Okta, accédez à Security > API > Tokens .
  3. Confirmez que le jeton est actif et que son propriétaire est un administrateur actif.
  4. Si nécessaire, créez un jeton et mettez à jour la valeur Jeton SSWS dans la connexion au Unity Catalog.

Pour plus de détails sur la configuration, consultez Configurer l’authentification pour Okta et Créer une connexion Okta.

Le pipeline échoue avec une erreur d’autorisation​

Cause : Okta a renvoyé une réponse HTTP 403 car l’administrateur propriétaire du jeton d’API ne peut pas lire une ressource ingérée par le pipeline.

Solution :

Créez le jeton API avec un compte administrateur remplissant les prérequis, puis mettez à jour la valeur du jeton SSWS dans la connexion Unity Catalog. Vous pouvez également supprimer les tables concernées du pipeline.

Limite de débit de l’API Okta dépassée​

Cause : Okta a renvoyé une réponse HTTP 429 car les requêtes ont dépassé une limite de débit de l’API Okta.

Solution :

Le connecteur attend que la limite de débit soit Reset et retente automatiquement l’opération. Si la limitation de débit persiste :

  1. Dans la console d’administration Okta, accédez à Security > API > Tokens .
  2. Sélectionnez le jeton API utilisé par la connexion Unity Catalog.
  3. Sous Limites de taux de jetons , cliquez sur Modifier .
  4. Si la politique de votre organisation le permet, augmentez le pourcentage de chaque limite de débit API alloué au jeton.
  5. Réduisez le nombre de pipelines simultanés qui utilisent le même jeton.

API Okta temporairement indisponible​

Cause : Okta a renvoyé une erreur de serveur HTTP 5xx.

Solution :

Le connecteur relance automatiquement les erreurs temporaires de serveur. Si le problème persiste après les tentatives, attendez, puis exécutez à nouveau le pipeline.

Sur cette page