Dépanner le connecteur Verkada
Bêta
Cette fonctionnalité est en version bêta. Les administrateurs du workspace peuvent contrôler l’accès à cette fonctionnalité depuis la page Previews . Consultez Gérer les aperçus Databricks.
Cette page décrit les erreurs courantes que vous pourriez rencontrer avec le connecteur Verkada géré et comment les résoudre.
Pour obtenir des conseils de dépannage généraux applicables à tous les pipelines d’ingestion gérés, consultez Dépanner les pipelines d’ingestion gérés.
Verkada rejette le jeton d’accès
Message d’erreur :
Verkada access token rejected. Refreshing credentials and retrying.
Cause : La clé API stockée dans la connexion Unity Catalog n'est pas valide, a expiré, a été renouvelée ou a été créée pour une région différente de celle de votre organisation.
Solutions:
Vérifiez que la clé API et la région de données dans la connexion Unity Catalog correspondent à votre organisation Verkada. Le connecteur effectue un refresh automatique du jeton à courte durée de vie ; par conséquent, une erreur persistante indique un problème avec la clé API. Si la clé a été renouvelée, créez une nouvelle clé et mettez à jour la connexion. Consultez Configurer l’authentification à Verkada et Créer une connexion Verkada.
Le pipeline échoue avec une erreur d’autorisations
Cause : la clé d’API ne dispose pas d’un accès en lecture seule au produit qu’une table lit — Core pour audit_log, ou Access Control pour users. Les autorisations de la clé d’API Verkada ne peuvent pas être modifiées une fois la clé créée.
Solutions:
Créez une nouvelle clé API avec un accès en lecture seule aux produits requis, puis mettez à jour la connexion Unity Catalog. Consultez Configurer Verkada.
Les demandes sont limitées par le taux
Cause : Verkada limite l’API à 300 requêtes par minute par organisation et renvoie 429 Too Many Requests lorsque la limite est dépassée.
Solutions:
Le connecteur respecte l’en-tête Retry-After et effectue des nouvelles tentatives automatiquement avec un intervalle exponentiel ; la limitation de vitesse est donc généralement temporaire. Si le problème persiste, évitez d’exécuter plusieurs pipelines simultanément sur la même organisation Verkada.