# Consultas

> Haz tus propias preguntas sobre tus datos de prueba, lee las respuestas como tablas y gráficos, expórtalas y guarda las consultas que reutilizas.

**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](https://docs.probara.net/es/guides/dashboards/) como widget en vivo.

| Pregunta                             | Respuesta                                                                                                           |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| ¿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](https://docs.probara.net/es/guides/billing/).

## 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:

| Columna         | Qué muestra                                                           |
| --------------- | --------------------------------------------------------------------- |
| **Nombre**      | El nombre, con la descripción debajo                                  |
| **Propietario** | El miembro que la creó, o **Antiguo miembro** si dejó la organización |
| **Visibilidad** | **Pública** o **Privada**                                             |
| **Actualizada** | Cuá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](https://docs.probara.net/es/guides/pql-reference/).

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](https://docs.probara.net/es/guides/pql-reference/#errores) 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:

| Modo            | Qué necesita                                                                                        |
| --------------- | --------------------------------------------------------------------------------------------------- |
| **Tabla**       | Cualquier consulta.                                                                                 |
| **Barras**      | Una consulta agregada con un grupo y una medida, como `SELECT status, count() ... GROUP BY status`. |
| **Líneas**      | Una consulta agregada con un intervalo de tiempo, como `bucket(created, month)`, y una medida.      |
| **Anillo**      | Una consulta agregada con un grupo y una medida.                                                    |
| **Valor único** | Una 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](https://docs.probara.net/es/developers/api/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ón      | Quién puede verla                                                                              |
   | ----------- | ---------------------------------------------------------------------------------------------- |
   | **Pública** | Todos los miembros de la organización.                                                         |
   | **Privada** | Tú, 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](https://docs.probara.net/es/guides/dashboards/#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](https://docs.probara.net/es/guides/user-profile/). Con **Detectado automáticamente**, usan UTC.

## Siguiente paso

- Aprende el lenguaje en la [referencia del lenguaje PQL](https://docs.probara.net/es/guides/pql-reference/).
- Pon una consulta guardada en un dashboard en [Dashboards](https://docs.probara.net/es/guides/dashboards/#widgets-de-consulta).
- Envía consultas desde código con la [API de PQL](https://docs.probara.net/es/developers/api/pql/) y la [API de consultas guardadas](https://docs.probara.net/es/developers/api/saved-queries/), o desde un agente de IA con el [servidor MCP](https://docs.probara.net/es/developers/mcp-tools/).