Ejecutar consulta intercalada

Versión 4.0.23.6 (más reciente)

Ejecuta la consulta especificada intercalada en el cuerpo publicado.

Esto permite ejecutar una consulta como se define en JSON en el cuerpo publicado. Esto combina las dos acciones de publicar y ejecutar una consulta en un solo paso.

Este es un cuerpo de ejemplo en 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"
}

Cuando usas el SDK de Ruby, se pasa como un hash de Ruby, como en el siguiente ejemplo:

{
 :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",
}

Esto mostrará el resultado de ejecutar la consulta en el formato especificado por el parámetro "result_format".

Los formatos admitidos son los siguientes:

formato_resultado Descripción
json JSON simple
Detalles de JSON Datos de filas y metadatos que describen los campos, pivotes, cálculos de la tabla y otros aspectos de la consulta
csv Valores separados por comas con un encabezado
txt Valores separados por tabulaciones con un encabezado
html HTML simple
MD Markdown simple
xlsx Hoja de cálculo de MS Excel
sql Muestra el SQL generado en lugar de ejecutar la consulta
png Una imagen PNG de la visualización de la consulta
jpg Una imagen en formato JPG de la visualización de la consulta

Solicitud

POST /queries/run/{result_format}
Tipo de datos
Descripción
Solicitud
HTTPRequest
ruta
Ruta de HTTP
Expandir la definición HTTPPath...
formato_resultado
string
Formato del resultado
body
Cuerpo HTTP
Expandir la definición HTTPBody...
body
consulta intercalada
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...
límite
integer
Límite de filas (puede anular el límite de la consulta guardada)
Aplicando formato
booleano
Aplica el formato especificado en el modelo a cada resultado.
apply_vis
booleano
Aplicar opciones de visualización a los resultados
Almacenamiento en caché
booleano
Obtén resultados de la caché si están disponibles.
ancho de imagen
integer
Ancho del procesamiento para formatos de imagen.
altura_imagen
integer
Altura de procesamiento para formatos de imagen.
generate_drill_links
booleano
Generar vínculos de desglose (solo se aplica al formato 'json_detail').
forzar_producción
booleano
Forzar el uso de modelos de producción incluso si el usuario está en modo de desarrollo. Tenga en cuenta que esta marca no garantiza que se usarán modelos de desarrollo.
solo_caché
booleano
Recupera resultados de la caché incluso si vencieron los resultados.
prefijo_ruta_de_acceso
string
Prefijo para usar en vínculos de perforación (codificados como URL).
rebuild_pdts
booleano
Volver a compilar los PDTS que se usaron en la consulta
servidor_tabla_calc.
booleano
Realizar cálculos de tablas en los resultados de las consultas

Respuesta

200: Resultado de la consulta

Tipo de datos
Descripción
(string)
string

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

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