Solucionar problemas do conector Vimeo

info

Beta

Este recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect for Vimeo na página Previews . Consulte Gerenciar prévias do Databricks.

A maioria dos erros do conector do Vimeo vem de um access token pessoal que não é válido ou está sem um escopo (HTTP 401 ou 403), uma account sem o plano do Vimeo necessário (HTTP 404) ou limites de taxa da API (HTTP 429). As seções a seguir explicam a causa de cada erro e como resolvê-lo.

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.

O pipeline falha na autenticação ou não tem permissão

Causa: Vimeo retornou uma resposta HTTP 401 ou 403. Isso geralmente significa que o access token pessoal não é válido ou expirou, ou que o token não tem um escopo obrigatório. Para audit_logs, isso também pode significar que o token não vem de um Proprietário da account ou Administrador usando um aplicativo criado em uma account Enterprise com Logs de auditoria habilitados.

Solução:

1. Verifique se o Personal Access Token e o Account Owner User ID na conexão do Unity Catalog correspondem às credenciais da configuração de origem.
2. Verifique se o token inclui os escopos public, private e stats. Os escopos são fixos quando o tokens é gerado; portanto, gere um novo tokens se um escopo estiver faltando.
3. Para ingerir audit_logs, verifique se a account é uma account Enterprise com Logs de auditoria habilitados, se o proprietário do token é um proprietário ou administrador da account e se o aplicativo de API foi criado na account Enterprise. Se o aplicativo foi criado em outra account, crie um novo aplicativo na account Enterprise e gere um novo token a partir dele.

Para obter detalhes, consulte Configurar autenticação para o Vimeo.

O pipeline falhou com HTTP 404

Causa: O Vimeo retornou uma resposta HTTP 404 para um endpoint de equipe ou log de auditoria. Isso geralmente significa que a account do token não está em um plano com recursos de equipe, como uma account gratuita. Para audit_logs, também pode significar que a account não é uma account Enterprise.

Solução:

1. Chame GET https://api.vimeo.com/me com o access token pessoal e verifique o campo account. Os dados da equipe, do membro da equipe e da função da equipe precisam de um plano Team ou Enterprise pago, e audit_logs precisa de enterprise.
2. Verifique se o ID de usuário do proprietário da account na conexão do Unity Catalog é o ID do proprietário da equipe. Consulte Encontrar o ID de usuário do proprietário da account.
3. Para ingerir audit_logs, verifique se o aplicativo de API foi criado na account Enterprise e, em seguida, gere um novo token a partir dele.

Limite de taxa da API do Vimeo excedido

Causa: O Vimeo retornou uma resposta HTTP 429 porque as solicitações excederam o limite de taxa da API.

Solução:

O conector espera e tenta novamente automaticamente com backoff exponencial. Se isso ocorrer repetidamente, reduza o número de pipelines concorrentes que compartilham o mesmo access token pessoal.

A API do Vimeo está temporariamente indisponível

Causa: O Vimeo retornou um erro de servidor transitório (HTTP 500, 502, 503 ou 504).

Solução:

O conector tenta novamente automaticamente. Se o problema persistir, aguarde e execute o pipeline novamente.