Criar consulta

Versão 4.0.23.2

Crie uma consulta.

Isso permite criar uma nova consulta que pode ser executada mais tarde. As consultas do Looker são imutáveis depois de criadas e não são excluídas. Se você criar uma consulta exatamente como uma existente, ela será retornada e nenhuma nova será criada. Independentemente de uma nova consulta ter sido criada ou não, é possível usar o "id" na consulta retornada com o método "run".

Os parâmetros de consulta são passados como JSON no corpo da solicitação.

Solicitação

POST /queries
Tipo de dados
Descrição
Solicitação
HTTPRequest
body
Corpo HTTP
Expandir definição HTTPBody...
body
Consulta
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...
campos
string
Campos solicitados.

Resposta

200: consulta

Tipo de dados
Descrição
(objeto)
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

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

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py (em inglês)
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py (em inglês)
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py

Ruby

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/ruby/update_look.rb

Kotlin

https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt (em inglês)
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt (em inglês)
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestSmoke.kt (em inglês)

TypeScript

https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts

Swift

https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift (em inglês)
https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift (em inglês)