Esta página describe Calíope 1.5, la versión que estamos construyendo ahora mismo. La 1.4 está terminada y en revisión de App Store, y la tienda sirve hoy la 1.3 en el Mac y la 1.2 en iPad. 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.
En el Gestor de Conexiones, pulsa + en la barra lateral izquierda. Introduce un nombre descriptivo, el tipo de servidor (MySQL, MariaDB, Aurora, PostgreSQL o MongoDB), el host, puerto, usuario y contraseña. El campo "Base de datos por defecto" es opcional.
En la sección Opciones del servidor puedes configurar el charset, la cotejación y activar SSL/TLS. Si SSL está activo aparecerán campos para seleccionar el certificado y la clave del cliente.
Palabras clave: perfil, nueva conexión, guardar servidor, host, configurar
Selecciona el perfil en la lista de la barra lateral. El formulario de la derecha se carga con sus datos actuales y puedes editar cualquier campo directamente. Los cambios se guardan automáticamente al conectar o al seleccionar otro perfil.
Para eliminar un perfil hay un tema propio, porque no se puede deshacer y se lleva más de lo que parece: ver Eliminar una conexión.
Eliminar una conexión no borra sólo su dirección y su usuario: se lleva todo lo que Calíope había guardado de ese servidor. Por eso pregunta antes, y por eso la pregunta dice el nombre de la conexión — si no es la que creías, ése es el momento de enterarte.
Desde dónde
- macOS: selecciona el perfil y pulsa − en la barra de abajo de la lista, junto al +. O haz clic derecho sobre la fila y elige Eliminar.
- iPad: selecciona el perfil y pulsa − en la barra inferior; o mantén pulsada la fila y elige Eliminar; o desliza la fila de derecha a izquierda. El deslizamiento no borra al soltar: revela el botón, y la pregunta llega igual. Deslizar en el otro sentido —de izquierda a derecha— es Mover a grupo.
Qué se va con ella
- El perfil, con todos sus datos.
- Su contraseña del Llavero, y también la de SSH y la frase de paso de su clave privada.
- Su historial de consultas, y sus filas del registro de errores y del registro de mensajes del servidor.
- El SQL que tuviera guardado en el editor de esa conexión, y su caché de esquema.
No se puede deshacer. No hay papelera ni deshacer: la confirmación es la única oportunidad de echarse atrás.
En tus otros dispositivos. Con la sincronización de iCloud activada la baja viaja, y la conexión desaparece también allí. Al revés no pasa nada raro: un perfil que creaste en el otro equipo y que éste todavía no había visto no se lee como una baja, así que no se borra solo.
Un grupo entero. Eliminar un grupo elimina también las conexiones que tiene dentro, con la misma pregunta y el mismo alcance; se explica en Organizar perfiles en grupos.
El campo «Host alternativo» del perfil sirve para un servidor al que se llega por dos direcciones distintas. El caso típico es una máquina de desarrollo: desde el propio equipo responde en 127.0.0.1, y desde el iPad hay que usar su dirección en la red local. Como los perfiles se sincronizan entre tus dispositivos, un solo campo de host no puede ser correcto en los dos sitios.
Al conectar se intenta primero el host principal. Si no responde, se intenta el alternativo con el mismo puerto, el mismo usuario, la misma contraseña y las mismas opciones: lo único que cambia es la dirección. Si necesitas también otro puerto, escribe «dirección:puerto» (por ejemplo, 10.0.0.20:3307).
Cuando la sesión entra por el alternativo, aparece una marca junto al nombre del servidor y «Probar conexión» dice a qué dirección respondió, para que sepas siempre contra qué máquina estás trabajando.
Con un túnel SSH el campo se ignora, y no es un olvido: ahí la dirección del servidor la resuelve la máquina del túnel, no tu dispositivo, así que no cambia según desde dónde te conectes.
Palabras clave: host alternativo, segunda dirección, ip local, red local, failover, 127.0.0.1, ipad, dos direcciones
Cuándo hace falta escribirla, qué campos deja de usar Calíope cuando lo haces y dónde queda la contraseña.
Dónde está: Panel lateral › Conexiones › Cadena de conexión
El campo «Cadena de conexión» aparece solo cuando el motor del perfil es MongoDB, y es opcional. Si lo dejas vacío, Calíope arma la conexión con lo que hay arriba: dirección, puerto, usuario, contraseña, TLS y base de datos. Para un servidor normal eso basta.
Escríbela cuando la conexión no se pueda describir con esos campos. Son tres casos: un conjunto de réplica, que necesita varias direcciones y el nombre del conjunto; una base de autenticación distinta de la habitual, que se indica con authSource; y un clúster de Atlas, cuya dirección empieza por mongodb+srv:// y no lleva puerto que teclear.
Cuando la escribes manda sobre los campos de arriba: usuario, contraseña, TLS y opciones salen de ella. Hay dos excepciones. Si el perfil usa un túnel SSH, la dirección la pone el túnel y no la cadena, porque el servidor que nombra la cadena es el que ve la máquina del túnel y no tu dispositivo. Y si la cadena no nombra ninguna base de datos, se usa la del perfil, o admin si tampoco la hay.
Sin cadena, la autenticación va contra admin. Es donde viven las cuentas administrativas y es lo que asumen mongosh y Compass cuando alguien teclea usuario y contraseña sin más; si las tuyas están en otra base, indícalo con authSource.
Una advertencia sobre la contraseña: la del campo de arriba se guarda en el Llavero, pero una contraseña escrita dentro de la cadena no. La cadena se guarda con el resto del perfil y, si tienes activada la sincronización con iCloud, viaja con él. Si eso te importa, deja la contraseña en su campo y usa la cadena solo para lo demás.
Si la cadena está mal escrita, la conexión falla diciéndolo: es un error del formulario, así que se arregla ahí y no reintentando.
Palabras clave: cadena de conexión, mongodb, uri, srv, atlas, conjunto de réplica, replica set, authSource, mongodb+srv
Verifica los datos del servidor antes de conectar.
Dónde está: Gestor de Conexiones › Probar conexión
Pulsa Probar conexión en el formulario del perfil. Calíope intenta abrir una conexión real con los datos introducidos y muestra el resultado en un banner verde (éxito) o rojo (error con descripción).
La prueba es especialmente útil para validar credenciales SSL, firewalls o configuraciones de host antes de guardar el perfil.
Establece la conexión y abre el Espacio de Trabajo.
Dónde está: Gestor de Conexiones › Conectar
Una vez completados los datos del perfil, pulsa el botón Conectar (con ícono de rayo). Calíope abre el pool de conexiones MySQL/MariaDB mediante MySQLKit y carga el árbol de esquemas.
Si la conexión falla aparece un mensaje de error en la barra de estado. Revisa el host, las credenciales y que el servidor esté activo y accesible desde tu red.
Palabras clave: connect, conectar, abrir workspace, pool
Cambia el contexto de base de datos de la sesión desde el Editor SQL.
Dónde está: Editor SQL › Selector de base de datos
Usa el selector de base de datos en la barra del Editor SQL para cambiar el contexto activo sin reconectar. El cambio equivale a ejecutar USE nombre_bd y afecta solo a la sesión actual.
Palabras clave: use database, cambiar bd, seleccionar base de datos
Desconecta del servidor y vuelve al Gestor de Conexiones.
Dónde está: Espacio de Trabajo › Desconectar
Pulsa el botón Desconectar en la cabecera del Espacio de Trabajo. Calíope cierra el pool de conexiones y regresa a la pantalla del Gestor de Conexiones con animación.
La desconexión es automática al cerrar la ventana principal de la aplicación.
En el formulario de perfil de conexión, activa el interruptor Reconexión automática. Con esta opción activa, Calíope intentará restablecer la conexión automáticamente si el servidor la cierra por inactividad o por reinicio.
Útil para sesiones largas o para servidores con tiempo de espera de conexión corto.
Trabaja con múltiples servidores MySQL al mismo tiempo sin perder el contexto.
Dónde está: Espacio de Trabajo › Menú de servidor
Calíope soporta tener varias conexiones a servidores MySQL activas al mismo tiempo. Cada servidor tiene su propia sesión independiente con su propio árbol de esquemas, pestañas SQL abiertas, historial de consultas y estado del asistente IA.
Cómo funciona:
Cada vez que pulsas Conectar en el Gestor de Conexiones, se abre una nueva sesión sin cerrar las anteriores. Todas las sesiones coexisten y puedes alternar entre ellas sin perder nada.
Estado de cada sesión:
- Pestañas SQL y su contenido se conservan al cambiar de servidor.
- El árbol de esquemas muestra las bases de datos del servidor activo.
- El asistente IA mantiene su historial de conversación por sesión.
Puedes abrir tantas sesiones como necesites, por ejemplo para comparar datos entre entornos de desarrollo, staging y producción al mismo tiempo.
Palabras clave: multi-servidor, múltiples conexiones, simultáneo, varias conexiones, sesiones, multiserver
Cambia entre servidores conectados desde el menú desplegable del Espacio de Trabajo.
Dónde está: Espacio de Trabajo › Menú de servidor
El menú selector de servidor muestra el nombre del servidor activo y un indicador de estado de conexión (punto verde = conectado, rojo = error). Al pulsarlo se despliega un menú con todas las sesiones abiertas.
En macOS: el selector aparece en la barra de herramientas de la ventana, en la esquina superior izquierda. Muestra el nombre del servidor, la base de datos activa y la flecha desplegable.
En iPad: el selector aparece a la izquierda de la barra de pestañas, siempre visible en la parte superior del Espacio de Trabajo.
Opciones del menú:
- Toca o haz clic en el nombre de cualquier servidor para activar esa sesión.
- La sesión activa aparece marcada con un ✓.
- Añadir servidor abre el Gestor de Conexiones sobre el Espacio de Trabajo actual para conectar otro servidor sin perder las sesiones abiertas.
- Desconectar cierra la sesión del servidor activo.
Conecta a un servidor adicional sin abandonar el trabajo actual.
Dónde está: Espacio de Trabajo › Menú de servidor › Añadir servidor
Para añadir una nueva conexión mientras ya estás trabajando en otro servidor:
1. Abre el menú selector de servidor (esquina superior izquierda en macOS, barra de pestañas en iPad).
2. Pulsa Añadir servidor.
3. Se abre el Gestor de Conexiones como un panel flotante.
4. Selecciona un perfil existente o crea uno nuevo y pulsa Conectar.
5. El panel se cierra automáticamente y la nueva sesión queda disponible en el selector.
Las sesiones previas permanecen abiertas e intactas durante todo el proceso.
Palabras clave: añadir servidor, nueva sesión, segunda conexión, agregar servidor, conectar otro
Cierra la sesión de un servidor sin afectar las demás conexiones activas.
Dónde está: Espacio de Trabajo › Desconectar
Cuando tienes varias sesiones abiertas, puedes cerrar cualquiera de ellas de forma independiente:
Servidor activo:
- Abre el menú selector de servidor y pulsa Desconectar, o usa el botón rojo de desconexión en la barra de herramientas.
Cualquier sesión (para cambiar primero):
1. Abre el menú selector de servidor.
2. Selecciona el servidor que quieres cerrar para activarlo.
3. Pulsa Desconectar.
Al cerrar una sesión, Calíope activa automáticamente la última sesión disponible. Si era la única sesión abierta, regresa al Gestor de Conexiones.
Cifra la conexión al servidor MySQL con certificados SSL.
Dónde está: Panel lateral › Formulario de perfil › SSL
En el formulario del perfil de conexión, activa el interruptor SSL en la sección Opciones del servidor. Aparecen tres campos opcionales para los certificados del cliente:
- Certificado CA — archivo del certificado de la Autoridad Certificadora (.pem o .crt). Con este archivo Calíope verifica la identidad del servidor.
- Certificado cliente — archivo del certificado del cliente para autenticación mutua.
- Clave cliente — clave privada correspondiente al certificado del cliente.
Si activas SSL sin especificar el certificado CA, Calíope verifica el certificado del servidor contra las autoridades certificadoras del sistema (comportamiento por defecto seguro). Si el servidor usa un certificado autofirmado, la conexión fallará a menos que proporciones el CA correspondiente.
Aceptar certificado sin verificar (inseguro): marca esta casilla solo si te conectas a un servidor de desarrollo con certificado autofirmado y no puedes proporcionar el CA. La conexión seguirá cifrada pero será vulnerable a ataques man-in-the-middle. No la actives para servidores de producción.
En iPad: usa el selector de archivos del sistema para elegir los archivos de certificado desde tu almacenamiento local o iCloud Drive.
La conexión SSL se prueba al pulsar Probar conexión; el banner verde confirmará si el cifrado está activo.
Calíope puede proteger un perfil de conexión con autenticación biométrica. Cuando está activa, la app solicita Touch ID (macOS / iPad) o Face ID (iPad con Face ID) antes de permitir la conexión.
Activar en macOS:
- En el formulario del perfil, activa Requerir biometría en la sección Opciones del servidor.
- También puedes activarlo globalmente desde Preferencias › Conexiones › Biometría.
Activar en iPad:
- En el formulario del perfil, activa Requerir biometría en la sección Opciones.
- También disponible de forma global en Preferencias › General › Requerir biometría.
Si el dispositivo no tiene biometría disponible o los permisos están revocados, la autenticación falla y la conexión no procede. Revisa los permisos en Ajustes del sistema › Seguridad y privacidad › Touch ID (macOS) o Configuración › Face ID y código (iPad).
Cómo agrupar tus conexiones (Producción, Desarrollo, Cliente X, etc.) y mover perfiles entre grupos en macOS, iPad e iPhone.
Dónde está: Gestor de conexiones › clic derecho › Mover a grupo
Cuando la lista de conexiones crece, puedes agruparlas por entorno, cliente o cualquier otro criterio. Los grupos son plegables y persisten en connections.json como colecciones ordenables.
Crear un grupo
- macOS: clic derecho sobre cualquier grupo existente (o sobre la cabecera de la barra lateral) y elige Nuevo grupo. Se crea con el nombre por defecto Nuevo grupo y entra directamente en modo de edición para que lo renombres.
- iPad: desde el Gestor de conexiones, toca el menú ⋯ en la barra superior y elige Nuevo grupo, o edita los grupos desde la hoja Gestionar grupos.
Renombrar / eliminar
- macOS: clic derecho sobre el nombre del grupo → Renombrar grupo o Eliminar grupo.
- iPad: para renombrar, toca el lápiz de la fila en la hoja Gestionar grupos; para eliminar, desliza esa fila de derecha a izquierda. También puedes mantener pulsada la cabecera del grupo en la lista.
- Eliminar un grupo elimina también las conexiones que tiene dentro, con su contraseña guardada, su historial de consultas y el SQL que tuvieran guardado. Antes de borrar nada, Calíope pregunta y te dice cuántas conexiones se van y cómo se llaman. No se puede deshacer: si lo que quieres es deshacer la agrupación, saca antes los perfiles con Mover a grupo ▸ Sin grupo.
Mover un perfil
- macOS: clic derecho sobre el perfil → Mover a grupo ▸ → elige el grupo destino o Sin grupo para sacarlo de cualquier agrupación.
- iPad: desliza el perfil de izquierda a derecha para revelar la acción Mover (icono de carpeta, color índigo); se abre la hoja de selección de grupo.
Reordenar grupos (iPad)
- Abre Gestionar grupos y arrastra por el manillar ☰ para reordenar. El orden persiste en el campo sortOrder de cada grupo.
Expandir/plegar
- Cada grupo tiene un ▸ para plegar/expandir la lista de perfiles. El estado se guarda por grupo.
Persistencia
- Los grupos y su asignación viven en el archivo connections.json bajo el dispositivo actual. Si tienes activada la sincronización con iCloud, se comparten entre tus dispositivos.
Filtrar
- El campo de encima de la lista deja sólo las conexiones que coinciden; mientras tiene texto, todos los grupos se dibujan abiertos sin cambiar lo que guardaste (ver Filtrar la lista de conexiones).
Escribe en el campo de encima de la lista para dejar sólo las conexiones que coinciden, por nombre, servidor o grupo.
Cuando tienes treinta o cuarenta perfiles, abrir un grupo ya no basta. El campo de arriba de la barra lateral deja sólo las conexiones que coinciden con lo que escribes.
Qué busca: el nombre del perfil, su servidor y su servidor alternativo, la base de datos por omisión, el nombre de usuario, el nombre del motor y el nombre de su grupo. Escribir el nombre de un grupo lo enseña entero — es la forma de decir enséñame producción. Las tildes y las mayúsculas no importan.
Mientras filtras, los grupos se abren solos, también los que tenías plegados, para que nada que coincida se quede escondido dentro de un grupo cerrado. Esa apertura no se guarda: vacía el campo y cada grupo vuelve exactamente a como lo dejaste.
La selección no se mueve. Si el perfil que estabas editando queda fuera del filtro, el formulario de la derecha sigue enseñándolo: perder lo que estabas editando por teclear en un buscador sería peor que el problema que el buscador resuelve.
Pulsa Esc o la × para limpiar el campo. El filtro no se recuerda al cerrar la app.
Cómo usar Calíope con clústeres Amazon Aurora (edición compatible con MySQL) y qué funciones están disponibles.
Dónde está: Panel lateral › Gestor de conexiones
Amazon Aurora (edición compatible con MySQL) habla el mismo protocolo que MySQL, así que Calíope se conecta con el mismo motor, sin configuración especial.
Crear el perfil
1. En Tipo, elige Aurora.
2. En Host, pega el endpoint de tu clúster (por ejemplo mi-cluster.cluster-xxxx.us-east-1.rds.amazonaws.com): usa el endpoint de escritura para trabajo normal o uno de lectura si solo vas a consultar.
3. Deja el Puerto en 3306.
4. Completa usuario y contraseña como en cualquier servidor MySQL.
Qué obtienes
Calíope ofrece con Aurora las mismas funciones que con MySQL: editor SQL, explorador de esquema, diagramas ER, respaldos y monitoreo. Un aviso en el formulario recuerda que las capacidades disponibles son las compatibles con MySQL; puedes ocultarlo con No volver a mostrar.
Seguridad
Aurora suele exigir TLS: activa SSL/TLS en el perfil y, si tu red lo requiere, combínalo con un túnel SSH hacia un host dentro de la VPC.
Nota
Las funciones específicas de Aurora (autenticación IAM, endpoints de clúster diferenciados, métricas aurora_%) no se tratan de forma especial: Calíope maneja el clúster como un servidor MySQL estándar.
Palabras clave: aurora, amazon aurora, aws, rds, mysql, compatible, endpoint, clúster, cluster, motor, tipo de servidor, protocolo mysql
Cuando un perfil tiene Túnel SSH activado, Calíope envía notificaciones locales en dos momentos:
- Caída del túnel — al detectar un fallo de conexión antes de intentar reconectar.
- Reconexión exitosa — si la reconexión automática (opción Reconectar automáticamente del perfil) recupera el túnel con éxito.
Activar o desactivar:
Ve a Preferencias › Notificaciones y usa el toggle Túnel SSH caído / reconectado.
Si la reconexión automática falla, no se envía la notificación de reconexión; la caída ya fue notificada. El cooldown entre notificaciones del mismo host es de 60 s.