Executar Async Query

Versão 3.1.23.2

Criar uma tarefa de consulta assíncrona

Cria uma tarefa de consulta (job) para executar de maneira assíncrona uma consulta criada anteriormente. Retorna um código de tarefa de consulta.

Use query_task(query_task_id) para verificar o status de execução da tarefa de consulta. Depois que o status da tarefa de consulta atingir "Concluído", use query_task_results(query_task_id) para buscar os resultados da consulta.

Solicitação

POST /query_tasks
Tipo de dados
Descrição
Solicitação
HTTPRequest
body
Corpo HTTP
Expandir definição HTTPBody...
body
Parâmetros de consulta
Expandir a definição de CreateQueryTask...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
ID da consulta
integer
ID da consulta a ser executada
formato_do_resultado
string
Formato de resultado da consulta assíncrona desejado. Os valores válidos são: "inline_json", "json", "json_detail", "json_fe", "csv", "html", "md", "txt", "xlsx", "gsxml".
source
string
Origem da tarefa de consulta
deferred
booleano
Criar a tarefa, mas adiar a execução
look_id
integer
ID da aparência associado à consulta.
ID do painel
string
ID do painel associado à consulta.
consulta
Consulta HTTP
Expandir a definição de HTTPQuery...
limite
integer
Limite de linhas (pode substituir o limite na consulta salva).
aplicar_formatação
booleano
Aplique a formatação especificada pelo modelo a cada resultado.
apply_vis
booleano
Aplique as opções de visualização aos resultados.
Armazenamento em cache
booleano
Receber resultados do cache, se disponível.
generate_drill_links
booleano
Gerar links de detalhamento (aplicável somente ao formato "json_detail").
forçar_produção
booleano
Força o uso de modelos de produção, mesmo que o usuário esteja no modo de desenvolvimento. Essa sinalização falsa não garante que modelos de desenvolvimento serão usados.
somente cache
booleano
Recupere resultados do cache mesmo que eles tenham expirado.
prefixo_do_caminho
string
Prefixo a ser usado para links de detalhamento (codificado pelo URL).
recriar_pdts
booleano
Recriar PDTS usados na consulta.
server_table_calcs
booleano
Realizar cálculos de tabela nos resultados da consulta
imagem_largura
integer
Largura da renderização para formatos de imagem.
imagem_altura
integer
Altura da renderização para formatos de imagem.
campos
string
Campos solicitados

Resposta

200: query_task

Tipo de dados
Descrição
(objeto)
pode
objeto
Operações que o usuário atual pode realizar neste objeto
id
string
ID exclusivo
ID da consulta
integer
ID da consulta
consulta
Consulta
Expandir definição da consulta...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
id
integer
ID exclusivo
modelo
string
Modelo
visualização
string
Explorar nome
campos
string[]
pivôs
string[]
fill_fields
string[]
filters
objeto
Filtros
expressao_de_filtro
string
Expressão de filtro
classificações
string[]
limite
string
Limite
limit_column
string
Limite de colunas
total
booleano
Total
total da linha
string
Total bruto
subtotais
string[]
vis_config
objeto
Propriedades de configuração da visualização. Essas propriedades geralmente são opacas e diferem com base no tipo de visualização usada. Não há um conjunto especificado de chaves permitidas. Os valores podem ser qualquer tipo compatível com JSON. Uma chave de "tipo" com um valor de string geralmente está presente e é usada pelo Looker para determinar qual visualização será exibida. As visualizações ignoram as propriedades vis_config desconhecidas.
configuração_do_filtro
objeto
O valor de "filter_config" representa o estado da IU do filtro na página de exploração de uma determinada consulta. Ao executar uma consulta por meio da IU do Looker, esse parâmetro tem precedência sobre "filtros". Ao criar uma consulta ou modificar uma consulta existente, "filter_config" deve ser definido como nulo. Definir como qualquer outro valor pode causar um comportamento inesperado de filtragem. O formato deve ser considerado opaco.
_UI_sections visíveis
string
Seções de IU visíveis
lesma
string
Slug
dynamic_fields
string
Campos dinâmicos
client_id
string
ID do cliente: usado para gerar URLs de exploração encurtados. Se definido pelo cliente, deve ser uma sequência alfanumérica única de 22 caracteres. Caso contrário, será gerado um.
url_de_compartilhamento
string
Compartilhar URL
url_de_compartilhamento_expandido
string
URL de compartilhamento expandido
url
string
URL expandido
fuso horário_de_consulta
string
Fuso horário da consulta
has_table_calculations
booleano
Tem cálculos de tabela
runtime
number
(OBSOLETO) Tempo de execução (obsoleto)
gerar_links
booleano
gerar ou não links na resposta da consulta.
forçar_produção
booleano
Use modelos de produção para executar a consulta (mesmo que o usuário esteja no modo de desenvolvedor).
prefixo_do_caminho
string
Prefixo a ser usado para links de detalhamento.
Armazenamento em cache
booleano
Se é necessário ou não usar o cache
server_table_calcs
booleano
Se deve ou não executar cálculos de tabela no servidor
somente cache
booleano
Recupere resultados do cache mesmo que eles tenham expirado.
chave_de_cache
string
chave de cache usada para armazenar a consulta em cache.
status
string
Status da tarefa de consulta.
source
string
Origem da tarefa de consulta.
runtime
number
Tempo de execução de consultas anteriores.
recriar_pdts
booleano
Recriar PDTS usados na consulta.
origem_do_resultado
string
Origem dos resultados da consulta.
look_id
integer
ID da aparência associado à consulta.
ID do painel
string
ID do painel associado à consulta.
formato_do_resultado
string
O formato de dados dos resultados da consulta.

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: não encontrado

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

409: recurso já existe

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

422: erro de validação

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
Expandir a definição de ValidationErrorDetail...
campo
string
Campo com erro
código
string
Código do erro
mensagem
string
Mensagem de erro
url_da_documentação
string
Link da documentação
url_da_documentação
string
Link da documentação

429: Solicitações demais

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

Examples