> ## 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.

# Comment déployer votre première base de données gérée

> Tutoriel étape par étape pour héberger une base de données MongoDB, PostgreSQL, MySQL ou Redis gérée sur Square Cloud et s'y connecter depuis le code de votre application.

## Introduction

Ce tutoriel vous emmène de zéro à une base de données connectée et en ligne en quelques minutes : créez l'instance depuis le tableau de bord, récupérez sa chaîne de connexion, et connectez-vous depuis votre propre code.

### Prérequis

* **Compte Square Cloud** : Créez votre compte via la [page d'inscription](https://squarecloud.app/fr/signup).
* **Plan Standard actif ou supérieur** : Les bases de données gérées nécessitent un **plan Standard actif ou supérieur**. Consultez les [plans disponibles](/fr/platform/plans) et choisissez celui qui correspond à votre charge de travail.

## Étape 1 : Choisir un moteur

Square Cloud propose quatre moteurs de base de données gérés, déjà configurés pour être connectés et utilisés immédiatement :

|   Moteur   | Version |
| :--------: | :-----: |
| PostgreSQL |  17.x.x |
|   MongoDB  |  8.x.x  |
|    MySQL   |  9.x.x  |
|    Redis   |  7.4.x  |

Ce tutoriel utilise **PostgreSQL**, mais le même flux du tableau de bord s'applique à chaque moteur ci-dessus.

## Étape 2 : Créer la base de données

<Steps>
  <Step title="Créer une nouvelle instance de base de données">
    Rendez-vous sur la page [Bases de données](https://squarecloud.app/fr/dashboard/databases) et cliquez sur le bouton « Créer une base de données ».
  </Step>

  <Step title="Configurer votre instance de base de données">
    Sélectionnez **PostgreSQL** (ou le moteur choisi à l'étape 1) et remplissez les informations requises, telles que le nom de la base de données et la RAM.
  </Step>

  <Step title="Finaliser la création de votre instance">
    Cliquez sur le bouton « Créer » et attendez la création de la base de données.
  </Step>
</Steps>

## Étape 3 : Récupérer la chaîne de connexion

Une fois votre base de données prête, ouvrez-la depuis la page [Bases de données](https://squarecloud.app/fr/dashboard/databases). Les détails de connexion (hôte, port, nom d'utilisateur, mot de passe et URL de connexion) sont affichés dans le tableau de bord de la base de données, aux côtés du certificat TLS dont vous aurez besoin pour vous connecter.

<Note>Les bases de données Square Cloud n'acceptent que les connexions SSL/TLS. Consultez [comment me connecter à ma base de données](/fr/services/databases) pour savoir comment le certificat est utilisé par différents clients.</Note>

## Étape 4 : Se connecter depuis votre code

Une fois la chaîne de connexion en main, connectez-vous en utilisant le client PostgreSQL de votre langage.

<Tabs>
  <Tab title="Node.js">
    Installez le paquet [`pg`](https://www.npmjs.com/package/pg) :

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

    Connectez-vous et vérifiez avec une requête simple :

    ```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">
    Installez [`psycopg2`](https://pypi.org/project/psycopg2-binary/) :

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

    Connectez-vous et vérifiez avec une requête simple :

    ```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>

Si la requête renvoie un résultat au lieu de lever une erreur de connexion, votre application communique bien avec la base de données.

<Warning>Ne codez jamais en dur la chaîne de connexion dans votre code source. Définissez-la comme variable d'environnement (`DATABASE_URL`) via votre [fichier de configuration](/fr/getting-started/config-file) ou le tableau de bord, afin que les identifiants ne se retrouvent jamais dans votre dépôt.</Warning>

## Votre base de données est en ligne

Vous avez maintenant une base de données gérée qui tourne et est accessible depuis votre code. À partir d'ici :

<CardGroup cols={2}>
  <Card title="Déployer une application pour l'utiliser" icon="server" href="/fr/tutorials/how-to-deploy-your-website">
    Hébergez l'application qui se connecte à cette base de données sur Square Cloud.
  </Card>

  <Card title="Snapshots" icon="camera" href="/fr/cli-reference/commands/database/snapshot">
    Créez et restaurez des snapshots de base de données depuis la CLI.
  </Card>
</CardGroup>

## Contactez-nous

Si vous rencontrez toujours des **difficultés techniques**, notre **équipe de support spécialisée** est disponible pour vous aider. [**Contactez-nous**](https://squarecloud.app/fr/support) 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**](https://www.trustpilot.com/review/squarecloud.app) sur Google et Trustpilot.