¿Cómo importar una BD postgreSQL? Imprimir

Ya sea que estés migrando tu sitio web desde otro proveedor de hosting, subiendo un entorno de desarrollo local a producción o simplemente restaurando una copia de seguridad, importar tu base de datos PostgreSQL es una de las tareas más comunes e importantes.

En entornos de cPanel, existen dos formas sumamente eficientes de realizar este proceso: de manera visual utilizando phpPgAdmin (ideal para bases de datos pequeñas o medianas) o a través de la Terminal (la solución definitiva para archivos gigantescos).

A continuación, te explicamos cómo aplicar ambos métodos paso a paso.

Antes de empezar: Los requisitos indispensables

Antes de intentar subir tu archivo de base de datos, asegúrate de cumplir con lo siguiente:

1. Tener tu base de datos y usuario ya creados: Si aún no lo has hecho, puedes seguir nuestra guía sobre [Cómo crear bases de datos y roles de usuario en PostgreSQL desde cPanel].

2. Tener tu archivo de respaldo listo: Tu base de datos debe estar guardada en tu computadora en formato de texto plano con extensión .sql o comprimida en un archivo .sql.gz o .tar.

Método 1: Importar de forma visual con phpPgAdmin (Recomendado para bases de datos pequeñas)

Si tu base de datos pesa menos de 50 MB, la herramienta gráfica phpPgAdmin es la opción más cómoda y rápida, ya que se ejecuta directamente desde tu navegador.

Método 2: Importar mediante la Terminal de cPanel (Recomendado para bases de datos grandes)

Si tu base de datos es muy pesada (más de 50 MB), es muy probable que phpPgAdmin falle o muestre un error de Timeout (tiempo de espera agotado) a mitad de la subida. Para evitar esto, el método por línea de comandos es infalible y muchísimo más rápido.

Paso A: Sube el archivo .sql al servidor

1. Entra al Administrador de Archivos de tu cPanel.

2. Navega hasta la carpeta principal de tu hosting (fuera de public_html, por seguridad).

3. Haz clic en Cargar (Upload) y sube tu archivo .sql directamente allí.

Paso B: Ejecuta el comando de importación

1. Regresa a la página principal de cPanel y abre la herramienta Terminal (ubicada en la sección Avanzado).

2. Ejecuta el siguiente comando para iniciar la importación (recuerda cambiar los datos de ejemplo por los tuyos):

psql -U usuario_basededatos -d base_de_datos -h localhost -f archivo_respaldo.sql

Nota importante sobre los parámetros:

• -U usuario_basededatos: Es el rol o usuario que creaste en cPanel (ej. clase101_user).

• -d base_de_datos: El nombre exacto de tu base de datos (ej. clase101_proyecto).

• -f archivo_respaldo.sql: El nombre exacto del archivo que subiste en el Paso A.

3. Al presionar Enter, el sistema te solicitará la contraseña de tu usuario de base de datos. Escríbela o pégala (recuerda que en Linux la contraseña no se muestra en pantalla por seguridad mientras la escribes) y presiona Enter.

La terminal comenzará a procesar todo el archivo a la velocidad del procesador. Sabrás que ha terminado cuando la consola vuelva a mostrar la línea de comandos estándar de tu hosting.

Errores comunes al importar y cómo solucionarlos

• Error: "Role 'postgres' does not exist": Esto ocurre si tu archivo .sql fue exportado desde otro servidor donde el dueño de la base de datos era el usuario maestro (postgres). Puedes solucionarlo abriendo el archivo .sql con un editor de texto (como Notepad++) y buscando y reemplazando todas las líneas que digan OWNER TO postgres; por OWNER TO tu_usuario_de_cpanel;.

• Error: "Access denied for user": Asegúrate de que el usuario de PostgreSQL esté correctamente vinculado a la base de datos en cPanel y que estés escribiendo la contraseña exacta.

¿Tu base de datos es demasiado grande o sigues experimentando errores?

No te arriesgues a perder datos valiosos. Si el archivo es demasiado pesado o te topas con errores de codificación difíciles de resolver, abre un ticket con nuestro departamento de soporte técnico. Sube tu archivo .sql a tu cuenta y nuestro equipo de administradores de sistemas realizará la importación de forma manual y segura por ti.