Dépanner le connecteur Vimeo

info

Bêta

Cette fonctionnalité est en version bêta. Pour l’utiliser, un administrateur de workspace doit activer Lakeflow Connect for Vimeo sur la page Previews . Consultez Gérer les aperçus Databricks.

La plupart des erreurs de connecteur Vimeo proviennent d’un jeton d’accès personnel non valide ou auquel il manque une étendue (HTTP 401 ou 403), d’un compte sans le plan Vimeo requis (HTTP 404) ou de limites de débit de l’API (HTTP 429). Les sections suivantes expliquent la cause de chaque erreur et la façon de la résoudre.

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

Le pipeline ne parvient pas à s’authentifier ou manque d’autorisation

Cause : Vimeo a renvoyé une réponse HTTP 401 ou 403. Cela signifie généralement que le jeton d’accès personnel n’est pas valide ou a expiré, ou qu’il lui manque une portée requise. Pour audit_logs, cela peut également signifier que le jeton ne provient pas d’un propriétaire ou d’un administrateur de compte utilisant une application créée sur un compte Enterprise avec les logs d’audit activés.

Solution :

1. Vérifiez que le Personal Access Token (jeton d’accès personnel) et l’ Account Owner User ID (identifiant utilisateur du propriétaire du compte) de la connexion Unity Catalog correspondent aux identifiants de la configuration source.
2. Vérifiez que le jeton inclut les portées public, private et stats. Les portées sont fixes lors de la génération du jeton ; générez donc un nouveau jeton s'il manque une portée.
3. Pour ingérer audit_logs, vérifiez que le compte est un compte Enterprise avec les logs d'audit activés, que le propriétaire du jeton est un propriétaire ou un administrateur de compte et que l'application API a été créée sur le compte Enterprise. Si l'application a été créée sur un autre compte, créez une application sur le compte Enterprise et générez un nouveau jeton à partir de celle-ci.

Pour plus de détails, consultez Configurer l'authentification à Vimeo.

Le pipeline échoue avec HTTP 404

Cause : Vimeo a retourné une réponse HTTP 404 pour un endpoint d’équipe ou de logs d’audit. Cela signifie généralement que le compte du jeton n’est pas sur un plan avec des fonctionnalités d’équipe, comme un compte gratuit. Pour audit_logs, cela peut aussi signifier que le compte n’est pas un compte Enterprise.

Solution :

1. Appelez GET https://api.vimeo.com/me avec le jeton d'accès personnel et vérifiez le champ account. Les données relatives à l'équipe, aux membres de l'équipe et aux rôles de l'équipe nécessitent un forfait Team ou Enterprise payant, et audit_logs nécessite enterprise.
2. Vérifiez que l’ ID utilisateur du propriétaire du compte dans la connexion Unity Catalog est bien l’ID du propriétaire de l’équipe. Voir Rechercher l’ID utilisateur du propriétaire du compte.
3. Pour ingérer audit_logs, vérifiez que l'application API a été créée sur le compte Enterprise, puis générez un nouveau jeton à partir de celle-ci.

Limite de débit de l’API Vimeo dépassée

Cause : Vimeo a retourné une réponse HTTP 429 car les requêtes ont dépassé la limite de taux de l’API.

Solution :

Le connecteur attend et réessaie automatiquement avec un backoff exponentiel. Si cela se produit de manière répétée, réduisez le nombre de pipelines simultanés qui partagent le même jeton d'accès personnel.

API Vimeo temporairement indisponible

Cause : Vimeo a retourné une erreur serveur transitoire (HTTP 500, 502, 503 ou 504).

Solution :

Le connecteur réessaie automatiquement. Si le problème persiste, patientez, puis exécutez à nouveau le pipeline.