Executar consulta em linha

Versão 4.0.23.6 (mais recente)

Execute a consulta especificada in-line no corpo da postagem.

Isso permite executar uma consulta conforme definido em JSON no corpo postado. Isso combina as duas ações de postar e executar uma consulta em uma única etapa.

Veja um exemplo de corpo em json:

{
  "model":"thelook",
  "view":"inventory_items",
  "fields":["category.name","inventory_items.days_in_inventory_tier","products.count"],
  "filters":{"category.name":"socks"},
  "sorts":["products.count desc 0"],
  "limit":"500",
  "query_timezone":"America/Los_Angeles"
}

Ao usar o SDK do Ruby, isso seria transmitido como um hash do Ruby, como:

{
 :model=>"thelook",
 :view=>"inventory_items",
 :fields=>
  ["category.name",
   "inventory_items.days_in_inventory_tier",
   "products.count"],
 :filters=>{:"category.name"=>"socks"},
 :sorts=>["products.count desc 0"],
 :limit=>"500",
 :query_timezone=>"America/Los_Angeles",
}

Isso retornará o resultado da execução da consulta no formato especificado pelo parâmetro "result_format".

Formatos compatíveis:

formato_do_resultado Descrição
json JSON simples
json_detail [informações_técnicas_do_json] Dados de linha mais metadados que descrevem os campos, tabelas dinâmicas, cálculos de tabela e outros aspectos da consulta
csv Valores separados por vírgula com um cabeçalho
.txt Valores separados por tabulação com um cabeçalho
html HTML simples
MD Markdown simples
xlsx Planilha do MS Excel
sql Retorna o SQL gerado em vez de executar a consulta
png Uma imagem PNG da visualização da consulta
jpg Uma imagem JPG da visualização da consulta

Solicitação

POST /queries/run/{result_format}
Tipo de dados
Descrição
Solicitação
HTTPRequest
path
HTTPPath
Expandir definição HTTPPath...
formato_do_resultado
string
Formato do resultado
body
Corpo HTTP
Expandir definição HTTPBody...
body
consulta em linha
Expandir definição da consulta...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
id
string
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
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.
imagem_largura
integer
Largura da renderização para formatos de imagem.
imagem_altura
integer
Altura da renderização para formatos de imagem.
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

Resposta

200: resultado da consulta

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

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