Cómo importar una base de datos en Syspanel con comandos MySQL

Introducción: ¿Por qué importar una base de datos en Syspanel?

Si tienes un sitio web o una aplicación, tarde o temprano necesitarás mover tu base de datos de un servidor a otro. Esto puede ocurrir al cambiar de hosting, al restaurar una copia de seguridad o al migrar tu proyecto a un entorno más potente. En Syspanel, el panel de control que usamos (basado en HestiaCP, accesible por el puerto 2106), la forma más directa y fiable de hacerlo es mediante comandos MySQL.

No te preocupes si nunca has usado la terminal. Este artículo está pensado para que, paso a paso, puedas importar tu base de datos en Syspanel sin complicaciones. Usaremos comandos sencillos que cualquier principiante puede ejecutar. Al final, tendrás tu base de datos funcionando en tu nuevo entorno.

Requisitos previos antes de importar

Antes de lanzarte a escribir comandos, asegúrate de tener todo lo necesario. Esto evitará errores y pérdidas de tiempo.

Acceso a Syspanel

Para usar los comandos MySQL, necesitas acceso SSH a tu servidor. Syspanel te proporciona este acceso. Recuerda que la URL de acceso al panel es tudominio.com:2106 (o la IP de tu servidor seguida de :2106). Una vez dentro, podrás gestionar tus bases de datos y, desde la terminal, ejecutar los comandos que te explicamos.

Archivo SQL de la base de datos

Necesitas tener el archivo que contiene los datos que quieres importar. Este archivo suele llamarse mibasededatos.sql o similar. Es un archivo de texto que contiene todas las instrucciones para reconstruir las tablas y los registros. Si aún no lo tienes, puedes exportarlo desde tu base de datos anterior (por ejemplo, usando phpMyAdmin o el comando mysqldump).

Credenciales de la base de datos en Syspanel

Dentro de Syspanel, debes haber creado una base de datos vacía o tener una existente donde quieras importar los datos. Necesitarás:

• El nombre de la base de datos (ejemplo: usuario_mibd).
• El usuario de la base de datos (suele coincidir con el nombre o ser similar).
• La contraseña de ese usuario.

Puedes encontrar esta información en la sección "Bases de Datos" de Syspanel. Si no la has creado, hazlo ahora: ve a Syspanel, inicia sesión, busca "Base de datos" y crea una nueva. Anota los datos.

Conexión SSH al servidor

El primer paso práctico es conectarte a tu servidor mediante SSH. Si usas Windows, te recomiendo PuTTY (gratuito). En Mac o Linux, puedes usar la terminal directamente.

1. Abre tu cliente SSH.
2. Introduce la IP de tu servidor y el puerto (normalmente 22).
3. Usa el usuario que te proporcionó Syspanel (suele ser admin o el nombre de tu cuenta).
4. Introduce la contraseña. Si es la primera vez, te pedirá confirmación.

Una vez conectado, verás algo como admin@servidor:~$. ¡Ya estás dentro!

Comandos básicos para importar una base de datos MySQL

Ahora viene la parte práctica. Vamos a usar el comando mysql desde la terminal. No te asustes, es muy sencillo.

Método 1: Importar desde un archivo local (en el servidor)

Este es el método más común. Supongamos que has subido tu archivo mibasededatos.sql al servidor, por ejemplo, a la carpeta /home/admin/. El comando sería:

mysql -u usuario_bd -p nombre_bd < /ruta/completa/al/archivo.sql

Desglosemos el comando:

• mysql: invoca el cliente de MySQL.
• -u usuario_bd: el usuario de la base de datos (el que creaste en Syspanel).
• -p: le dice a MySQL que te pedirá la contraseña.
• nombre_bd: el nombre exacto de la base de datos.
• <: redirige el contenido del archivo hacia el comando.
• /ruta/completa/al/archivo.sql: la ubicación del archivo en el servidor.

Ejemplo práctico:
Imagina que tu base de datos se llama cliente_miweb, el usuario es cliente_miweb_u y has subido el archivo a /home/admin/miweb.sql. El comando sería:

mysql -u cliente_miweb_u -p cliente_miweb < /home/admin/miweb.sql

Al presionar Enter, te pedirá la contraseña. Escríbela (no se verá por seguridad) y pulsa Enter. Si todo va bien, no verás ningún mensaje de error. ¡Listo!

[TIP] Si el archivo es muy grande, puede tardar unos minutos. No cierres la terminal hasta que termine.

Método 2: Importar desde un archivo remoto (desde tu PC)

