Zum Hauptinhalt springen
Eine verwaltete PostgreSQL-Instanz mit TLS-Verbindung per Client-Zertifikat, einer Datenbank und einer Rolle, die dir gehören, beliebten Erweiterungen, die du nur noch aktivieren musst, und pg_cron für geplante Jobs. Was für alle Engines gilt (Limits, Snapshots, Insights), steht in der Datenbank-Übersicht.

Verbinden

Kopiere die Verbindungs-URL von der Seite der Datenbank im Dashboard. Sie hat diese Form, mit dem Benutzer squarecloud und der Datenbank squarecloud, die für dich angelegt werden:
PostgreSQL verlangt SSL/TLS und das Client-Zertifikat, zusätzlich zum Passwort. Lade die .pem unter Verbindung → SSL/TLS-Zertifikat herunter und gib sie im Client an:
Go-Clients lehnen sslmode=verify-full mit diesem Zertifikat ab (x509: certificate relies on legacy Common Name field): Es nennt den Host nur in seinem Common Name, den Go nicht mehr prüft. Verwende sslmode=verify-ca, das das Zertifikat trotzdem validiert.
ORMs und andere Clients (Prisma, Drizzle, JDBC, GUI-Tools) werden unter Datenbankverbindungsfehler behandelt.

Verbindungen

Jede Datenbank akzeptiert bis zu 256 gleichzeitige Verbindungen, davon sind 253 für deine Clients verfügbar. Darüber hinaus schlagen neue Verbindungen mit remaining connection slots are reserved for roles with the SUPERUSER attribute (oder sorry, too many clients already) fehl. Erstelle beim Start einen Pool pro Prozess und verwende ihn wieder, so bemessen, dass alle Apps, Worker und Shards zusammen unter dem Limit bleiben. Eine neue Verbindung pro Request oder pro Query erschöpft das Limit schnell. Der Tab Insights zeigt, wer die offenen Verbindungen hält.

Dein Benutzer und seine Berechtigungen

Die Rolle squarecloud hat LOGIN, CREATEDB, CREATEROLE und BYPASSRLS und ist Eigentümerin der Datenbank squarecloud. Du kannst Datenbanken, Schemas, Rollen und Grants erstellen und Einstellungen ändern, die ein normaler Benutzer ändern darf, für eine Sitzung oder als Standard:
Die Rolle ist kein Superuser und hat keine Replikationsrechte. Das schließt aus:
  • ALTER SYSTEM und Einstellungen, die Superusern vorbehalten sind;
  • serverseitiges COPY ... TO/FROM 'file' (verwende \copy in psql, das auf deinem Rechner liest und schreibt);
  • nicht vertrauenswürdige Sprachen wie plpython3u;
  • logische Replikation und Change-Data-Capture-Tools, die sie brauchen.

Erweiterungen

Bereits installiert: plpgsql, dazu pg_cron und pg_stat_statements in der Datenbank postgres. Diese kannst du in jeder deiner Datenbanken mit CREATE EXTENSION aktivieren, und zwar in der Datenbank, die sie nutzen wird: 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.
Keine andere Erweiterung ist verfügbar, und es können auch auf Anfrage keine hinzugefügt werden. PostGIS zum Beispiel ist nicht verfügbar.

Geplante Jobs mit pg_cron

pg_cron liegt in der Datenbank postgres. Verbinde dich mit postgres (dieselbe URL, endend auf /postgres) und plane den Job so, dass er in deiner Datenbank läuft. Zeitpläne sind in UTC:
Der Ausführungsverlauf in cron.job_run_details wird nie automatisch bereinigt. Plane eine Bereinigung deiner alten Zeilen:

Arbeitsspeicher und Konfiguration

  • shared_buffers beträgt 25 % des RAM der Datenbank (mindestens 128 MB). Eine Änderung des RAM startet die Datenbank neu, um ihn zu übernehmen.
  • Für den Rest verlässt sich PostgreSQL auf den Datei-Cache des Betriebssystems, daher steigt der im Dashboard angezeigte RAM und bleibt dann hoch. Das ist normal, kein Leak.
  • Eine einzelne Abfrage kann höchstens 1 GB temporäre Dateien schreiben (Sortierungen, Hashes). Darüber hinaus schlägt die Abfrage mit temporary file size exceeds temp_file_limit fehl: Füge einen Index hinzu oder verarbeite die Daten in Batches.
  • Das Write-Ahead-Log belegt 256 bis 512 MB des Speicherplatzes der Datenbank.
  • Die Serverkonfiguration ist auf jeder Datenbank gleich und kann nicht pro Datenbank geändert werden.

Langsame Abfragen

Anweisungen, die 100 ms oder länger dauern, werden aufgezeichnet, und der Tab Insights listet sie mit ihrer mittleren Zeit auf. Für deine eigene Analyse verbinde dich mit der Datenbank postgres, frage pg_stat_statements ab und nutze EXPLAIN ANALYZE für die Anweisung:

Snapshots

Ein PostgreSQL-Snapshot enthält jede Datenbank und jede Rolle der Instanz. Neben den allgemeinen Fällen schlägt er fehl, wenn eine Datenbank ALLOW_CONNECTIONS false hat oder wenn deine eigene Sperre (LOCK TABLE, ein langes ALTER TABLE) ihn länger als 5 Minuten blockiert. Der Export ist reiner SQL-Text, daher passt eine Datenbank nahe an ihren 10 GB Speicherplatz eventuell nicht in einen Snapshot.

Häufige Fehler

Kontaktiere uns

Falls du weiterhin technische Schwierigkeiten hast, steht dir unser spezialisiertes Support-Team zur Verfügung. Kontaktiere uns und wir helfen dir gerne, jedes Problem zu lösen: die Qualität unseres Supports ist ein wichtiger Grund, warum Entwickler Square Cloud mit 4,9/5 bei 402 Bewertungen auf Google und Trustpilot bewerten.