Solucionar problemas do conector do Zoho Books
Beta
Este recurso está em Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
Esta página descreve erros comuns que você pode encontrar com o conector gerenciado do Zoho Books e como resolvê-los.
Access token do Zoho rejeitado
Mensagem de erro:
Zoho access token rejected. Refreshing credentials and retrying.
**Causa:** Zoho retornou uma resposta HTTP 401. Isso geralmente significa uma das seguintes opções: as credenciais OAuth não são válidas, o Self Client não está autorizado para os escopos necessários ou a Região não corresponde ao seu data center da Zoho.
soluções:
O conector atualiza automaticamente as credenciais e tenta novamente. Se o erro persistir em várias execuções do pipeline:
- Verifique se o ID do Cliente , o Segredo do Cliente , o ID da Organização e a Região na conexão do Unity Catalog correspondem ao seu Cliente Zoho Self e à sua organização.
- Confirme se o Cliente Próprio está autorizado para os escopos de somente leitura necessários. Consulte Escopos OAuth obrigatórios.
Para obter detalhes, consulte Configurar autenticação para Zoho Books.
Limite de taxa da API do Zoho Books excedido
Mensagem de erro:
Rate limit exceeded for Zoho Books API. Please retry the pipeline after some time.
Causa: O Zoho retornou uma resposta HTTP 429. O Zoho Books limita a API a 100 solicitações por minuto por organização e a um limite de chamada por dia que escala com seu plano (1.000 chamadas no Gratuito, até 10.000 em níveis superiores). Consulte a introdução à API do Zoho Books.
soluções:
O conector aguarda e tenta novamente automaticamente. Se isso acontecer repetidamente, reduza a frequência de programação do pipeline ou o número de pipelines concorrentes que compartilham a mesma organização Zoho.
API Zoho Books temporariamente indisponível
Mensagem de erro:
Zoho Books API is temporarily unavailable. Please retry the pipeline after some time.
Causa: Zoho retornou um erro transitório do servidor (HTTP 500, 502, 503 ou 504).
soluções:
O conector aguarda e tenta novamente automaticamente. Se o problema persistir, verifique o status do serviço da Zoho.