<\/p>\n
Aprende a exportar e importar bases de datos con WP-CLI, con ejemplos pr\u00e1cticos, buenas pr\u00e1cticas y comandos \u00fatiles para migrar WordPress.<\/p>\n
Trabajar con la base de datos de WordPress desde la consola es una de las ventajas m\u00e1s potentes de WP-CLI. Cuando necesitas migrar un sitio, hacer una copia de seguridad r\u00e1pida o restaurar un entorno de pruebas, los comandos de exportaci\u00f3n e importaci\u00f3n te ahorran tiempo y reducen fricciones frente al panel de administraci\u00f3n.<\/p>\n
En esta gu\u00eda vamos a centrarnos en lo esencial: c\u00f3mo volcar la base de datos, c\u00f3mo restaurarla en otro entorno y qu\u00e9 precauciones conviene tomar para evitar errores comunes. Si todav\u00eda est\u00e1s dando tus primeros pasos con esta herramienta, puede ser \u00fatil repasar antes qu\u00e9 es WP-CLI y para qu\u00e9 sirve en WordPress<\/a> o los comandos b\u00e1sicos explicados<\/a>.<\/p>\n Exportar e importar desde consola es especialmente \u00fatil en entornos de desarrollo, staging y producci\u00f3n. En lugar de depender de plugins, interfaces gr\u00e1ficas o l\u00edmites de tiempo del navegador, WP-CLI ejecuta las tareas de forma directa sobre WordPress y la base de datos MySQL o MariaDB.<\/p>\n Esto resulta muy pr\u00e1ctico cuando gestionas sitios grandes, haces despliegues frecuentes o necesitas automatizar tareas repetitivas. Adem\u00e1s, al trabajar por terminal puedes integrarlo en scripts, trabajos programados o flujos de integraci\u00f3n continua, algo muy alineado con una administraci\u00f3n moderna de WordPress.<\/p>\n La orden principal para generar un volcado es wp db export<\/strong>. Por defecto, crea un archivo SQL en el directorio actual, aunque puedes indicar una ruta concreta para organizar mejor tus copias.<\/p>\n Si ejecutas el comando desde la ra\u00edz de WordPress, el resultado ser\u00e1 un archivo listo para restaurar despu\u00e9s. Es una forma sencilla de crear una copia antes de actualizar plugins, cambiar temas o modificar URLs, pasos que suelen ir acompa\u00f1ados de cambios en la base de datos. Si ese es tu caso, quiz\u00e1 tambi\u00e9n te interese actualizar WordPress, plugins y temas con WP-CLI<\/a> o cambiar la URL de WordPress con WP-CLI<\/a>.<\/p>\n WP-CLI permite ajustar el volcado con varios par\u00e1metros. Por ejemplo, puedes comprimir la salida, excluir tablas concretas o cambiar el nombre del archivo para facilitar la trazabilidad de las copias.<\/p>\n La disponibilidad exacta de algunas opciones puede depender de la versi\u00f3n instalada de WP-CLI y de la estructura de tu base de datos. Por eso conviene validar siempre la ayuda del comando con wp db export –help<\/strong> antes de usarlo en producci\u00f3n.<\/p>\n Para restaurar un volcado SQL, el comando es wp db import<\/strong>. Este proceso sobrescribe o complementa el contenido existente seg\u00fan el estado de la base de datos y el archivo que est\u00e9s usando, por lo que debes ejecutarlo con cuidado.<\/p>\n Antes de importar, verifica que la conexi\u00f3n definida en wp-config.php<\/strong> apunta al entorno correcto. Un error habitual es ejecutar un import en una instalaci\u00f3n distinta de la que quer\u00edas restaurar. Si est\u00e1s montando o revisando un site desde cero, puede ayudarte consultar tambi\u00e9n c\u00f3mo instalar WordPress desde consola con WP-CLI<\/a> para entender el flujo completo.<\/p>\n Una pr\u00e1ctica recomendable es importar primero en un entorno de staging. As\u00ed puedes comprobar si el sitio carga bien, si las tablas est\u00e1n completas y si los enlaces internos funcionan correctamente. Despu\u00e9s, si todo est\u00e1 correcto, repites el proceso en producci\u00f3n con m\u00e1s seguridad.<\/p>\n Cuando importas una base de datos de otro dominio o subdominio, normalmente tambi\u00e9n necesitar\u00e1s reemplazar URLs antiguas por las nuevas. En WordPress, eso implica adaptar rutas absolutas, enlaces multimedia y referencias serializadas. En ese escenario, WP-CLI puede ser mucho m\u00e1s eficiente que una edici\u00f3n manual.<\/p>\n Uno de los flujos m\u00e1s habituales en migraciones es este: exportas la base de datos del sitio origen, la importas en el destino y, a continuaci\u00f3n, actualizas las URLs con un reemplazo masivo. Este paso es clave cuando cambias de dominio, de http a https o de un subdominio de desarrollo a uno real.<\/p>\n El comando de b\u00fasqueda y reemplazo merece atenci\u00f3n especial porque WordPress almacena muchos datos serializados. Si te interesa profundizar, puedes enlazar este flujo con c\u00f3mo cambiar la URL de WordPress con WP-CLI<\/a>, ya que suele ser el complemento natural de la importaci\u00f3n.<\/p>\n La base de datos es el n\u00facleo del sitio. Antes de tocarla, conviene adoptar una serie de medidas b\u00e1sicas que reducen riesgos y facilitan la recuperaci\u00f3n si algo sale mal.<\/p>\n Antes de importar un archivo nuevo, realiza siempre una exportaci\u00f3n del estado actual. As\u00ed tendr\u00e1s un punto de restauraci\u00f3n si la migraci\u00f3n no sale como esperabas. Esta pr\u00e1ctica sigue siendo v\u00e1lida tanto para sitios peque\u00f1os como para instalaciones con mucho tr\u00e1fico.<\/p>\n WP-CLI necesita acceso correcto a la base de datos configurada. Si aparecen errores, revisa el archivo wp-config.php<\/strong>, los permisos del usuario MySQL y la ruta desde la que ejecutas el comando. En algunos casos tambi\u00e9n influye ejecutar la consola con el usuario del servidor web o con un usuario con permisos adecuados.<\/p>\n No todos los sitios usan exactamente la misma estructura de tablas. Los plugins de comercio electr\u00f3nico, membres\u00eda o cach\u00e9 pueden agregar tablas personalizadas. Por eso, si vas a migrar entre instalaciones distintas, conviene revisar qu\u00e9 tablas se exportan y cu\u00e1les deben excluirse.<\/p>\n Adem\u00e1s, si gestionas transients o mecanismos de cach\u00e9 de forma habitual, quiz\u00e1 sea \u00fatil revisar c\u00f3mo limpiar la cach\u00e9 y transients con WP-CLI<\/a> despu\u00e9s de una importaci\u00f3n, para evitar datos obsoletos en el sitio restaurado.<\/p>\n Uno de los fallos m\u00e1s frecuentes es importar un archivo en el entorno equivocado. Otro problema habitual es olvidar ajustar la URL del sitio despu\u00e9s de mover la base de datos a otro dominio. Tambi\u00e9n puede ocurrir que el archivo SQL est\u00e9 incompleto, corrupto o generado desde una instalaci\u00f3n diferente.<\/p>\n Si ves mensajes de incompatibilidad, revisa primero la versi\u00f3n de WP-CLI, del motor de base de datos y del propio WordPress. No siempre se trata de un fallo grave; a veces basta con corregir la ruta del archivo, repetir la exportaci\u00f3n o revisar la configuraci\u00f3n de conexi\u00f3n.<\/p>\n Una de las grandes ventajas de WP-CLI es que permite automatizar tareas. Puedes integrar la exportaci\u00f3n de la base de datos en procesos de backup, lanzar imports en despliegues controlados o combinar varios comandos dentro de scripts Bash para reducir errores manuales.<\/p>\n Este enfoque es especialmente \u00fatil para agencias, equipos DevOps y administradores que gestionan m\u00faltiples sitios. De hecho, a medida que WP-CLI se vuelve m\u00e1s com\u00fan en flujos de trabajo profesionales, la consola deja de ser una herramienta puntual y pasa a formar parte de la operativa diaria de WordPress.<\/p>\n Exportar e importar la base de datos con WP-CLI es una habilidad esencial para cualquier persona que administre WordPress con criterio t\u00e9cnico. Te permite ahorrar tiempo, controlar mejor las migraciones y crear respaldos fiables sin depender del navegador.<\/p>\n Si combinas estos comandos con una buena estrategia de copias, un reemplazo correcto de URLs y una verificaci\u00f3n posterior del sitio, tendr\u00e1s un proceso mucho m\u00e1s s\u00f3lido y repetible. Es, en la pr\u00e1ctica, una de las formas m\u00e1s eficientes de gestionar la capa m\u00e1s sensible de WordPress.<\/p>\n Documentaci\u00f3n oficial de wp db export<\/a><\/p>\nPor qu\u00e9 usar WP-CLI para la base de datos<\/h2>\n
Comando b\u00e1sico para exportar la base de datos<\/h2>\n
# Exporta la base de datos al directorio actual\nwp db export\n\n# Exporta la base de datos a una ruta espec\u00edfica\nwp db export \/ruta\/de\/backup\/mi-sitio.sql<\/code><\/pre>\nOpciones \u00fatiles al exportar<\/h3>\n
# Exporta y comprime el archivo\nwp db export backup.sql.gz\n\n# Exporta excluyendo tablas concretas\nwp db export --tables=wp_posts,wp_postmeta\n\n# Exporta sin incluir tablas de cach\u00e9 o temporales\nwp db export --exclude_tables=wp_actionscheduler_actions,wp_actionscheduler_logs<\/code><\/pre>\nC\u00f3mo importar una base de datos con WP-CLI<\/h2>\n
# Importa un archivo SQL\nwp db import backup.sql\n\n# Importa un archivo comprimido\nwp db import backup.sql.gz<\/code><\/pre>\nRestaurar un backup en un entorno de pruebas<\/h3>\n
Combinar exportaci\u00f3n, importaci\u00f3n y search-replace<\/h2>\n
# Ejemplo de migraci\u00f3n b\u00e1sica\nwp db export sitio-origen.sql\nwp db import sitio-origen.sql\nwp search-replace 'https:\/\/origen.com' 'https:\/\/destino.com' --skip-columns=guid<\/code><\/pre>\nBuenas pr\u00e1cticas antes de exportar o importar<\/h2>\n
Haz una copia de seguridad previa<\/h3>\n
Verifica credenciales y permisos<\/h3>\n
Comprueba tablas y entorno<\/h3>\n
Errores comunes al usar wp db export e import<\/h2>\n
Automatizaci\u00f3n y flujos de trabajo<\/h2>\n
Conclusi\u00f3n<\/h2>\n
Fuentes y lecturas recomendadas<\/h3>\n