La pantalla Consultas de Portail ZAPP (menú Administración › Instancia y operaciones › Consultas) guarda consultas SQL de lectura sobre la base de datos de la instancia, para ejecutarlas cuando se necesite y exportar su resultado. Una consulta guardada también puede alimentar una lista en un formulario dinámico o ser lanzada por una tarea programada (ver «Planificar las tareas»).
La pantalla está reservada a los Administradores.
La lista de consultas
Para cada consulta, la lista muestra su N.º, su Nombre, su Descripción, la columna Procedimiento almacenado (Sí si lo es) y los Grupos autorizados: el número de grupos, o la etiqueta Pública cuando no se ha elegido ningún grupo. El campo Buscar… busca en el nombre y la descripción.
En cada fila, el botón de reproducción abre la ejecución y el lápiz abre la edición.
Crear y editar una consulta
Nueva consulta pide:
- N.º: un número de al menos 1000 (convención: 1000 en adelante), que ordena la lista;
- Nombre y Descripción;
- Código: identificador estable y único que usan la importación y la exportación entre instancias. Elígelo de una vez por todas;
- Procedimiento almacenado: márcalo si el campo SQL contiene solo el nombre de un procedimiento (
nombreoesquema.nombre, nada más); - SQL: el texto de la consulta;
- Grupos autorizados: los grupos cuyos miembros pueden ejecutar la consulta. Vacío = accesible para todos.
Para evitar un error de manipulación, se rechaza una consulta que contenga una de las palabras INSERT, UPDATE, DELETE, DROP, ALTER, EXEC, TRUNCATE, CREATE, GRANT o REVOKE, aunque la palabra solo aparezca en un comentario o en un texto entre comillas. También se rechaza un código ya utilizado. En estos casos el formulario vuelve a mostrarse sin guardarse.
Este control es una protección contra errores, no una protección completa: solo una conexión de solo lectura dedicada a las consultas, que tu proveedor de alojamiento puede configurar, impide realmente cualquier escritura. Sin ella, las consultas se ejecutan con los derechos de la aplicación.
Ejecutar una consulta y exportar el resultado
La pantalla de ejecución muestra a la izquierda los Parámetros: un campo por cada nombre precedido de @ en el SQL (por ejemplo @inicio en WHERE fecha_creacion >= @inicio::date). Los valores se transmiten como texto: conviértelos en el SQL cuando la columna no sea de texto. Un parámetro vacío equivale a «sin valor» (NULL). Un procedimiento almacenado se ejecuta sin parámetros.
Haz clic en Ejecutar. El resultado aparece a la derecha:
- en una cuadrícula cuando el módulo Cuadrículas de datos está instalado;
- si no, en una tabla precedida del número de filas y de la duración de la ejecución.
Un error SQL se muestra en lugar del resultado. Tras una ejecución, Exportar CSV y Exportar Excel vuelven a lanzar la consulta con los mismos parámetros y descargan el resultado completo.
Un administrador que no pertenece a ninguno de los grupos autorizados de una consulta no puede ejecutarla. Cada ejecución queda registrada (autor, duración, número de filas, posible error).
Eliminar una consulta
En la pantalla de edición, Eliminar elimina la consulta tras confirmación, junto con el registro de sus ejecuciones. La eliminación es definitiva: comprueba antes que ninguna lista de formulario ni tarea programada dependa de ella.
Lo que conviene saber
- Una consulta Pública puede ejecutarla cualquier persona que llegue a un punto de ejecución, en particular los usuarios de un formulario dinámico con una lista basada en ella. Restríngela por grupos en cuanto devuelva datos sensibles.
- Para una lista de formulario, la primera columna del resultado es el valor guardado y la segunda la etiqueta mostrada; solo se ofrecen los 500 primeros valores.
- Una tarea programada que lanza una consulta no pasa por el control de los grupos autorizados.
Ver también
- «Gestionar los grupos»: los grupos que autorizar.
- «Configurar los permisos»: el acceso a las pantallas del módulo.