Obter resultados de consulta assíncrona

Versão 4.0.23.6 (mais recente)

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

GET /query_tasks/{query_task_id}/results
Tipo de dados
Descrição
Solicitação
HTTPRequest
path
HTTPPath
Expandir definição HTTPPath...
id_tarefa_id
string
ID da tarefa de consulta

Resposta

200: os resultados da consulta.

Tipo de dados
Descrição
(string)
string

204: a consulta não está concluída

Tipo de dados
Descrição
(string)
string

400: Solicitação inválida

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

404: o ID da tarefa de consulta não foi encontrado ou os resultados expiraram.

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

Examples