Log de consultas

Historial completo de consultas ejecutadas con tiempo y estado.

Dónde está: Espacio de Trabajo › Herramientas › Registro SQL

Abre el Log de consultas desde la barra de navegación del workspace. Muestra todas las consultas de la sesión actual e históricas con su ID de sesión, timestamp, tiempo de ejecución y estado (OK/Error).

Palabras clave: log, historial, consultas, registro, query log

Muestra solo las consultas de una sesión específica.

Dónde está: Log de consultas › Selector de sesión

El selector Sesión en la barra del Log permite filtrar por sesión de conexión. Cada vez que te conectas al servidor se genera un ID de sesión único. Elige Todas las sesiones para ver el historial completo o selecciona una sesión específica.

Palabras clave: sesión, filtrar, session, ID, filtro

Filtra entradas del log por texto de la consulta.

Dónde está: Log de consultas › Búsqueda

Escribe al menos 2 caracteres en el campo de búsqueda de la barra del Log. El filtro es acumulativo con el filtro de sesión: aplica ambos simultáneamente.

Palabras clave: buscar, search, filtrar, texto, consulta

Muestra solo las consultas de un perfil de conexión específico.

Dónde está: Log de consultas › Selector de conexión

El segundo selector en la barra del Log filtra las entradas por perfil de conexión. Elige el nombre del servidor o perfil en el desplegable para ver únicamente las consultas ejecutadas en ese contexto. Selecciona Todas las conexiones para ver el historial completo.

Palabras clave: conexión, filtrar, perfil, servidor, filtro conexión

Muestra solo consultas exitosas o solo las que generaron error.

Dónde está: Log de consultas › Selector OK / Error

El tercer selector en la barra del Log filtra por estado de ejecución: Todos, OK (solo consultas exitosas) o Error (solo las que fallaron). Combínalo con el filtro de sesión y el de búsqueda de texto para acotar rápidamente las entradas relevantes.

Palabras clave: error, ok, estado, filtrar resultado, éxito, fallo

Recarga las entradas del log desde el almacenamiento local.

Dónde está: Log de consultas › Botón de recarga

Pulsa el botón de recarga (ícono de flecha circular) en la barra del Log para forzar una actualización manual. Útil cuando el log no refleja consultas ejecutadas en otra pestaña o en otra sesión reciente.

Palabras clave: actualizar, recargar, refresh, log, manual

Copia el resultado de una consulta registrada al portapapeles.

Dónde está: Log de consultas › clic derecho › Copiar resultado

Abre el menú contextual de cualquier entrada del Log de consultas —clic derecho en macOS, mantener pulsado en iPad— y selecciona Copiar resultado. El resultado (texto de la respuesta o mensaje de error) se copia al portapapeles sin necesidad de re-ejecutar la consulta.

Palabras clave: copiar, resultado, portapapeles, clipboard, log

Elimina permanentemente todas las entradas del log SQLite.

Dónde está: Log de consultas › Purgar / Limpiar

El log persistente se almacena en una base de datos SQLite local (query_log.db) en el directorio de soporte de la aplicación. Para eliminarlo todo, usa cualquiera de estas dos vías:

- Botón rojo "Limpiar" en la barra de filtros superior.
- Botón "Purgar" en la barra de información del archivo, en la parte inferior de la vista.

En ambos casos Calíope muestra un diálogo de confirmación antes de borrar. La operación elimina todas las filas de la tabla executedqueries; no afecta al historial de sesión (que es en memoria) ni al log de auditoría DDL.

Esta acción no se puede deshacer.

Palabras clave: limpiar, purgar, borrar, eliminar, clear, purge, log, sqlite

Consulta la ubicación del archivo query_log.db y cuánto espacio ocupa.

Dónde está: Log de consultas › Barra de archivo (pie)

La barra inferior del Log persistente muestra, en todo momento:

