Crear consulta

Versión 4.0.23.6 (más reciente)

Crea una consulta.

Esto le permite crear una consulta nueva que puede ejecutar más adelante. Las consultas de Looker son inmutables una vez creadas y no se borran. Si creas una consulta que es exactamente igual a una existente, se mostrará y no se creará una nueva. Ya sea que se cree una consulta nueva o no, puedes usar "id" en la consulta que se muestra con el método "run".

Los parámetros de consulta se pasan como JSON en el cuerpo de la solicitud.

Solicitud

POST /queries
Tipo de datos
Descripción
Solicitud
HTTPRequest
body
Cuerpo HTTP
Expandir la definición HTTPBody...
body
Consulta
Expandir definición de consulta...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
model
string
Modelo
vista
string
Nombre de la exploración
campos
string[]
reorientación
string[]
campo_relleno
string[]
filters
objeto
Filtros
expresión_filtrada
string
Filtrar expresión
ordena
string[]
límite
string
Límite
Límite_columna
string
Límite de columnas
total
booleano
Total
fila_total
string
Total sin procesar
subtotales
string[]
vis_config
objeto
Propiedades de configuración de la visualización Por lo general, estas propiedades son opacas y difieren según el tipo de visualización que se use. No hay un conjunto especificado de claves permitidas. Los valores pueden ser de cualquier tipo compatible con JSON. Una clave de "tipo" con un valor de string suele estar presente y Looker la usa para determinar qué visualización presentar. Las visualizaciones ignoran las propiedades vis_config desconocidas.
filtro_configuración
objeto
filter_config representa el estado de la IU del filtro en la página de exploración para una búsqueda determinada. Cuando se ejecuta una consulta a través de la IU de Looker, este parámetro tiene prioridad sobre los "filtros". Cuando se crea una consulta o se modifica una existente, se debe establecer “filter_config” como nulo. Si se establece en cualquier otro valor, se puede generar un comportamiento de filtrado inesperado. El formato debe considerarse opaco.
secciones_de_IU visibles
string
Secciones visibles de la IU
babosa
string
Slug
campos_dinámicos
string
Campos dinámicos
client_id
string
ID de cliente: Se usa para generar URL de exploración abreviadas. Si lo establece el cliente, debe ser una string alfanumérica única de 22 caracteres. De lo contrario, se generará uno.
URL_compartir
string
Compartir URL
URL_compartida_expandida
string
URL para compartir expandida
url
string
URL expandida
zona horaria de consulta
string
Zona horaria de la consulta
tiene_tablas_cálculas
booleano
Tiene cálculos de tabla
verá la consulta cuando se guarde
HTTPQuery
Expandir definición de HTTPQuery...
campos
string
Campos solicitados.

Respuesta

200: consulta

Tipo de datos
Descripción
(objeto)
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
model
string
Modelo
vista
string
Nombre de la exploración
campos
string[]
reorientación
string[]
campo_relleno
string[]
filters
objeto
Filtros
expresión_filtrada
string
Filtrar expresión
ordena
string[]
límite
string
Límite
Límite_columna
string
Límite de columnas
total
booleano
Total
fila_total
string
Total sin procesar
subtotales
string[]
vis_config
objeto
Propiedades de configuración de la visualización Por lo general, estas propiedades son opacas y difieren según el tipo de visualización que se use. No hay un conjunto especificado de claves permitidas. Los valores pueden ser de cualquier tipo compatible con JSON. Una clave de "tipo" con un valor de string suele estar presente y Looker la usa para determinar qué visualización presentar. Las visualizaciones ignoran las propiedades vis_config desconocidas.
filtro_configuración
objeto
filter_config representa el estado de la IU del filtro en la página de exploración para una búsqueda determinada. Cuando se ejecuta una consulta a través de la IU de Looker, este parámetro tiene prioridad sobre los "filtros". Cuando se crea una consulta o se modifica una existente, se debe establecer “filter_config” como nulo. Si se establece en cualquier otro valor, se puede generar un comportamiento de filtrado inesperado. El formato debe considerarse opaco.
secciones_de_IU visibles
string
Secciones visibles de la IU
babosa
string
Slug
campos_dinámicos
string
Campos dinámicos
client_id
string
ID de cliente: Se usa para generar URL de exploración abreviadas. Si lo establece el cliente, debe ser una string alfanumérica única de 22 caracteres. De lo contrario, se generará uno.
URL_compartir
string
Compartir URL
URL_compartida_expandida
string
URL para compartir expandida
url
string
URL expandida
zona horaria de consulta
string
Zona horaria de la consulta
tiene_tablas_cálculas
booleano
Tiene cálculos de tabla

400: Bad Request

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

404: No encontrado

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

409: El recurso ya existe

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

422: Error de validación

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
Expandir la definición de ValidationErrorDetail...
campo
string
Campo con error
código
string
Código de error
mensaje,
string
Mensaje de información de error
url_documentación
string
Vínculo a la documentación
url_documentación
string
Vínculo a la documentación

429: Demasiadas solicitudes

Tipo de datos
Descripción
(objeto)
mensaje,
string
Detalles del error
url_documentación
string
Vínculo a la documentación

Ejemplos

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.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
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
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestSmoke.kt

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
https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift