Solucionar problemas do conector do Xero

info

Beta

Esse recurso está na Beta. Para usá-lo, um administrador de workspace deve habilitar o Lakeflow Connect for Xero na página Previews . Consulte Gerenciar prévias do Databricks.

Resolva erros de autenticação, acesso e limite de taxa do conector Xero gerenciado no Lakeflow Connect.

Para obter orientação geral de solução de problemas aplicável a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.

Falha na autenticação do pipeline

Causa: Xero retornou uma resposta HTTP 401 e atualizar o access token não corrigiu o problema. Isso geralmente significa uma das seguintes opções: o refresh token expirou, o segredo do cliente do aplicativo foi alterado ou um usuário desconectou o aplicativo da organização. O Xero expira refresh tokens que não são usados por 60 dias. Consulte Perguntas frequentes sobre OAuth 2.0.

Solução:

1. Verifique se o ID do Cliente e o Segredo do Cliente na conexão do Unity Catalog correspondem ao seu aplicativo Xero. Se você gerou um novo segredo, atualize a conexão. Consulte Criar uma conexão Xero.
2. Entre no Xero novamente a partir da conexão para obter um novo token de refresh.
3. Programe o pipeline para execução pelo menos a cada 60 dias para que o token de refresh permaneça válido.

O Xero nega acesso à organização

Causa: O Xero retornou uma resposta HTTP 403. Isso geralmente significa uma das seguintes opções: a opção tenant_id não corresponde a uma organização conectada ao aplicativo, o usuário de autorização perdeu o acesso à organização ou a organização não possui um produto que uma tabela precisa, como o Xero Projects.

Solução:

1. Verifique se tenant_id é o tenantId de uma organização conectada ao aplicativo. Consulte Localizar a ID do tenant.
2. Confirme se o usuário autorizador ainda tem acesso Standard, Advisor ou Administrator com a permissão Connected Apps. Consulte Permissões.
3. Se o erro afetar apenas projects, confirme se a organização assina o Xero Projects e se o usuário autorizador tem uma função de usuário Projects ou remova essa tabela do pipeline.

Limite de taxa da API Xero excedido

Causa: O Xero retornou uma resposta HTTP 429 porque o aplicativo excedeu um limite de API. O Xero limita cada organização a 60 chamadas por minuto e 5 chamadas concorrentes. O limite diário para cada organização depende do nível de preços do desenvolvedor do seu aplicativo. Consulte Limites de API.

Solução:

O conector aguarda o tempo no cabeçalho Retry-After e tenta novamente automaticamente. Se isso acontecer repetidamente, reduza a frequência de programar do pipeline, ingira menos tabelas de refresh completo ou reduza o número de pipelines e outros aplicativos que chamam a mesma organização.