SQLManager Pro — Manual de usuario Volver a la página del producto

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

La ventana de bienvenida de SQLManager Pro.
La ventana de bienvenida.

Al iniciarse, SQLManager Pro muestra la ventana de bienvenida. Desde aquí hay tres caminos:

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.

Periodo de prueba

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.

Modo restringido

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

El diálogo para conectar con un servidor MySQL.
Los datos de acceso a un servidor MySQL.

Conectar al servidor MySQL está en la ventana de bienvenida y en el menú Archivo. El diálogo pide:

CampoSignificado
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.

Qué servidores funcionan

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

La página Elegir base de datos con la lista de bases de datos del servidor.
Elegir, crear o eliminar una 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:

  1. Rellena Servidor, Puerto, Usuario y Contraseña. El campo Base de datos queda vacío.
  2. Haz clic en Conectar. SQLManager Pro solo inicia sesión en el servidor y todavía no abre ninguna base de datos.
  3. 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

  1. Conéctate como se describe arriba, con el campo Base de datos vacío.
  2. En la página Elegir base de datos, escribe el nombre en el campo Nombre bajo Nueva base de datos.
  3. 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

  1. Conéctate como se describe arriba, con el campo Base de datos vacío.
  2. 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….
  3. 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.
Definitivo

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.

Permisos de usuario

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 ventana principal con barra lateral y una tabla abierta.
La ventana principal: a la izquierda las tablas, a la derecha el contenido.

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:

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:

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 vista de estructura de una tabla.
La pestaña Estructura.

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

Editar y eliminar también están en el clic derecho sobre una columna.

Cómo cambia SQLite las columnas

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

El editor SQL con resultado.
El editor SQL: arriba el comando, abajo el resultado.

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

El diálogo de importación.
La importación.

Importar en la barra de herramientas pasa datos de un archivo a una tabla. Se admiten:

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:

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:

CasoQué 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:

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

El diálogo de exportación.
La exportación.

Exportar en la barra de herramientas escribe tablas en archivos. Hay cinco formatos:

FormatoResultado
CSVArchivo de texto con separador, opcionalmente con encabezados de columna.
JSONOpcionalmente con sangría (Pretty Print).
XMLUn archivo XML por tabla.
SQLiteArchivo SQL con CREATE TABLE e INSERT para SQLite.
MySQLLo 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:

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.

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

ParaTeclas
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 campoEscape
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.