logo
icon

PostgreSQL

Un potente sistema de base de datos objeto-relacional de código abierto, conocido por su fiabilidad, integridad de datos y cumplimiento de SQL.

template cover
Implementado8653 veces
EditorzeaburZeabur
Creado2024-06-18
Servicios
service icon
Etiquetas
Database

Desplegar PostgreSQL

PostgreSQL (a menudo llamado Postgres) es un potente sistema de base de datos objeto-relacional de código abierto. Es ampliamente admirado por su fiabilidad, su robusto conjunto de funciones y su adhesión a los estándares SQL. Es una opción ideal para aplicaciones que requieren consultas complejas, cumplimiento ACID y una estricta integridad de datos.

Zeabur hace que la gestión de bases de datos relacionales sea sencilla. Con Zeabur, puedes lanzar una instancia de PostgreSQL lista para producción en segundos, sin tener que lidiar con archivos de configuración complejos, volúmenes de almacenamiento o mantenimiento de servidores.

Lo que aprenderás

En este tutorial te guiaremos a través de:

  1. Desplegar un servicio de PostgreSQL desde el Marketplace de Zeabur.
  2. Conectarte a tu base de datos usando herramientas externas como TablePlus, pgAdmin o psql.
  3. Conectar tu aplicación backend desplegada a PostgreSQL.

Fase 1: Desplegar la base de datos

Paso 1: Crear el servicio de PostgreSQL

Zeabur ofrece un “despliegue con un clic”, lo que significa que rara vez necesitas configurar ajustes complejos manualmente.

Opción 1: Crear una instancia de PostgreSQL desde la página del proyecto

  1. Inicia sesión en tu Zeabur Dashboard.
  2. Haz clic en el botón "New Project".
  3. Selecciona "Template" (Marketplace).
  4. Busca PostgreSQL.
  5. Selecciona la imagen oficial de PostgreSQL. Tu servicio comenzará a desplegarse inmediatamente.

Opción 2: Crear una instancia de PostgreSQL desde la página de la plantilla

  1. Inicia sesión en tu Zeabur Dashboard.
  2. Selecciona Features y Template.
  3. Elige o busca PostgreSQL.
  4. Selecciona PostgreSQL (normalmente la imagen oficial), haz clic en deploy y comenzará el despliegue.

Paso 2: Obtener tus credenciales de conexión

  1. Ve a la pestaña Instruction de tu servicio.
  2. Busca la sección "Connection". Verás dos tipos de información:
    • Public (External): Para VS Code / app local.
    • Private (Internal): Para tu app desplegada.
  3. Anota los siguientes datos de la sección Public:
    • Host: (por ejemplo, postgres.zeabur.app)
    • Port: (normalmente 5432 o un puerto aleatorio)
    • Username: (por defecto suele ser root o postgres)
    • Password: (haz clic en el icono del “ojo” para mostrarla)
    • Database: (por defecto es postgres)

Fase 2: Conectarte a la base de datos

Requisito previo: obtener la información pública de conexión

Antes de abrir cualquier herramienta, asegúrate de tener listos los detalles de conexión desde el Zeabur Dashboard.

  1. Ve a tu servicio de PostgreSQL en Zeabur.
  2. Haz clic en la pestaña Instruction.
  3. En la sección "Public" (External) verás:
    • Connection String
    • PostgreSQL Connect Command
    • PostgreSQL username
    • PostgresSQL password
    • PostgresSQL database
    • PostgreSQL host
    • PostgreSQL port

Opción 1: Conectar usando VS Code (SQLTools)

Ideal para: desarrolladores que quieren escribir código y revisar la base de datos en la misma ventana.

Paso 1: Instalar extensiones

  1. Abre VS Code o cualquier alternativa compatible.
  2. Haz clic en Extensions (Ctrl+Shift+X o Cmd+Shift+X).
  3. Busca e instala: SQLTools.
  4. Busca e instala el driver: SQLTools PostgreSQL/Cockroach Driver.

Paso 2: Crear la conexión

  1. Haz clic en el icono de SQLTools (cilindro de base de datos) en la barra lateral izquierda.
  2. Pasa el cursor sobre “Connections” y haz clic en "Add New Connection" (un cilindro con +).
  3. Selecciona PostgreSQL.

Paso 3: Configurar los parámetros Completa el formulario con tus datos de Zeabur:

  • Connection Name: Zeabur DB (o el nombre que quieras)
  • Connect using: Server and Port
  • Server Address (Host): pega tu Postgresql Host
  • Port: pega tu Postgresql Port
  • Database: pega tu Postgresql Database (normalmente postgres)
  • Username: pega tu Postgresql User
  • Password: pega tu Postgresql Password
  • SSL: deja el valor por defecto (o selecciona "Require" si falla)

