Documentación · Guías

Consultas

Consultas responde preguntas que las páginas integradas no cubren. Escribes una consulta en Probara Query Language (PQL), la ejecutas y lees la respuesta como una tabla o un gráfico. Guarda una consulta para reutilizarla, y agrega una consulta guardada a un dashboard como widget en vivo.

PreguntaRespuesta
¿Qué planes incluyen Consultas?Pro y Enterprise (y durante una prueba). En Free, el elemento abre el diálogo de actualización de plan.
¿Quién puede ejecutar una consulta?Todos los miembros, incluidos los lectores. Los resultados solo incluyen los proyectos a los que tienes acceso.
¿Quién puede guardar una consulta?Propietario, Administrador y Miembro. Lector no puede.
¿Quién ve una consulta pública?Todos los miembros de la organización.
¿Quién ve una consulta privada?Su creador, los propietarios y administradores de la organización, y los miembros y grupos elegidos para ella.
¿Quién puede cambiarla o eliminarla?Su creador, y los propietarios y administradores de la organización.

Planes

Las consultas usan los mismos planes que los dashboards: Pro y Enterprise. En Free, Consultas sigue en la navegación superior, junto a Dashboards. Al hacer clic, se abre el diálogo de actualización de plan, con el botón Ver planes.

Si tu organización pasa a Free, no se elimina nada. Las consultas guardadas se conservan y vuelven cuando la organización vuelve a Pro o Enterprise. Consulta Facturación.

Abrir Consultas

Haz clic en Consultas en la navegación superior. El listado muestra las consultas guardadas que puedes ver, de la más reciente a la más antigua:

ColumnaQué muestra
NombreEl nombre, con la descripción debajo
PropietarioEl miembro que la creó, o Antiguo miembro si dejó la organización
VisibilidadPública o Privada
ActualizadaCuándo cambió la consulta por última vez

Busca por nombre con Buscar consultas. En el menú de acciones de una fila (⋯) están Abrir, Editar ajustes, Duplicar y Eliminar. Para escribir una consulta nueva, haz clic en Nueva consulta.

Escribir y ejecutar una consulta

  1. Haz clic en Nueva consulta, o abre una consulta guardada, y escribe tu consulta en el cuadro Consulta.
  2. Ejecútala con Ctrl+Intro o Cmd+Intro, o haz clic en Ejecutar.
  3. Lee los resultados debajo del editor.

Mientras escribes, el editor sugiere palabras clave, entidades, campos, valores de enumeración, funciones, operadores, campos personalizados, miembros y nombres de consultas guardadas. Marca los problemas a medida que escribes y los cuenta. Para la sintaxis completa, consulta la referencia del lenguaje PQL.

El texto de la consulta se guarda en la dirección de la página. Copia el enlace para compartir un borrador con un compañero que pueda ver los mismos proyectos.

Leer un error

Cuando una consulta tiene un problema, el área de resultados lista los problemas con su posición, por ejemplo Línea 2, columna 14. Cada problema tiene un código, que la referencia del lenguaje explica junto con lo que hay que cambiar.

Dos mensajes requieren otra solución:

  • La consulta supera los 4.000 caracteres. Acórtala.
  • Todavía no disponible. La parte indicada entre comillas no es compatible por ahora. Quítala mientras tanto.

Leer los resultados

  • La tabla muestra una fila por registro, o una fila por grupo en una consulta agregada. Una fila enlaza con su registro cuando la aplicación tiene una página para él, como un caso o una suite.
  • Los resultados se muestran en páginas de 50 filas por defecto. Agrega LIMIT (hasta 500) y OFFSET (hasta 10.000) para cambiar el tamaño de página y el punto de inicio. Usa los números de página, o Anterior y Siguiente, para moverte entre páginas.
  • Cuando coinciden más filas de las que PQL cuenta, el total dice 10.000+.
  • Una consulta agregada muestra como máximo 1.000 grupos. El aviso “Solo se muestran los primeros 1.000 grupos. Añade una condición para acotar los resultados.” indica que el resto no se muestra.
  • Sin resultados significa que ningún registro coincide en los proyectos a los que tienes acceso.
  • Una consulta sobre resultados incluye los resultados de los casos archivados, porque archivar conserva el historial de ejecución. Para dejarlos fuera, añade case.archived = false, como en FROM results WHERE case.archived = false.
  • Un valor vacío se muestra como Sin valor. Los valores de sí o no se muestran como Sí y No.
  • Una página posterior al último resultado muestra el aviso «Esta página queda después del último resultado». Haz clic en Volver a la primera página.

