SQLManager Pro — Manual de usuario
SQLManager Pro gestiona bases de datos SQLite y servidores MySQL o MariaDB en un solo programa. Este manual describe todo lo que sabe hacer, en el orden en que normalmente lo necesitarás.
1 — El primer inicio
Al iniciarse, SQLManager Pro muestra la ventana de bienvenida. Desde aquí hay tres caminos:
- Abrir Base de Datos — abre un archivo SQLite existente, consulta el capítulo 2;
- Crear Base de Datos — crea un archivo SQLite nuevo y vacío;
- Conectar al servidor MySQL — abre una base de datos en un servidor, consulta el capítulo 3.
Debajo, en Abiertos Recientemente, aparecen las bases de datos con las que has trabajado últimamente. Un clic las vuelve a abrir. Un cilindro indica un archivo; un símbolo de red, un servidor. Limpiar vacía esta lista; las bases de datos en sí no se tocan.
Sin compra puedes probar SQLManager Pro durante siete días con todas las funciones. Cuántos días quedan se ve arriba del todo en la barra lateral. Con Actualizar a versión completa compras la versión completa; después ya no hay límite de tiempo. Cuando termina el periodo de prueba, al iniciar aparece la ventana de compra. Una compra anterior se recupera allí con Restaurar compra.
2 — Abrir y crear bases de datos SQLite
Abrir
Abrir Base de Datos (⌘O) muestra el selector de archivos. Elige el archivo de la base de datos. La extensión da igual.
Si el archivo está en una carpeta a la que SQLManager Pro aún no tiene acceso, aparece justo después un segundo selector con el texto Autorizar acceso permanente a la carpeta. Confirma ahí la carpeta en la que está la base de datos. Hace falta una vez por carpeta: mientras trabajas, SQLite crea archivos auxiliares junto a la base de datos y necesita para ello permiso de escritura en la carpeta. Si eliges otra carpeta por error, el programa te avisa y te deja elegir de nuevo.
Si arriba en la barra lateral pone Modo Restringido, la base de datos no se pudo abrir en modo WAL. Aun así puedes trabajar. Pero si otros programas editan el mismo archivo a la vez, pueden surgir problemas. En ese caso cierra la base de datos y vuelve a abrirla con Abrir Base de Datos.
Crear
Nueva Base de Datos (⌘N) pregunta el nombre y la ubicación del archivo nuevo y lo abre a continuación. Está vacío; las tablas las creas como se describe en el capítulo 4 o las importas.
Cambios desde fuera
Si otro programa modifica el archivo abierto, SQLManager Pro lo vuelve a cargar por sí solo. Así siempre ves el estado actual.
Cerrar
Cerrar base de datos (⌘W) vuelve a la ventana de bienvenida. Al mismo tiempo se limpian los archivos auxiliares.
3 — Conectar con un servidor MySQL
Conectar al servidor MySQL está en la ventana de bienvenida y en el menú Archivo. El diálogo pide:
| Campo | Significado |
|---|---|
| Servidor | Nombre o dirección del servidor. |
| Puerto | Lo habitual es 3306. |
| Base de datos | El nombre de la base de datos en el servidor. Si dejas el campo vacío, SQLManager Pro muestra todas las bases de datos del servidor después de conectar; consulta Elegir base de datos. |
| Usuario y Contraseña | El inicio de sesión en el servidor. Mostrar la contraseña hace visible lo escrito. |
| Guardar la contraseña en el llavero | La contraseña se guarda en el llavero de macOS, nunca en la configuración. La próxima vez basta con un clic en la lista Abiertos Recientemente. |
| Cifrado | Desactivado, Cifrado, sin comprobar el certificado o Cifrado con comprobación del certificado. |
Probar conexión comprueba los datos sin abrir la base de datos. Conectar la abre. Después trabajas exactamente igual que con un archivo SQLite: datos, estructura, índices, SQL, importación y exportación.
SQLManager Pro funciona con MySQL y con MariaDB a partir de la versión 10. Versiones más antiguas como MariaDB 5 usan otro protocolo; el programa avisa entonces de que el servidor es demasiado antiguo.
Elegir base de datos
Si no conoces el nombre de la base de datos o quieres crear una nueva, deja vacío el campo Base de datos:
- Rellena Servidor, Puerto, Usuario y Contraseña. El campo Base de datos queda vacío.
- Haz clic en Conectar. SQLManager Pro solo inicia sesión en el servidor y todavía no abre ninguna base de datos.
- En el mismo diálogo aparece la página Elegir base de datos. Debajo del título se indica con qué usuario has iniciado sesión, por ejemplo Conectado como root@localhost.
La lista muestra todas las bases de datos que este usuario puede ver,
ordenadas alfabéticamente. Las bases de datos del sistema del servidor
(information_schema, mysql,
performance_schema y sys) aparecen en gris con la
etiqueta Sistema a la derecha. Si el usuario no ve
ninguna base de datos, en lugar de la lista aparece el aviso
Este usuario no ve ninguna base de datos en el
servidor.
Para abrir una base de datos, selecciónala y haz clic en Abrir, o haz doble clic en ella. Se abre como cualquier otra conexión de servidor y se añade a Abiertos Recientemente. Con la contraseña guardada, la próxima vez basta un clic allí.
Atrás vuelve a los datos de acceso, Cancelar cierra el diálogo. En ambos casos SQLManager Pro cierra la sesión en el servidor. Probar conexión con el campo Base de datos vacío solo comprueba el inicio de sesión en el servidor.
Crear una base de datos
- Conéctate como se describe arriba, con el campo Base de datos vacío.
- En la página Elegir base de datos, escribe el nombre en el campo Nombre bajo Nueva base de datos.
- Haz clic en Crear y abrir o pulsa la tecla Retorno.
El servidor crea la base de datos, SQLManager Pro la abre enseguida y la añade a Abiertos Recientemente. Al principio está vacía; las tablas se crean como de costumbre, consulta La ventana principal.
La base de datos recibe el juego de caracteres utf8mb4.
Guarda todas las escrituras, también emojis. La intercalación la elige el
propio servidor; es distinta entre MySQL y MariaDB.
SQLManager Pro quita los espacios al principio y al final del nombre. Si ya existe una base de datos con ese nombre, aparece el mensaje Ya existe algo con este nombre. No se sobrescribe nada. Si el servidor rechaza el nombre, por ejemplo porque es demasiado largo (como máximo 64 caracteres), su mensaje aparece en el diálogo.
Eliminar una base de datos
- Conéctate como se describe arriba, con el campo Base de datos vacío.
- En la página Elegir base de datos, haz clic derecho en la base de datos y elige Eliminar base de datos…. O selecciona la base de datos y haz clic abajo en Eliminar base de datos….
- Aparece la pregunta de seguridad ¿Eliminar la base de datos «nombre»? Comprueba el nombre y haz clic en Eliminar. Cancelar lo deja todo como estaba.
La eliminación borra la base de datos con todas sus tablas y datos del servidor de forma definitiva. No hay papelera ni deshacer. Si todavía necesitas los datos, expórtalos antes; consulta Exportar datos.
Después de eliminarla, la base de datos desaparece de la lista. Si está abierta en SQLManager Pro en ese momento, se cierra. Las entradas de Abiertos Recientemente que apuntan a ella se eliminan, junto con la contraseña guardada para ella en el llavero.
Las bases de datos del sistema no se pueden eliminar. Para ellas el botón está desactivado y el menú contextual no ofrece la eliminación.
Si un usuario puede ver, crear o eliminar bases de datos lo decide el
servidor, no SQLManager Pro. En MySQL una base de datos no pertenece a
ningún usuario; cada uno tiene los permisos que se le han concedido. Si
falta el permiso, el diálogo muestra Al usuario le
falta el permiso para esta base de datos … y debajo el mensaje
del servidor. Los permisos los concede un usuario con derechos de
administración, como root, con el comando SQL
GRANT.
Cambiar los datos de acceso
Un clic derecho sobre una conexión de servidor en la lista Abiertos Recientemente ofrece Editar. El diálogo se abre con los datos anteriores; solo tienes que volver a escribir la contraseña. Todas las conexiones guardadas se gestionan en Configuración › Conexiones.
Si un servidor no responde, SQLManager Pro cancela tras veinte segundos con un mensaje.
4 — La ventana principal
La barra lateral
Arriba aparecen el nombre y la ubicación de la base de datos y, en un archivo, también su tamaño. Una etiqueta al lado indica si es SQLite o MySQL. Debajo siguen todas las tablas con su número de filas.
El interruptor Tablas del Sistema muestra las tablas internas de la base de datos. Llevan una rueda dentada y no se pueden renombrar ni eliminar.
Crear, renombrar y eliminar tablas
Los botones bajo la lista:
- Crear — crea una tabla nueva. Escribe un nombre y al menos una columna. Para cada columna eliges el tipo (TEXT, INTEGER, REAL, BLOB, NUMERIC) y, si hace falta, marcas PRIMARY KEY, NOT NULL, UNIQUE y un valor predeterminado. Una columna INTEGER con PRIMARY KEY puede llevar AUTOINCREMENT. Abajo, la Vista Previa SQL muestra el comando que se ejecutará.
- Renombrar — da un nombre nuevo a la tabla elegida.
- Eliminar (⌘⌫) — elimina la tabla elegida tras una confirmación. No se puede deshacer.
Renombrar y eliminar también están en el clic derecho sobre una tabla.
Las cuatro pestañas
Con una tabla elegida, la zona derecha muestra arriba cuatro pestañas: Datos, Estructura, Índices y SQL. Sin tabla elegida, aparece directamente el editor SQL.
En la barra de herramientas de arriba están Exportar, Importar, el menú Archivo y la Configuración.
5 — Ver y editar datos
La pestaña Datos muestra el contenido de la tabla. Arriba a la izquierda pone cuántas filas están cargadas y cuántas hay en total.
Avanzar por las páginas
Se cargan 500 filas cada vez, y más al seguir desplazándote. Si una tabla tiene más de 500 filas, con las flechas de arriba a la derecha avanzas y retrocedes página a página.
Buscar y ordenar
El campo Buscar contenido muestra solo las filas en las que el texto aparece en cualquier columna. Mayúsculas y minúsculas dan igual. Un clic en el encabezado de una columna ordena por ella; un segundo clic invierte el sentido. Los números se ordenan como números y los campos vacíos van al final.
La búsqueda y el orden se aplican a las filas cargadas. En tablas grandes
desplázate antes o busca con SELECT … WHERE en el
editor SQL.
Cambiar un campo
Un doble clic en un campo lo abre para editarlo. Lo mismo ocurre con un clic simple en un campo de una fila que ya está marcada. Intro, el tabulador o un clic fuera guardan; Escape descarta el cambio.
No se pueden editar directamente la clave primaria, las columnas
AUTOINCREMENT, las columnas BLOB ni las columnas created_at y
updated_at.
Cada campo sigue la dirección de escritura de su contenido: el texto árabe se alinea a la derecha y se escribe de derecha a izquierda, el texto latino a la izquierda, también mientras escribes. Los campos sin letras, vacíos o solo con cifras, siguen la dirección de lectura de la app.
Añadir, editar y eliminar filas
Los botones están arriba a la derecha, sobre la tabla:
- Añadir Fila abre un formulario con todas las columnas.
- Editar Fila aparece cuando hay exactamente una fila marcada y muestra todos sus campos en un formulario. Los campos que no se pueden cambiar llevan la indicación (no editable). Los campos obligatorios (NOT NULL) no pueden quedar vacíos.
- Eliminar quita las filas marcadas tras una confirmación. Con ⌘-clic o ⇧-clic marcas varias.
Un clic derecho en un campo ofrece los mismos comandos como menú: Editar Fila y Eliminar, además de Editar Campo. Este abre una ventana propia con el valor actual y el nuevo, práctica para textos largos.
6 — La estructura de una tabla
La pestaña Estructura lista las columnas de la tabla con nombre, tipo y valor predeterminado. Las columnas PK, NOT NULL, AI e INDEX indican si una columna es clave primaria, debe rellenarse, se incrementa sola o tiene un índice.
Añadir, cambiar y eliminar columnas
- Nueva Columna — nombre, tipo de datos y, si quieres, un valor predeterminado.
- Editar — cambia el nombre, el tipo de datos, NOT NULL y el valor predeterminado. Aquí también defines una clave primaria (Establecer como Clave Primaria) o un índice (Marcar como Índice). Si ya hay una clave primaria, el programa pregunta si debe sustituirse. Si la columna tiene valores duplicados, no se convierte en clave primaria.
- Eliminar — quita una columna tras una confirmación. Si es la clave primaria, la confirmación advierte de que la tabla se quedará sin ella.
Editar y eliminar también están en el clic derecho sobre una columna.
SQLite no puede ejecutar directamente muchos cambios de columnas. SQLManager Pro reconstruye para ello la tabla en segundo plano y conserva todos los datos. En MySQL la columna se cambia directamente.
El comando CREATE
Bajo las columnas aparece el comando CREATE TABLE completo de
la tabla. Copiar lo pone en el portapapeles.
7 — Índices
Un índice acelera las consultas que buscan u ordenan por una columna. La pestaña Índices muestra todos los índices de la tabla con sus columnas, el orden, si son UNIQUE y un posible filtro WHERE.
Crear un índice
Crear Índice pide un nombre, por ejemplo
idx_clientes_ciudad, y una o varias columnas. Para cada columna
defines el sentido: ASC ascendente, DESC descendente. Un
Índice UNIQUE impide valores duplicados; si la
columna ya los tiene, no se puede crear. La Vista Previa
SQL muestra el comando.
Eliminar índices
Marca uno o varios índices y elimínalos. Los índices de la clave primaria no se pueden eliminar.
8 — El editor SQL
En el editor SQL escribes cualquier comando SQL. Ejecutar (⌘↩) lo ejecuta. Varios comandos, separados por punto y coma, se ejecutan uno tras otro.
El resultado
Una consulta muestra sus filas abajo como tabla; un comando que modifica datos, el número de filas afectadas. Si varias consultas dan resultados, cada uno tiene su propia pestaña. Exportar CSV guarda el resultado mostrado como archivo CSV.
Si un comando cambia tablas o columnas, la barra lateral y la vista de estructura se actualizan solas.
Autocompletado
Si haces una breve pausa al escribir, el editor propone palabras clave SQL, funciones y nombres de tablas y columnas. Con las flechas eliges; el tabulador o un doble clic aceptan la propuesta; Escape cierra la lista.
Historial
Historial muestra los diez últimos comandos ejecutados. Un clic devuelve uno de ellos al editor. Limpiar historial vacía la lista.
Cargar archivos SQL
Cargar lee un archivo SQL en el editor, por ejemplo una exportación o un script. Con archivos muy grandes el editor muestra solo el principio; aun así se ejecuta el archivo entero. Cuánto se muestra lo defines en Configuración › Avanzado.
9 — Importar datos
Importar en la barra de herramientas pasa datos de un archivo a una tabla. Se admiten:
- CSV — también
.tsvy.txt; - JSON — un array de objetos;
- XML.
Elige el formato y luego el archivo con Seleccionar Archivo. SQLManager Pro lo lee y propone una estructura de tabla.
Revisar la estructura de la tabla
En el paso Configuración de Esquema ves:
- el Nombre de Tabla, que puedes cambiar;
- los Índices propuestos, que activas y desactivas uno a uno;
- todas las columnas con el tipo detectado, dos valores de ejemplo cada una y las casillas PK y NOT NULL. Un signo de advertencia amarillo significa que el tipo no se detectó con seguridad. Si pasas el ratón por encima, ves lo segura que fue la detección.
Debajo, una Vista Previa muestra las primeras filas.
Si la tabla ya existe
Si la tabla lleva un nombre que ya existe, SQLManager Pro compara ambas estructuras:
| Caso | Qué puedes elegir |
|---|---|
| La estructura coincide | Importar en la tabla existente o crear una nueva. |
| Faltan columnas en la tabla | Añadir columnas o Saltar campos. |
| La tabla tiene columnas adicionales | Continuar; esas columnas no cambian. |
| Los nombres de columna difieren | En el Mapeo de Columnas, asignar a cada columna del archivo una columna de la tabla o crearla como columna nueva. Una advertencia de tipo indica dónde puede fallar la conversión. |
| Las estructuras no encajan | Crear una tabla nueva con otro nombre. |
IDs duplicados
Si las filas del archivo pueden llevar IDs que ya existen en la tabla, el programa pregunta:
- Actualizar datos existentes (recomendado) — las filas existentes se sobrescriben con los valores del archivo;
- Generar nuevos IDs — todas las filas se añaden como nuevas;
- Saltar conflictos — se omiten las filas con un ID existente.
La importación se ejecuta en una ventana propia con indicador de progreso; mientras tanto puedes seguir trabajando. Si falla, no se pasa nada.
10 — Exportar datos
Exportar en la barra de herramientas escribe tablas en archivos. Hay cinco formatos:
| Formato | Resultado |
|---|---|
| CSV | Archivo de texto con separador, opcionalmente con encabezados de columna. |
| JSON | Opcionalmente con sangría (Pretty Print). |
| XML | Un archivo XML por tabla. |
| SQLite | Archivo SQL con CREATE TABLE e
INSERT para SQLite. |
| MySQL | Lo mismo para MySQL y MariaDB. |
Con los dos formatos SQL trasladas una base de datos de SQLite a MySQL o al revés: exporta, abre la otra base de datos, carga el archivo en el editor SQL y ejecútalo. El contenido BLOB se incluye.
Elige las tablas, todas a la vez con Seleccionar Todo. Con una tabla el programa pide un nombre de archivo; con varias, una carpeta, y cada tabla va a su propio archivo. Tras la exportación, Mostrar en Finder muestra el resultado.
La carpeta que se propone primero al exportar la defines en Configuración › Exportación. Sin una ruta predeterminada, el programa recuerda el último lugar usado.
11 — Imágenes y datos binarios (BLOB)
Las columnas de tipo BLOB contienen datos binarios, a menudo imágenes o documentos. En la vista de datos aparece entonces el botón Mostrar BLOB cuando hay una fila marcada; con el clic derecho están Ver BLOB y Exportar BLOB.
La Vista Previa BLOB muestra las imágenes directamente. Para otros datos indica el tamaño. Exportar guarda el contenido como archivo.
Al añadir o editar una fila, rellenas un campo BLOB con Seleccionar Archivo. Un BLOB existente se puede sustituir, quitar con Limpiar campo y recuperar con Volver al original mientras no hayas guardado. Mostrar vista previa muestra el contenido en el formulario.
12 — Configuración
Idioma
SQLManager Pro habla alemán, árabe, chino, coreano, danés, español, francés, inglés, italiano, japonés, neerlandés, noruego, portugués (Brasil), portugués (Portugal) y sueco. El cambio se aplica al instante, sin reiniciar.
La excepción es cambiar desde o hacia el árabe: cambia la dirección de lectura y toda la interfaz se refleja. SQLManager Pro pregunta antes y se cierra con Cambiar y salir. En el siguiente inicio, el nuevo idioma aparece en la dirección correcta.
Apariencia
Claro, oscuro o como el sistema, además de uno de doce colores de acento para botones y selección.
Conexiones
Todas las conexiones de servidor guardadas. Para cada una hay:
- Editar — cambiar el nombre y los datos de acceso. Un campo de contraseña vacío elimina la contraseña guardada.
- Duplicar — una copia con los mismos datos de acceso. Práctico si quieres abrir otra base de datos en el mismo servidor: basta con cambiar el nombre de la base de datos.
- Quitar de la lista — la conexión desaparece de esta lista. Sigue entre las bases de datos abiertas recientemente y la contraseña sigue guardada.
Exportación
La Ruta de Exportación Predeterminada, consulta el capítulo 10. Restablecer Ruta la quita de nuevo.
Avanzado
Límite de Visualización del Editor SQL: cuántos megabytes de un archivo SQL cargado muestra el editor, entre 5 y 50, por defecto 10. Siempre se ejecuta el archivo entero.
Registro
Escribir archivo de registro anota lo que hace el programa; por defecto está desactivado. Ayuda cuando algo sale mal.
- Detalle — ERROR escribe lo mínimo, DEBUG lo máximo. Se escribe todo a partir del nivel elegido.
- Anotar los comandos SQL ejecutados — muy útil para buscar errores. Ten en cuenta que los comandos contienen valores de tus datos.
- Mostrar, Mostrar en el Finder y Vaciar para el archivo. En la ventana de visualización, Seguir mantiene a la vista el final del archivo.
Versión y compra
Muestra si la versión completa está activa o cuántos días de prueba quedan. Aquí compras la versión completa con Actualizar a versión completa o recuperas una compra anterior con Restaurar compra.
Acerca de
Versión, resumen de funciones, las Novedades de esta versión, las bibliotecas de programas utilizadas y un enlace a este manual.
13 — Atajos de teclado
| Para | Teclas |
|---|---|
| Nueva base de datos | ⌘N |
| Abrir base de datos | ⌘O |
| Cerrar base de datos | ⌘W |
| Eliminar la tabla elegida | ⌘⌫ |
| Ejecutar SQL | ⌘↩ |
| Aceptar propuesta (editor SQL) | ⇥ |
| Descartar la edición de un campo | Escape |
| Configuración | ⌘, |
14 — Preguntas frecuentes
Al abrir me pide una carpeta. ¿Por qué?
SQLite necesita permiso de escritura en la carpeta de la base de datos, no solo en el archivo. Confirma la carpeta en la que está el archivo. Solo hace falta una vez por carpeta.
La conexión con el servidor no funciona.
SQLManager Pro dice con claridad cuál es el problema: contraseña incorrecta o falta de permiso para este equipo, base de datos desconocida, servidor inaccesible o demasiado antiguo. El mensaje técnico aparece debajo y se puede marcar y copiar. Comprueba el servidor y el puerto, y si el usuario puede acceder al servidor desde fuera.
Un campo no se puede editar en la tabla.
Las claves primarias, las columnas AUTOINCREMENT y BLOB, así como
created_at y updated_at, quedan excluidas de la
edición directa. Los BLOB se cambian con Editar
Fila.
La búsqueda no encuentra una fila que existe.
La búsqueda se aplica a las filas cargadas. Desplázate más o busca en el
editor SQL con SELECT … WHERE.
«Otro programa está usando el archivo de base de datos.»
Otro programa está escribiendo en el mismo archivo. Espera un momento o cierra la base de datos en el otro programa.
¿Cómo vuelvo a abrir la ventana «Novedades»?
En Configuración › Acerca de.
¿Por qué se cierra la app al cambiar al árabe?
Porque cambia la dirección de lectura y toda la interfaz se refleja. El cambio se aplica en el siguiente inicio. Simplemente vuelve a abrir SQLManager Pro.