Passer au contenu principal
Une instance PostgreSQL gérée avec une connexion TLS par certificat client, une base de données et un rôle qui vous appartiennent, des extensions populaires prêtes à être activées et pg_cron pour les tâches planifiées. Les informations communes à tous les moteurs (limites, snapshots, Insights) se trouvent dans la vue d’ensemble des bases de données.

Se connecter

Copiez l’URL de connexion depuis la page de la base de données dans le tableau de bord. Elle a cette forme, avec l’utilisateur squarecloud et la base de données squarecloud créés pour vous :
PostgreSQL exige SSL/TLS et le certificat client, en plus du mot de passe. Téléchargez le .pem sous Connexion → Certificat SSL/TLS et indiquez-le au client :
Les clients Go rejettent sslmode=verify-full avec ce certificat (x509: certificate relies on legacy Common Name field) : il ne nomme l’hôte que dans son Common Name, que Go ne vérifie plus. Utilisez sslmode=verify-ca, qui valide quand même le certificat.
Les ORM et les autres clients (Prisma, Drizzle, JDBC, outils graphiques) sont traités dans les erreurs de connexion aux bases de données.

Connexions

Chaque base de données accepte jusqu’à 256 connexions simultanées, dont 253 sont disponibles pour vos clients. Au-delà, les nouvelles connexions échouent avec remaining connection slots are reserved for roles with the SUPERUSER attribute (ou sorry, too many clients already). Créez un seul pool par processus au démarrage et réutilisez-le, dimensionné pour que l’ensemble des applications, workers et shards reste sous la limite. Une nouvelle connexion à chaque requête reçue ou à chaque requête SQL épuise vite la limite. L’onglet Insights montre qui détient les connexions ouvertes.

Votre utilisateur et ses permissions

Le rôle squarecloud dispose de LOGIN, CREATEDB, CREATEROLE et BYPASSRLS, et possède la base de données squarecloud. Vous pouvez créer des bases de données, des schémas, des rôles et des droits (grants), et modifier les paramètres qu’un utilisateur ordinaire peut modifier, pour une session ou par défaut :
Le rôle n’est pas superutilisateur et n’a pas de droits de réplication. Cela exclut :
  • ALTER SYSTEM et les paramètres réservés aux superutilisateurs ;
  • COPY ... TO/FROM 'file' côté serveur (utilisez \copy dans psql, qui lit et écrit sur votre machine) ;
  • les langages non fiables comme plpython3u ;
  • la réplication logique et les outils de capture des changements (change data capture) qui en dépendent.

Extensions

Déjà installées : plpgsql, ainsi que pg_cron et pg_stat_statements dans la base de données postgres. Vous pouvez activer celles-ci dans n’importe laquelle de vos bases de données avec CREATE EXTENSION, dans la base de données qui les utilisera : 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.
Aucune autre extension n’est disponible, et aucune ne peut être ajoutée sur demande. PostGIS, par exemple, n’est pas disponible.

Tâches planifiées avec pg_cron

pg_cron se trouve dans la base de données postgres. Connectez-vous à postgres (même URL, terminée par /postgres) et planifiez la tâche pour qu’elle s’exécute dans votre base de données. Les horaires sont en UTC :
L’historique des exécutions dans cron.job_run_details n’est jamais purgé automatiquement. Planifiez le nettoyage de vos anciennes lignes :

Mémoire et configuration

  • shared_buffers vaut 25 % de la RAM de la base de données (au moins 128 Mo). Modifier la RAM redémarre la base de données pour l’appliquer.
  • Pour le reste, PostgreSQL s’appuie sur le cache de fichiers du système d’exploitation, donc la RAM affichée dans le tableau de bord monte puis reste élevée. C’est normal, ce n’est pas une fuite.
  • Une seule requête peut écrire au plus 1 Go de fichiers temporaires (tris, hachages). Au-delà, la requête échoue avec temporary file size exceeds temp_file_limit : ajoutez un index ou traitez les données par lots.
  • Le journal d’écriture anticipée (write-ahead log) occupe de 256 à 512 Mo du stockage de la base de données.
  • La configuration du serveur est la même sur chaque base de données et ne peut pas être modifiée base par base.

Requêtes lentes

Les instructions qui prennent 100 ms ou plus sont enregistrées, et l’onglet Insights les liste avec leur temps moyen. Pour votre propre analyse, connectez-vous à la base de données postgres, interrogez pg_stat_statements et utilisez EXPLAIN ANALYZE sur l’instruction :

Snapshots

Un snapshot PostgreSQL contient toutes les bases de données et tous les rôles de l’instance. En plus des cas généraux, il échoue quand une base de données a ALLOW_CONNECTIONS false, ou quand l’un de vos propres verrous (LOCK TABLE, un long ALTER TABLE) le bloque pendant plus de 5 minutes. L’export est du texte SQL brut, donc une base de données proche de ses 10 Go de stockage peut ne pas tenir dans un snapshot.

Erreurs courantes

Contactez-nous

Si vous rencontrez toujours des difficultés techniques, notre équipe de support spécialisée est disponible pour vous aider. Contactez-nous et nous serons ravis de vous aider à résoudre tout problème. La qualité du support compte pour beaucoup dans la note que les développeurs donnent à Square Cloud, 4,9/5 sur 402 avis sur Google et Trustpilot.