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

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)

Consulta

que pueden

objeto

Operaciones que el usuario actual puede realizar en este objeto

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

filtro_configuración

objeto

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)

Error

mensaje,

string

Detalles del error

url_documentación

string

Vínculo a la documentación

404: No encontrado

Tipo de datos

Descripción

(objeto)

Error

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)

Error

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)

ValidationError;

mensaje,

string

Detalles del error

errores

ValidationErrorDetail

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)

Error

mensaje,

string

Detalles del error

url_documentación

string

Vínculo a la documentación

Ejemplos

Crear consulta

Crea una consulta.

Solicitud

Respuesta

200: consulta

400: Bad Request

404: No encontrado

409: El recurso ya existe

422: Error de validación

429: Demasiadas solicitudes

Ejemplos

Python

Ruby

Kotlin

TypeScript

Swift