Si no quieres subir el archivo al servidor, puedes importarlo directamente desde tu PC usando mysql con la opción -h (host). Este método requiere que el puerto 3306 de MySQL esté abierto (normalmente no lo está por seguridad, así que usa el método 1 a menos que sepas lo que haces).

El comando sería similar, pero añadiendo la IP del servidor:

mysql -h IP_DEL_SERVIDOR -u usuario_bd -p nombre_bd < /ruta/local/archivo.sql

Ejemplo:

mysql -h 192.168.1.100 -u cliente_miweb_u -p cliente_miweb < C:\Users\TuPC\Descargas\miweb.sql

[WARNING] Este método solo funciona si MySQL permite conexiones remotas. En Syspanel, por defecto, no está habilitado por seguridad. Te recomiendo subir el archivo al servidor (por FTP o SCP) y usar el Método 1.

Verificar que la importación fue exitosa

Después de ejecutar el comando, es buena idea comprobar que los datos están ahí. Puedes hacerlo desde la terminal o desde Syspanel.

Desde la terminal (SSH)

Conéctate a MySQL con el mismo usuario:

mysql -u usuario_bd -p

Luego, dentro del cliente MySQL, escribe:

USE nombre_bd;
SHOW TABLES;

Deberías ver una lista de las tablas que acabas de importar. Para salir, escribe EXIT;.

Desde Syspanel

Ve a la sección "Bases de Datos", haz clic en el nombre de tu base de datos y luego en "phpMyAdmin" (si está instalado). Allí podrás ver las tablas y los datos de forma gráfica.

Solución de problemas comunes (FAQ)

Aquí tienes las dudas más frecuentes al importar bases de datos en Syspanel.

"Access denied for user 'usuario'@'localhost'"

Este error significa que el usuario o la contraseña son incorrectos. Verifica en Syspanel que el usuario y la contraseña sean exactamente los que tienes escritos. Recuerda que las contraseñas distinguen mayúsculas y minúsculas.

"ERROR 1046 (3D000): No database selected"

Has olvidado especificar el nombre de la base de datos en el comando. Asegúrate de que el nombre de la base de datos esté justo después de -p (sin espacio) o después de -p si usas la contraseña en el comando (no recomendado por seguridad).

"ERROR 2002 (HY000): Can't connect to local MySQL server through socket"

MySQL no está corriendo o el socket no está en la ruta esperada. En Syspanel, puedes reiniciar MySQL desde la sección "Servicios" o usando el comando sudo systemctl restart mysql. Si el problema persiste, contacta al soporte.

El archivo SQL es muy grande y la importación falla

Si el archivo supera los 50 MB, es posible que el tiempo de ejecución sea insuficiente. Puedes usar el comando mysql con la opción --max_allowed_packet=256M para aumentar el límite. Ejemplo:

mysql -u usuario -p --max_allowed_packet=256M nombre_bd < archivo.sql

También puedes dividir el archivo en partes más pequeñas con herramientas como split en Linux.

No tengo el archivo SQL, solo tengo una copia de seguridad de phpMyAdmin

Si exportaste desde phpMyAdmin, el archivo ya está en formato SQL. Simplemente asegúrate de que tenga la extensión .sql. Si está comprimido (.zip o .gz), descomprímelo primero.

Consejos adicionales para una importación sin problemas

• Haz una copia de seguridad antes de importar: Si ya tienes datos en la base de destino, exporta primero los actuales por si algo sale mal.
• Usa un editor de texto para revisar el archivo SQL: Ábrelo con un editor como Notepad++ o Sublime Text. Busca la línea CREATE DATABASE o USE. Si aparece, puedes comentarla (poner -- al inicio) para evitar conflictos, ya que la base de datos ya existe.
• Aumenta el tiempo de espera de SSH: Si la importación es muy larga, tu sesión SSH puede cerrarse. Usa screen o tmux para mantenerla activa, o simplemente ejecuta el comando con nohup al inicio.

[INFO] En Syspanel, el puerto de acceso al panel es el 2106. No lo confundas con el puerto SSH (22) o MySQL (3306). Cada uno tiene su función.

Conclusión

Importar una base de datos en Syspanel usando comandos MySQL es un proceso sencillo una vez que entiendes la estructura básica del comando mysql -u usuario -p base < archivo.sql. Con los pasos que te he dado, podrás hacerlo tú mismo sin depender de asistencias técnicas. Recuerda siempre verificar la información de tu base de datos en Syspanel, usar rutas correctas y, ante cualquier error, consultar la sección de solución de problemas.

Si tienes más dudas, no dudes en buscar en la documentación oficial de Syspanel (recuerda, puerto 2106) o preguntar en foros especializados. ¡Buena suerte con tu migración!