Paso 4: Probar y conectar

  1. Haz clic en "Test Connection". Deberías ver “Successfully Connected”.
  2. Haz clic en "Save Connection".
  3. En la barra lateral, haz clic derecho en tu conexión y selecciona "Connect".
  4. Ya puedes expandir el árbol para ver Tables, Views y Functions.

Opción 2: Conectar usando pgAdmin 4 (GUI oficial)

Ideal para: administración completa de bases de datos usando la interfaz estándar de código abierto.

Paso 1: Instalar pgAdmin

  1. Descarga e instala pgAdmin 4 para tu sistema operativo.
  2. Abre pgAdmin 4. (Nota: es normal que se abra en el navegador).

Paso 2: Registrar el servidor

  1. En el panel izquierdo, haz clic derecho en Servers.
  2. Selecciona Register > Server...

Paso 3: Introducir credenciales Aparecerá una ventana emergente. Debes completar estas pestañas:

  • Pestaña 1: General
    • Name: escribe un nombre (por ejemplo, Zeabur App DB)
  • Pestaña 2: Connection
    • Host name/address: pega tu Postgresql Host
    • Port: pega tu Postgresql Port
    • Maintenance database: pega tu Postgresql Database (normalmente postgres)
    • Username: pega tu Postgresql User (normalmente root)
    • Password: pega tu Postgresql Password
    • Opcional: marca “Save Password” para no escribirla cada vez
  • Pestaña 3: Parameters (opcional)
    • Si hay errores SSL, ve a la pestaña SSL y ajusta “SSL mode” a Require o Prefer.

Paso 4: Conectar

  1. Haz clic en el botón azul Save.
  2. Tu base de datos aparecerá en la barra lateral.
  3. Abre > junto a tu servidor > Databases > postgres > Schemas > public > Tables.

Fase 3: Conectar tu app (inter-servicio)

Cuando despliegas tu aplicación a Zeabur, necesita comunicarse con esta base de datos. Para mayor seguridad y rendimiento, usa Private Networking.

Método A: La forma fácil (variables de entorno)

Zeabur expone automáticamente cadenas de conexión a otros servicios del mismo proyecto. En tu servicio de app:

  1. Ve a la pestaña Variables.

  2. Añade una variable llamada DATABASE_URL (o el nombre que use tu código).

  3. En el valor, usa la variable de referencia de Zeabur: esto insertará automáticamente la cadena interna y segura.

    ${POSTGRES_CONNECTION_STRING}

Método B: La forma manual (variables específicas)

Si necesitas partes específicas de la conexión (o tienes varias bases de datos), usa:

  • Host: ${POSTGRES_HOST} (hostname interno, suele terminar en .zeabur.internal)
  • Port: ${POSTGRES_PORT}
  • User: ${POSTGRES_USERNAME}
  • Password: ${POSTGRES_PASSWORD}

Nota: si tu proyecto tiene varias instancias de PostgreSQL, las variables de referencia podrían apuntar a otra instancia. En ese caso, copia manualmente el hostname y el puerto internos desde la pestaña Networking.

Fase 4: Mantenimiento y copias de seguridad

Configuración (avanzado)

Si necesitas ajustar configuraciones (memoria, logs, etc.):

  1. Abre el Config Editor en Zeabur.
  2. Edita el archivo /etc/postgresql/postgresql.conf.
  3. Nota: Zeabur ya preconfigura ajustes esenciales, así que normalmente no es necesario.

Restaurar una copia de seguridad

Zeabur realiza backups automáticos. Para restaurar uno:

  1. Descargar: descarga y extrae el archivo de backup desde el almacenamiento de Zeabur. Obtendrás un data.sql.

  2. Preparar: asegúrate de tener instaladas las herramientas cliente de PostgreSQL.

  3. Ejecutar: busca tu "PostgreSQL Connect Command" en la pestaña Instructions y ejecútalo en tu terminal. Ejemplo: psql -h postgres.zeabur.app -p 5432 -U root postgres < data.sql

    <Your PostgreSQL Connect Command> < data.sql

Advertencia: restaurar un backup reemplaza los datos existentes y la contraseña del usuario. Si quieres conservar la contraseña actual, elimina las sentencias CREATE ROLE y ALTER ROLE del archivo data.sql antes de ejecutar el comando.