Dépanner le connecteur Zip
Bêta
Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.
Cette page décrit les erreurs courantes que vous pouvez rencontrer avec le connecteur Zip géré et comment les résoudre.
Pour des conseils généraux de dépannage qui s'appliquent à tous les pipelines d'ingestion gérés, consultez Dépanner les pipelines d'ingestion gérés.
Échec d'authentification du pipeline (HTTP 401)
Cause : La clé API stockée dans votre connexion Unity Catalog n'est pas valide. Zip renvoie le statut 401 (The provided API key is not valid) lorsqu'une clé est mal saisie, expirée ou supprimée.
Solutions:
Vérifiez que le jeton API stocké dans votre connexion Unity Catalog correspond à une clé active dans le tab clés API de Zip. Si la clé a expiré ou n'existe plus, créez une clé et mettez à jour la connexion. Consultez Configurer l'authentification à Zip et Créer une connexion Zip.
Le pipeline échoue avec une erreur d'autorisations (HTTP 403)
**Cause** : Le pipeline ingère un type d'enregistrement auquel votre clé API **Restreinte** ne donne pas accès. Zip bloque l'accès aux types d'enregistrement laissés vides dans la configuration de la clé.
Solutions:
Dans Zip, modifiez la clé restreinte et sélectionnez au moins l'accès en **lecture seule** pour chaque type d'enregistrement ingéré par le pipeline. Alternativement, utilisez une clé **Standard**. Consultez Configurer l'authentification à Zip.
Le pipeline est limité en débit (HTTP 429)
Cause : Zip limite l'API à 150 000 requêtes par jour, par clé API. D'autres applications qui partagent la clé API du connecteur consomment le même quota.
Solutions:
Le connecteur attend et réessaie automatiquement les requêtes soumises à une limitation de débit lors d'une mise à jour de pipeline. Si les mises à jour échouent toujours, créez une clé API dédiée pour le connecteur, réduisez la fréquence d'exécution du pipeline ou ingérez moins de tables. Consultez Configurer l'authentification à Zip.