Ao processar uma chamada de API, o DataWorks Data Service retorna um resultado que pode incluir um código de erro. Esta referência lista os códigos de erro mais comuns, suas causas e as respectivas soluções.
|
Código de erro |
Descrição |
Causa |
Solução |
|
|
success |
A consulta de dados foi concluída com êxito. |
Nenhuma ação necessária. |
|
|
query timeout |
O tempo total de execução da API no Data Service e no banco de dados excedeu o período de timeout definido na configuração de ambiente da API. |
Verifique o período de timeout na configuração de ambiente da API e aumente-o se necessário. Otimize a consulta para reduzir o tempo de execução. |
|
|
param miss |
Um parâmetro obrigatório está ausente na requisição da API. |
Revise a requisição da API e garanta a inclusão de todos os parâmetros obrigatórios. |
|
|
api context failed |
O sistema não conseguiu obter o contexto da API, que inclui conexões de source de dados, informações de AccessKey da source de dados e informações do tenant. |
Verifique se as conexões da source de dados e as credenciais de AccessKey estão configuradas corretamente. |
|
|
datasource query error |
Falha na consulta à source de dados. Possíveis causas: - Erro de sintaxe SQL na consulta- A source de dados não retornou resultado dentro do timeout padrão do sistema (10 segundos)- O limite de conexões da source de dados foi excedido |
- Corrija eventuais erros de sintaxe SQL na consulta.- Se a consulta levar mais de 10 segundos, otimize-a ou entre em contato com o administrador do banco de dados para aumentar o timeout de conexão.- Caso o limite de conexões tenha sido excedido, reduza as consultas simultâneas ou aumente o limite na source de dados. |
|
|
database connection error |
O Data Service falhou ao conectar-se à source de dados. |
Confirme se a source de dados está disponível e se as configurações de conexão estão corretas. |
|
|
rate limit |
A taxa de chamadas da API ultrapassou o limiar do grupo de recursos de serviço público compartilhado. O limite é de aproximadamente 200 QPS por tenant. |
Reduza a taxa de requisições para manter-se abaixo de 200 QPS. Implemente lógica de backoff exponencial e nova tentativa no cliente para lidar adequadamente com o throttling. |
|
Outros códigos de erro |
Outras mensagens de erro |
O erro não está coberto nesta tabela. |
Consulte a mensagem de erro retornada pela API para obter detalhes. Se o problema persistir, participe do grupo do DingTalk do DataWorks para obter suporte técnico. |