Esta página describe Calíope 1.7, la versión que estoy construyendo ahora mismo. La 1.6 está en la App Store para Mac, iPad, iPhone, Apple Watch, Apple TV y Apple Vision Pro. El changelog dice en qué versión llegó cada función.
Añade un botón «Abrir en Calíope» a cada tema. Sólo funciona con la app instalada.
Historial completo de consultas ejecutadas con tiempo y estado.
Dónde está: Espacio de Trabajo › Herramientas › Registro SQL
Abre el Registro SQL desde la barra de navegación del workspace. Tiene dos vistas:
- Log persistente — todas las consultas que ejecutas, de esta sesión y de las anteriores, guardadas en un archivo en disco: su número, fecha, conexión, estado (OK/Error), la consulta y lo que respondió el servidor.
- Historial de sesión — las consultas que ejecutó esta ventana, con lo que tardó cada una.
Haz doble clic en una fila (en iPad, tócala) para ver su detalle.
En una sesión de Redis o de MongoDB se llama Registro de comandos y guarda lo que ejecutas tú: los comandos de la consola y, en MongoDB, también las consultas, las escrituras y los índices. Lo que Calíope pide para dibujar una pantalla no se guarda. Nace filtrado por la conexión de la sesión, cada fila se enseña tal cual vino —sin colorear como SQL y con las contraseñas tapadas— y no tiene historial de sesión, porque ahí no hay Editor SQL. En Redis, Abrir en la consola lleva una fila a la consola sin ejecutarla.
Apple Vision Pro: como en el iPad: mira la fila y pellizca para abrirla.
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. Cada vez que Calíope arranca se genera un ID de sesión nuevo, y lo llevan todas las consultas hasta que se cierra. Elige Todas las sesiones para ver el historial completo o selecciona una sesión específica.
Escribe en el campo de búsqueda de la barra del Log para quedarte con las consultas cuyo texto lo contiene. La búsqueda se combina con los filtros de sesión, conexión y resultado: se aplican todos a la vez.
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.
Cada conexión aparece como «nombre (host:puerto)», así que dos perfiles con el mismo nombre en la misma máquina —un MySQL y un Redis, por ejemplo— salen por separado. Las entradas que escribieron versiones anteriores de Calíope llevan «nombre (host)», sin el puerto, y salen como otra 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.
Recarga las entradas del log desde el almacenamiento local.
Dónde está: Log de consultas › Botón de recarga
La lista se pone al día sola: cada consulta que se registra —en esta pestaña o desde otra— y lo que llega de iCloud aparecen sin hacer nada. El botón de recarga (ícono de flecha circular) en la barra del Log vuelve a leer el archivo a mano.
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.
Apple Vision Pro: el menú contextual se abre mirando la fila y pellizcando sin soltar.
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 "Limpiar" (icono de papelera) 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.
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/Containers/org.caliope.caliope/Data/Library/Application Support/Caliope/query_log.db
Apple Vision Pro: como en el iPad, pellizca Copiar ruta.
Comparte el historial de consultas entre tus aparatos 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.
- Desactivar y borrar la copia de iCloud — desactiva la sincronización y además borra la copia de iCloud, para todos tus dispositivos; lo que cada uno guarda en local se queda.
Las dos primeras conservan la copia de iCloud: tus otros dispositivos con la sincronización encendida la siguen leyendo.
Indicadores de estado
Icono
Significado
Nube gris (contorno)
Sync desactivado
Nube azul rellena
Sync activo, al día
Indicador de carga
Sincronización en curso
Nube tachada roja
Error de sincronización (mantén el cursor encima para ver el detalle)
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 fuera del alcance de Calíope: ningún servidor mío la lee. Antes de activarla, la confirmación avisa de que el log sincronizado puede llevar información sensible —contraseñas escritas en SQL, datos personales o financieros—, y mientras la sincronización está encendida el mismo aviso queda arriba del log persistente.
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:
Error
Causa
Solución
"No has iniciado sesión en iCloud"
La cuenta de iCloud no está activa
Abre Configuración del sistema → Cuenta de Apple
"iCloud no disponible temporalmente"
Servidores de Apple caídos o red sin cobertura
Espera unos minutos y pulsa Reintentar
"Restricciones en la cuenta"
Control parental o MDM bloquea CloudKit
Contacta al administrador de tu dispositivo
"No se pudo verificar el estado"
Sin conexión a internet al arrancar
Comprueba la red y pulsa Reintentar
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.
Calíope envía una notificación cuando la sincronización iCloud del log falla silenciosamente.
Dónde está: Calíope › Ajustes › General → 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 Ajustes › General › Notificaciones y usa el toggle Fallo de sincronización iCloud. Este toggle solo aparece si la sincronización con iCloud está encendida en Ajustes.
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
Desde el menú de una fila o desde su detalle, un botón lleva la sentencia al Editor SQL sin ejecutarla.
Dónde está: Espacio de Trabajo › Herramientas › Registro SQL
Desde el menú de una fila, o desde la hoja de detalle, Abrir en editor lleva la sentencia al Editor SQL sin ejecutarla. En el Mac se abre en una pestaña nueva; fuera del Mac el editor pasa al frente con la sentencia en lugar de lo que tuviera. El historial de sesión funciona igual.
Con Redis la opción es Abrir en la consola y lleva el comando a la consola. Con MongoDB no se ofrece.
Palabras clave: abrir en editor, registro, sentencia, historial, consola
En el Mac, ⌘P con el log persistente delante imprime las filas que pasan los filtros, cada una con su sentencia entera.
Dónde está: Atajo de teclado: ⌘P
En el Mac, con el log persistente delante, ⌘P imprime las filas que pasan los filtros: cada una con su número, fecha, conexión, respuesta y la sentencia entera, sin recortar. El historial de sesión no se imprime.