Verwaltete Datenbank erstellen und verbinden

Einführung

Diese Anleitung bringt dich in wenigen Minuten von null zu einer live geschalteten, verbundenen Datenbank: Erstelle die Instanz über das Dashboard, hole dir den Connection String und verbinde dich damit aus deinem eigenen Code.

Voraussetzungen

Square-Cloud-Konto: Erstelle dein Konto über die Registrierungsseite.
Aktiver Standard-Plan oder höher: Verwaltete Datenbanken erfordern einen aktiven Standard-Plan oder höher. Sieh dir die verfügbaren Pläne an und wähle den, der zu deiner Arbeitslast passt.

Schritt 1: eine Engine wählen

Square Cloud bietet vier verwaltete Datenbank-Engines, bereits konfiguriert zum Verbinden und sofortigen Nutzen:

Engine	Version
PostgreSQL	17
MongoDB	8
MySQL	9
Redis	8

Diese Anleitung verwendet PostgreSQL, aber derselbe Dashboard-Ablauf gilt für jede der oben genannten Engines.

Schritt 2: die Datenbank erstellen

Eine neue Datenbankinstanz erstellen

Gehe zur Seite Datenbanken und klicke auf die Schaltfläche “Create Database”.

Deine Datenbankinstanz einrichten

Wähle PostgreSQL (oder die in Schritt 1 gewählte Engine) und fülle die erforderlichen Informationen aus, wie den Datenbanknamen und den RAM.

Erstellung deiner Instanz abschließen

Klicke auf die Schaltfläche “Create” und warte, bis die Datenbank erstellt ist.

Schritt 3: den Connection String erhalten

Sobald deine Datenbank bereit ist, öffne sie über die Seite Datenbanken. Die Verbindungsdetails (Host, Port, Benutzername, Passwort und Connection-URL) werden im Datenbank-Dashboard angezeigt, zusammen mit dem TLS-Zertifikat, das du für die Verbindung benötigst.

Square-Cloud-Datenbanken akzeptieren nur SSL/TLS-Verbindungen. Siehe wie verbinde ich mich mit meiner Datenbank für die Verwendung des Zertifikats bei verschiedenen Clients.

Schritt 4: aus deinem Code verbinden

Mit dem Connection String in der Hand, verbinde dich über den PostgreSQL-Client deiner Sprache.

Node.js
Python

Installiere das pg-Paket und aktiviere ES-Module, die das Beispiel unten verwendet (import und Top-Level-await):

npm install pg
npm pkg set type=module

Verbinde dich und überprüfe mit einer einfachen Abfrage:

index.js

import fs from "node:fs";
import { Client } from "pg";

const cert = fs.readFileSync("certificate.pem").toString();

const client = new Client({
  connectionString: process.env.DATABASE_URL, // postgresql://user:password@host:port/dbname
  ssl: { ca: cert, cert: cert, key: cert },
});

await client.connect();
const result = await client.query("SELECT 1");
console.log("Connected! Result:", result.rows[0]);
await client.end();

Installiere psycopg2:

pip install psycopg2-binary

Verbinde dich und überprüfe mit einer einfachen Abfrage:

main.py

import os
import psycopg2

conn = psycopg2.connect(
    os.environ["DATABASE_URL"],  # postgresql://user:password@host:port/dbname
    sslmode="verify-ca",
    sslrootcert="certificate.pem",
    sslcert="certificate.pem",
    sslkey="certificate.pem",
)
cur = conn.cursor()
cur.execute("SELECT 1")
print("Connected! Result:", cur.fetchone())
cur.close()
conn.close()

Wenn die Abfrage ein Ergebnis zurückgibt, statt einen Verbindungsfehler auszulösen, kommuniziert deine Anwendung erfolgreich mit der Datenbank.

Hardcode den Connection String niemals in deinem Quellcode. Setze ihn als Umgebungsvariable (DATABASE_URL) in den Umgebungsvariablen deiner Anwendung im Dashboard oder mit dem CLI-Befehl squarecloud app env set "DATABASE_URL=<connection-url>" --app <appID> (siehe Umgebungsvariablen in der CLI), damit Zugangsdaten nie in deinem Repository landen. Starte die Anwendung danach neu: Sie liest Umgebungsvariablen beim Start. Siehe Umgebungsvariablen.

Behalte certificate.pem in der ZIP-Datei deiner Anwendung, denn der Code liest sie von der Festplatte, aber halte sie aus jedem öffentlichen Repository heraus.

Nächste Schritte

Du hast jetzt eine laufende, aus deinem Code erreichbare verwaltete Datenbank. Von hier aus:

Eine App deployen, die sie nutzt

Hoste die Anwendung, die sich mit dieser Datenbank verbindet, auf Square Cloud.

Datenbank-Verbindungsfehler

Behebe SSL/TLS-, Timeout- und Zugriffsfehler.

Snapshots

Erstelle und stelle Datenbank-Snapshots über die CLI wieder her.

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.

Bots

Websites

APIs und Backends

Datenbanken

Selbst gehostete Apps

Anleitungen

Migrationsleitfäden

Verwaltete Datenbank erstellen und verbinden

Einführung

Voraussetzungen

Schritt 1: eine Engine wählen

Schritt 2: die Datenbank erstellen

Schritt 3: den Connection String erhalten

Schritt 4: aus deinem Code verbinden

Nächste Schritte

Eine App deployen, die sie nutzt

Datenbank-Verbindungsfehler

Snapshots

Kontaktiere uns

​Einführung

​Voraussetzungen

​Schritt 1: eine Engine wählen

​Schritt 2: die Datenbank erstellen

​Schritt 3: den Connection String erhalten

​Schritt 4: aus deinem Code verbinden

​Nächste Schritte

Eine App deployen, die sie nutzt

Datenbank-Verbindungsfehler

Snapshots

​Kontaktiere uns

Einführung

Voraussetzungen

Schritt 1: eine Engine wählen

Schritt 2: die Datenbank erstellen

Schritt 3: den Connection String erhalten

Schritt 4: aus deinem Code verbinden

Nächste Schritte

Kontaktiere uns