- Ruta completa del archivo query_log.db (directorio de soporte de la app).
- Tamaño en B, KB, MB o GB según corresponda, actualizado cada vez que se recarga el log.

En macOS — pulsa Mostrar en Finder para abrir el Finder con el archivo seleccionado. Desde ahí puedes hacer una copia de seguridad manual o moverlo.

En iPad — pulsa Copiar ruta para copiar la ruta al portapapeles.

La ruta habitual en macOS es:
~/Library/Application Support/Caliope/query_log.db

Palabras clave: ruta, path, tamaño, size, finder, query_log.db, archivo, ubicación, mb, gb

Comparte el historial de consultas entre Mac, iPad e iPhone mediante iCloud.

Dónde está: Log de consultas › Botón de sincronización iCloud

El icono de nube en la esquina superior derecha del Log de consultas controla la sincronización con iCloud CloudKit. La función está desactivada por defecto y es completamente opcional.

Activar la sincronización

Pulsa el icono de nube (contorno gris) para activarla. Calíope te preguntará:
- Subir historial existente — sube todas las entradas locales actuales a iCloud.
- Solo nuevas entradas — comienza a sincronizar desde ahora sin subir el historial anterior.

A partir de ese momento, cada consulta ejecutada se guarda simultáneamente en la base de datos local y en iCloud. El campo resultado se almacena con un máximo de 500 caracteres.

Desactivar la sincronización

Pulsa el icono de nube rellena (azul) para desactivarla. Calíope te preguntará:
- Descargar historial de iCloud — descarga todas las entradas del iCloud al dispositivo actual.
- No, solo desactivar — desactiva el sync sin tocar los datos locales.

Indicadores de estado

Retención

La misma política de retención configurada para el log local (por defecto 90 días) se aplica automáticamente a los registros en iCloud una vez al día. Así ambos almacenes mantienen el mismo horizonte temporal.

Privacidad

Los datos se guardan en tu cuenta personal de iCloud (base de datos privada de CloudKit), invisible para otros usuarios y para Apple.

Palabras clave: icloud, sync, sincronizar, cloudkit, nube, historial, compartir, ipad, mac

Qué hacer cuando el icono de la nube aparece en rojo.

Dónde está: Log de consultas › Botón de nube rojo

Cuando el icono de sincronización aparece tachado en rojo, pulsa sobre él para ver el detalle del error y las opciones disponibles:

- Reintentar — intenta de nuevo la sincronización. Úsalo si el error fue temporal (sin red, iCloud caído).
- Desactivar sync — desactiva la sincronización sin descargar datos. El historial local no se modifica.

Causas frecuentes y soluciones:

Nota: El estado de la cuenta iCloud se verifica automáticamente al abrir la app. Si el problema se resuelve (p.ej. te conectas a internet), el icono volverá a azul tras ejecutar la siguiente consulta.

Palabras clave: error, icloud, sync, rojo, reintentar, no disponible, cuenta, solucionar

Calíope envía una notificación cuando la sincronización iCloud del log falla silenciosamente.

Dónde está: Calíope › Preferencias › Notificaciones

Si la sincronización iCloud del historial de consultas falla (sin conexión, cuota llena, cuenta no disponible), Calíope puede avisarte con una notificación local para que no pierdas registros sin saberlo.

Escenarios cubiertos:
- Sin conexión a Internet al momento de sincronizar.
- Cuota de iCloud agotada — la notificación usa un mensaje específico indicando que el almacenamiento está lleno.
- Cuenta iCloud temporalmente no disponible.

Activar o desactivar:
Ve a Preferencias › Notificaciones y usa el toggle Fallo de sincronización iCloud. Este toggle solo aparece si la sincronización iCloud del log está habilitada en Preferencias.

El cooldown entre notificaciones es de 15 minutos para evitar spam (la sync se verifica en cada consulta ejecutada).

Palabras clave: notificación, icloud, sync, fallo, cuota, sin conexión, alerta