Saltar al contenido principal
Una instancia de PostgreSQL gestionada con conexión TLS por certificado de cliente, una base de datos y un rol que son tuyos, extensiones populares listas para activar y pg_cron para tareas programadas. Lo que comparten todos los motores (límites, snapshots, Insights) está en la visión general de bases de datos.

Conectarse

Copia la URL de conexión desde la página de la base de datos en el dashboard. Tiene esta forma, con el usuario squarecloud y la base de datos squarecloud creados para ti:
PostgreSQL exige SSL/TLS y el certificado de cliente, además de la contraseña. Descarga el .pem en Conexión → Certificado SSL/TLS y apunta el cliente a él:
Los clientes de Go rechazan sslmode=verify-full con este certificado (x509: certificate relies on legacy Common Name field): nombra el host solo en su Common Name, que Go ya no verifica. Usa sslmode=verify-ca, que sigue validando el certificado.
Los ORM y otros clientes (Prisma, Drizzle, JDBC, herramientas gráficas) se tratan en errores de conexión a bases de datos.

Conexiones

Cada base de datos acepta hasta 256 conexiones simultáneas, de las cuales 253 están disponibles para tus clientes. A partir de ahí, las conexiones nuevas fallan con remaining connection slots are reserved for roles with the SUPERUSER attribute (o sorry, too many clients already). Crea un pool por proceso al iniciar y reutilízalo, dimensionado para que todas las aplicaciones, workers y shards juntos queden por debajo del límite. Una conexión nueva por petición o por consulta agota el límite rápidamente. La pestaña Insights muestra quién mantiene las conexiones abiertas.

Tu usuario y permisos

El rol squarecloud tiene LOGIN, CREATEDB, CREATEROLE y BYPASSRLS, y es dueño de la base de datos squarecloud. Puedes crear bases de datos, esquemas, roles y permisos, y cambiar los ajustes que un usuario normal puede cambiar, para una sesión o como valor por defecto:
El rol no es superusuario y no tiene permisos de replicación. Eso descarta:
  • ALTER SYSTEM y los ajustes reservados a superusuarios;
  • COPY ... TO/FROM 'file' del lado del servidor (usa \copy en psql, que lee y escribe en tu máquina);
  • lenguajes no confiables como plpython3u;
  • la replicación lógica y las herramientas de captura de cambios (change data capture) que la necesitan.

Extensiones

Ya instaladas: plpgsql, además de pg_cron y pg_stat_statements en la base de datos postgres. Puedes activar estas en cualquiera de tus bases de datos con CREATE EXTENSION, en la base de datos que las va a usar: vector (pgvector), pg_trgm, pgcrypto, uuid-ossp, citext, hstore, unaccent, ltree, btree_gin, btree_gist, cube, dict_int, fuzzystrmatch, intarray, isn, lo, seg, tablefunc, tcn, tsm_system_rows, tsm_system_time.
No hay ninguna otra extensión disponible, y no se pueden añadir por solicitud. PostGIS, por ejemplo, no está disponible.

Tareas programadas con pg_cron

pg_cron vive en la base de datos postgres. Conéctate a postgres (la misma URL, terminada en /postgres) y programa la tarea para que se ejecute en tu base de datos. Los horarios están en UTC:
El historial de ejecuciones en cron.job_run_details nunca se limpia automáticamente. Programa una limpieza de tus filas antiguas:

Memoria y configuración

  • shared_buffers es el 25% de la RAM de la base de datos (al menos 128 MB). Cambiar la RAM reinicia la base de datos para aplicarlo.
  • Para el resto, PostgreSQL depende de la caché de archivos del sistema operativo, así que la RAM que muestra el dashboard sube y luego se mantiene alta. Es normal, no una fuga.
  • Una sola consulta puede escribir como máximo 1 GB de archivos temporales (ordenaciones, hashes). Si lo supera, la consulta falla con temporary file size exceeds temp_file_limit: añade un índice o procesa los datos por lotes.
  • El write-ahead log ocupa de 256 a 512 MB del almacenamiento de la base de datos.
  • La configuración del servidor es la misma en todas las bases de datos y no se puede cambiar por base de datos.

Consultas lentas

Las sentencias que tardan 100 ms o más se registran, y la pestaña Insights las lista con su tiempo medio. Para tu propio análisis, conéctate a la base de datos postgres, consulta pg_stat_statements y usa EXPLAIN ANALYZE en la sentencia:

Snapshots

Un snapshot de PostgreSQL contiene todas las bases de datos y roles de la instancia. Además de los casos generales, falla cuando una base de datos tiene ALLOW_CONNECTIONS false, o cuando un bloqueo tuyo (LOCK TABLE, un ALTER TABLE largo) lo impide durante más de 5 minutos. La exportación es texto SQL plano, así que una base de datos cerca de sus 10 GB de almacenamiento puede no caber en un snapshot.

Errores comunes

Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.