Proyectos ocultos

Si la consulta coincide con proyectos a los que no puedes acceder, los resultados lo indican. Por ejemplo: “No incluye 2 proyectos a los que no tienes acceso.” Lee las cifras como parciales, no como el total. Los proyectos archivados y bloqueados nunca se incluyen, para nadie.

Elegir Mostrar como

Elige un modo de la lista Mostrar como para presentar el mismo resultado de otra forma:

ModoQué necesita
TablaCualquier consulta.
BarrasUna consulta agregada con un grupo y una medida, como SELECT status, count() ... GROUP BY status.
LíneasUna consulta agregada con un intervalo de tiempo, como bucket(created, month), y una medida.
AnilloUna consulta agregada con un grupo y una medida.
Valor únicoUna consulta agregada que devuelve exactamente una fila.

Un modo que no encaja con el resultado aparece desactivado en la lista. Pasa el cursor sobre él para leer el motivo, por ejemplo “Necesita un intervalo de tiempo, como bucket(created, month).” Los gráficos dibujan solo las filas de la página actual.

Exportar CSV

Exportar CSV descarga las filas de la página actual. El archivo está pensado para hojas de cálculo y otras herramientas:

  • Las horas están en UTC, en formato ISO.
  • Las duraciones están en milisegundos.
  • El archivo está en UTF-8 con marca de orden de bytes, y sus líneas terminan en CRLF.
  • El texto que una hoja de cálculo podría ejecutar como fórmula se escapa.

Para exportar más de una página, usa la exportación completa. Descarga hasta 10.000 filas, o hasta 1.000 grupos en una consulta agregada. La misma exportación está disponible en la API de PQL.

Guardar una consulta

  1. Haz clic en Guardar en el editor. Se abre el diálogo Guardar consulta.

  2. Escribe un Nombre, de hasta 120 caracteres, y una Descripción opcional, de hasta 2.000 caracteres.

  3. Elige Quién puede verla:

    OpciónQuién puede verla
    PúblicaTodos los miembros de la organización.
    PrivadaTú, los miembros y grupos que elijas, y los propietarios y administradores de la organización.

  4. En el caso de Privada, elige a las personas en la pestaña Miembros y a los grupos en la pestaña Grupos. El nombre de cada pestaña indica cuántos tiene, y una elección se quita con su ×.

  5. Haz clic en Guardar consulta.

Los nombres son únicos en la organización, y la comparación no distingue mayúsculas de minúsculas. Si el nombre ya existe, el diálogo dice “Ya existe una consulta con este nombre.”

Una vez guardada una consulta:

  • Guardar guarda tus cambios en ella. El texto que difiere de la consulta guardada se marca como Cambios sin guardar. Si sales de la página con cambios sin guardar, aparece “¿Descartar los cambios sin guardar?”, con Seguir editando y Descartar cambios.
  • Guardar como guarda el texto actual como una consulta nueva. La copia conserva la misma visibilidad y empieza sin miembros ni grupos.
  • Duplicar, en el menú de acciones del listado, crea una copia llamada <nombre> (copy). Si ese nombre ya está en uso, la copia se llama <nombre> (copy 2), después (copy 3), y así sucesivamente.

Cambiar los ajustes de una consulta

Haz clic en Editar ajustes en el listado, o abre la consulta y elige Ajustes de la consulta. Puedes cambiar el nombre, la descripción y quién puede ver la consulta. Haz clic en Guardar ajustes.

Solo el creador y los propietarios y administradores de la organización pueden cambiar una consulta. Cualquier otra persona que abra sus ajustes ve “No puedes cambiar esta consulta.”

Eliminar una consulta

En el listado, abre el menú de acciones de la fila (⋯), elige Eliminar y confirma con Eliminar consulta. La consulta se elimina para todas las personas que pueden verla, y no se puede deshacer.

Si un widget de un dashboard usa la consulta, el widget permanece en el dashboard en estado de “consulta eliminada”. Un editor lo quita del dashboard. Consulta Widgets de consulta.

Quién puede ver una consulta

  • Una consulta pública es visible para todos los miembros.
  • Una consulta privada es visible para su creador, los propietarios y administradores de la organización, y los miembros y grupos elegidos para ella.
  • Una consulta que no puedes ver no aparece en el listado. Si abres su enlace, aparece “Esta consulta no existe o no puedes verla.”

Fechas y zonas horarias

Las fechas y los tiempos relativos, como now(-7d) y startOf(week), usan la Zona horaria de tu perfil. Con Detectado automáticamente, usan UTC.

Siguiente paso

Más guías