Obter resultados de consulta assíncrona
Retorna os resultados de uma tarefa de consulta assíncrona se a consulta foi concluída.
Se a tarefa de consulta ainda estiver em execução ou aguardando a execução, essa função retornará 204 Sem conteúdo.
Se o ID da tarefa de consulta for inválido ou os resultados armazenados em cache expirarem, essa função retornará 404 Not Found.
Use query_task(query_task_id) para verificar o status de execução da tarefa de consulta. Chame query_task_results somente depois que o status da tarefa de consulta atingir "Concluído".
Também é possível usar query_task_multi_results() para recuperar os resultados de várias tarefas de consulta assíncronas ao mesmo tempo.
Tratamento de erros SQL:
Se a consulta falhar devido a um erro de banco de dados SQL, a forma como isso será comunicado dependerá do result_format solicitado em create_query_task()
.
Para json_detail
result_format: query_task_results()
responderá com o status HTTP "200 OK" e as informações de erro do banco de dados SQL estarão na propriedade errors
do objeto de resposta. A propriedade "data" estará vazia.
Para todos os outros formatos de resultado: query_task_results()
responderá com o status HTTP 400 Bad Request
, e algumas informações do erro do banco de dados SQL estarão na mensagem de resposta 400, mas não tão detalhadas quanto expressa em json_detail.errors
.
Esses formatos de dados só podem conter dados de linha, e as informações de erro não são dados de linha.
Solicitação
Resposta
200: os resultados da consulta.
204: a consulta não está concluída
400: Solicitação inválida
404: o ID da tarefa de consulta não foi encontrado ou os resultados expiraram.
Examples
Python