Ejecutar consulta asíncrona

Versión 4.0.23.6 (más reciente)

Crea una tarea de consulta asíncrona

Crea una tarea de consulta (trabajo) para ejecutar una consulta creada anteriormente de forma asíncrona. Muestra un ID de tarea de consulta.

Use query_task(query_task_id) para verificar el estado de ejecución de la tarea de consulta. Una vez que el estado de la tarea de la consulta alcance el estado "Complete", use query_task_results(query_task_id) para recuperar los resultados de la consulta.

Solicitud

POST /query_tasks
Tipo de datos
Descripción
Solicitud
HTTPRequest
body
Cuerpo HTTP
Expandir la definición HTTPBody...
body
Parámetros de consulta
Expandir definición de CreateQueryTask...
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
ID de la consulta
string
ID de la consulta que se ejecutará
formato_resultado
string
Formato de resultado de consulta asíncrono deseado. Los valores válidos son los siguientes: "inline_json", "json", "json_detail", "json_fe", "csv", "html", "md", "txt", "xlsx", "gsxml".
source
string
Fuente de la tarea de consulta
deferred
booleano
Crea la tarea, pero aplaza la ejecución
look_id
string
ID de aspecto asociado con la consulta.
id_panel
string
ID del panel asociado con la consulta.
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.
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
ancho de imagen
integer
OBSOLETO. Ancho del procesamiento para formatos de imagen. Ten en cuenta que este método siempre ignora este parámetro.
altura_imagen
integer
OBSOLETO. Altura de procesamiento para formatos de imagen. Ten en cuenta que este método siempre ignora este parámetro.
campos
string
Campos solicitados

Respuesta

200: query_task

Tipo de datos
Descripción
(objeto)
que pueden
objeto
Operaciones que el usuario actual puede realizar en este objeto
id
string
ID único
ID de la consulta
string
ID de la consulta
verá la consulta cuando se guarde
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
generar_vínculos
booleano
si se generan o no vínculos en la respuesta a la consulta.
forzar_producción
booleano
Use modelos de producción para ejecutar consultas (incluso si el usuario está en modo de desarrollador).
prefijo_ruta_de_acceso
string
Prefijo para usar en los vínculos de perforación.
Almacenamiento en caché
booleano
Si se debe usar o no la caché
servidor_tabla_calc.
booleano
Ejecutar o no cálculos de tabla en el servidor
solo_caché
booleano
Recupera resultados de la caché incluso si vencieron los resultados.
clave_caché
string
clave de caché que se usa para almacenar en caché la consulta.
Calendario
string
Estado de la tarea de consulta.
source
string
Fuente de la tarea de consulta.
runtime
número
Entorno de ejecución de consultas anteriores.
rebuild_pdts
booleano
Volver a compilar los PDTS que se usaron en la consulta
fuente_resultado
string
Fuente de los resultados de la consulta.
look_id
string
ID de aspecto asociado con la consulta.
id_panel
string
ID del panel asociado con la consulta.
formato_resultado
string
El formato de datos de los resultados de la consulta.

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