Database query panel

Resumen

El panel Database query es una herramienta administrativa accesible a través del menú Tools que ofrece acceso directo a la base de datos del motor de flujos de trabajo. Este panel permite a los administradores ejecutar consultas SQL para la resolución de problemas, el análisis de datos y tareas de mantenimiento. Resulta especialmente valioso en instalaciones donde el acceso a la base de datos está restringido o donde la base de datos se encuentra en un servidor independiente.

Disposición del panel

El panel Database query se estructura en tres áreas principales:

Barra de navegación superior: contiene las opciones del menú principal (Home, Designer, Users, Tools, Admin)
Sección del editor de consultas: sección superior con el editor SQL y los controles de ejecución
Sección de resultados: sección inferior que muestra los resultados de la consulta en formato tabular

Sección del editor de consultas

La sección superior ofrece un editor SQL para redactar y ejecutar consultas de base de datos:

Editor SQL

Función	Descripción
Editor multilínea	Área de texto con números de línea para escribir sentencias SQL. Admite consultas de varias líneas con el formato adecuado.
Resaltado de sintaxis	Las palabras clave SQL se resaltan para mejorar la legibilidad (SELECT, FROM, WHERE, etc. aparecen en colores distintos)
Varias sentencias	Permite ejecutar una o varias sentencias SQL simultáneamente. Separe las sentencias con punto y coma (;)
Numeración de líneas	Los números de línea que se muestran a la izquierda ayudan a referenciar líneas concretas en consultas complejas

Controles del editor

Botón	Descripción
EXECUTE	Ejecuta la consulta o consultas SQL escritas en el editor. Los resultados aparecen en la sección Query Results de abajo. El botón se muestra en verde para indicar que es la acción principal.
CLEAR QUERY	Borra todo el contenido del editor SQL, permitiéndole empezar de nuevo con una consulta nueva

Sección de resultados de la consulta

La sección inferior muestra los resultados de las consultas SQL ejecutadas en formato tabular:

Visualización de resultados

Función	Descripción
Indicador de número de filas	Muestra el número total de filas devueltas por la consulta (por ejemplo, “121 rows”). Aparece como una insignia junto al título “Query Results”.
Columnas dinámicas	El número y los nombres de las columnas se adaptan según la consulta. Los encabezados de columna muestran los nombres de los campos devueltos por la sentencia SELECT.
Tabla de datos	Los resultados se presentan en una tabla desplazable con colores de fila alternos para mejorar la legibilidad. Cada fila representa un registro del resultado de la consulta.
Botón CLEAR RESULTS	Elimina los resultados de la consulta actual de la pantalla, permitiéndole limpiar la vista antes de ejecutar una nueva consulta

Operaciones SQL admitidas

El panel Database query admite las operaciones SQL estándar:

Operaciones de consulta (SELECT)

El caso de uso principal es ejecutar consultas SELECT para recuperar información:

-- View all workflow nodes
SELECT * FROM WF_NODE;

-- Find specific process definitions
SELECT * FROM WF_PROCESS_DEFINITION WHERE PD_NAME = 'document_validation';

Operaciones de modificación de datos

El panel también admite operaciones UPDATE, INSERT y DELETE, aunque deben usarse con extrema precaución:

Buenas prácticas

Empiece con consultas SELECT: comience siempre con consultas SELECT para entender los datos antes de intentar modificaciones
Use cláusulas WHERE: incluya cláusulas WHERE para limitar el alcance de las consultas y evitar afectar accidentalmente a toda la base de datos
Pruebe primero en desarrollo: pruebe las consultas en un entorno de desarrollo o preproducción antes de ejecutarlas en producción
Cree copias de seguridad: cree siempre copias de seguridad de la base de datos antes de ejecutar operaciones UPDATE o DELETE
Limite los conjuntos de resultados: use cláusulas LIMIT en tablas grandes para evitar saturar la interfaz con resultados
Documente las consultas: guarde las consultas importantes con comentarios que expliquen su propósito para referencia futura
Consulte con soporte: contacte con soporte antes de realizar operaciones complejas o potencialmente destructivas
Entienda el esquema: familiarícese con el esquema de la base de datos del motor de flujos de trabajo antes de escribir consultas
Use transacciones: para modificaciones con varias sentencias, considere usar transacciones (BEGIN, COMMIT, ROLLBACK)
Supervise el rendimiento de las consultas: tenga en cuenta que las consultas complejas pueden afectar al rendimiento del sistema

Limitaciones y consideraciones

Sin validación de consultas: el panel no valida la sintaxis SQL antes de la ejecución; los errores solo aparecerán después de la ejecución
Sin mecanismo de reversión: las modificaciones de datos no se pueden deshacer automáticamente
Impacto en el rendimiento: las consultas complejas pueden afectar al rendimiento del sistema para todos los usuarios
Límites en el tamaño de los resultados: los conjuntos de resultados muy grandes pueden causar problemas de rendimiento en el navegador
Sin historial de consultas: las consultas ejecutadas previamente no se guardan automáticamente
Mensajes de error limitados: los errores de base de datos pueden no ofrecer información detallada para la resolución de problemas

Resolución de problemas

La consulta no devuelve resultados

Verifique que el nombre de la tabla y de las columnas son correctos
Compruebe si la cláusula WHERE es demasiado restrictiva
Asegúrese de que los datos que busca existen en la base de datos

Error: la tabla no existe

Confirme que el nombre de la tabla coincide con el esquema del motor de flujos de trabajo
Compruebe que está consultando la base de datos correcta
Los nombres de las tablas pueden distinguir mayúsculas y minúsculas según la base de datos

La consulta agota el tiempo de espera

Simplifique la consulta o añada condiciones WHERE más específicas
Añada índices a las columnas consultadas con frecuencia
Divida las consultas complejas en partes más pequeñas