Bases de données

Créer une base, s'y connecter depuis un service, la sauvegarder.

Les bases se créent depuis db.ecloudserv.fr ou depuis le panel. Vous récupérez des identifiants de connexion, que vous passez à votre service par une variable d'environnement.

Créer une base#

Choisissez le moteur, donnez un nom, validez. Les identifiants s'affichent immédiatement : hôte, port, nom de la base, utilisateur, mot de passe.

Attention

Notez le mot de passe à la création. Comme les autres secrets, il ne se réaffiche plus librement ensuite — il faut demander explicitement à le révéler. Voir Variables & secrets.

S'y connecter depuis un service#

Ne mettez jamais ces identifiants dans le code. Créez une variable — par convention DATABASE_URL — et lisez-la au démarrage :

URL de connexion

# PostgreSQL
postgresql://utilisateur:motdepasse@hote:5432/nom_de_base

# MySQL / MariaDB
mysql://utilisateur:motdepasse@hote:3306/nom_de_base

Node.js

import { Pool } from "pg";

const pool = new Pool({ connectionString: process.env.DATABASE_URL });
const { rows } = await pool.query("SELECT now()");

Python

import os, psycopg

with psycopg.connect(os.environ["DATABASE_URL"]) as conn:
    with conn.cursor() as cur:
        cur.execute("SELECT now()")
        print(cur.fetchone())

Administrer sans client local#

L'interface web permet de parcourir les tables, lancer des requêtes et exporter des données, sans installer quoi que ce soit sur votre machine.

SQLite

Pour un petit projet, un simple fichier .db dans le service suffit. Le gestionnaire de fichiers du panel l'ouvre dans une interface dédiée plutôt que dans l'éditeur de texte.

Arrêtez le service avant d'écrire

Modifier un fichier SQLite pendant qu'un programme écrit dedans peut le corrompre. L'écriture depuis le panel n'est donc autorisée que service arrêté.

Sauvegardes#

Bases gérées — sauvegardes automatiques, avec restauration à une date donnée.
SQLite — le fichier est sauvegardé avec le reste du service, par les sauvegardes du service lui-même.

Astuce

Une sauvegarde qu'on n'a jamais restaurée n'est pas une sauvegarde. Testez-en une, une fois, sur un service de test : c'est le seul moyen de savoir qu'elle fonctionne avant d'en avoir vraiment besoin.