> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# So stellst du deine erste verwaltete Datenbank bereit

> Schritt-für-Schritt-Anleitung zum Hosten einer verwalteten MongoDB-, PostgreSQL-, MySQL- oder Redis-Datenbank auf Square Cloud und zur Verbindung mit ihr aus deinem Anwendungscode.

## 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](https://squarecloud.app/de/signup).
* **Aktiver Standard-Plan oder höher**: Verwaltete Datenbanken erfordern einen **aktiven Standard-Plan oder höher**. Sieh dir die [verfügbaren Pläne](/de/platform/plans) 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.x.x |
|   MongoDB  |  8.x.x  |
|    MySQL   |  9.x.x  |
|    Redis   |  7.4.x  |

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

## Schritt 2: Die Datenbank erstellen

<Steps>
  <Step title="Eine neue Datenbankinstanz erstellen">
    Gehe zur Seite [Datenbanken](https://squarecloud.app/de/dashboard/databases) und klicke auf die Schaltfläche "Create Database".
  </Step>

  <Step title="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.
  </Step>

  <Step title="Erstellung deiner Instanz abschließen">
    Klicke auf die Schaltfläche "Create" und warte, bis die Datenbank erstellt ist.
  </Step>
</Steps>

## Schritt 3: Den Connection String erhalten

Sobald deine Datenbank bereit ist, öffne sie über die Seite [Datenbanken](https://squarecloud.app/de/dashboard/databases). 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.

<Note>Square-Cloud-Datenbanken akzeptieren nur SSL/TLS-Verbindungen. Siehe [wie verbinde ich mich mit meiner Datenbank](/de/services/databases#wie-verbinde-ich-mich-mit-meiner-datenbank) für die Verwendung des Zertifikats bei verschiedenen Clients.</Note>

## Schritt 4: Aus deinem Code verbinden

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

<Tabs>
  <Tab title="Node.js">
    Installiere das [`pg`](https://www.npmjs.com/package/pg)-Paket:

    ```bash theme={null}
    npm install pg
    ```

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

    ```javascript index.js theme={null}
    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();
    ```
  </Tab>

  <Tab title="Python">
    Installiere [`psycopg2`](https://pypi.org/project/psycopg2-binary/):

    ```bash theme={null}
    pip install psycopg2-binary
    ```

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

    ```python main.py theme={null}
    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()
    ```
  </Tab>
</Tabs>

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

<Warning>Hardcode den Connection String niemals in deinem Quellcode. Setze ihn als Umgebungsvariable (`DATABASE_URL`) über deine [Konfigurationsdatei](/de/getting-started/config-file) oder das Dashboard, damit Zugangsdaten nie in deinem Repository landen.</Warning>

## Deine Datenbank ist live

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

<CardGroup cols={2}>
  <Card title="Eine App deployen, die sie nutzt" icon="server" href="/de/tutorials/how-to-deploy-your-website">
    Hoste die Anwendung, die sich mit dieser Datenbank verbindet, auf Square Cloud.
  </Card>

  <Card title="Snapshots" icon="camera" href="/de/cli-reference/commands/database/snapshot">
    Erstelle und stelle Datenbank-Snapshots über die CLI wieder her.
  </Card>
</CardGroup>

## Kontaktiere uns

Falls du weiterhin **technische Schwierigkeiten** hast, steht dir unser **spezialisiertes Support-Team** zur Verfügung. [**Kontaktiere uns**](https://squarecloud.app/de/support) 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**](https://www.trustpilot.com/review/squarecloud.app) auf Google und Trustpilot bewerten.