Aller au contenu principal

Créer une Base de Données

Créez une base de données PostgreSQL managée en quelques minutes.

Prérequis​

  • Un projet créé dans votre organisation
  • Compréhension des besoins de votre application en base de données

Guide Pas à Pas​

1. Accéder aux Bases de Données​

  1. Sélectionnez votre projet dans le sélecteur de projets
  2. Cliquez sur Bases de données dans la barre latérale
  3. Cliquez sur Nouvelle Base de Données

2. Configuration de Base​

Nom de la Base de Données​

Entrez un nom unique pour votre base de données :

Valide: my-db, api-database, prod-postgres
Invalide: My DB, my_database, database.prod
Nommage

Utilisez uniquement des lettres minuscules, chiffres et tirets. Le nom devient partie du DNS interne.

Version PostgreSQL​

Sélectionnez votre version PostgreSQL :

VersionRecommandation
17Dernières fonctionnalités, nouveaux projets
16Stable, recommandé pour la production
15Largement testé, choix sûr
14-13Compatibilité legacy

3. Configuration du Calcul​

Classe de Calcul​

Sélectionnez une classe de calcul selon votre charge de travail. Chaque classe a un ratio CPU:RAM fixe, et vous configurez les ressources avec des curseurs.

ClasseRatio CPU:RAMCPU MaxRAM MaxDescription
Eco1:23 cores6 GoDéveloppement et tests
Standard1:415 cores58 GoBases de production générales
Production1:46 cores28 GoBases critiques nécessitant des ressources dédiées

Allocation des Ressources​

Dans chaque classe, configurez les ressources avec des curseurs :

  • CPU : Ajustez par incréments (varie selon la classe)
  • Mémoire : Calculée automatiquement selon le ratio CPU:RAM

Exemple avec la classe Standard (ratio 1:4) :

  • 1 vCPU → 4 Go RAM
  • 2 vCPU → 8 Go RAM
  • 4 vCPU → 16 Go RAM
Choisir les Ressources

Commencez avec Eco et des ressources minimales pour le développement. Utilisez Standard ou Production pour les charges de production.

Taille du Stockage​

Choisissez la capacité de stockage initiale :

  • Minimum : 10 Go
  • Maximum : 1000 Go
  • Le stockage peut être augmenté plus tard (sans interruption)
Stockage

Le stockage ne peut être qu'augmenté, pas diminué. Commencez avec ce dont vous avez besoin.

4. Haute Disponibilité (Optionnel)​

Activez pour les charges de production :

  • Réplicas standby dans différentes zones
  • Failover automatique en cas de panne du primaire
  • Temps de récupération < 30 secondes

En savoir plus sur la HA →

5. Accès & Sécurité​

Bases de Données​

Créez au moins une base de données lors de la configuration :

  • Entrez un nom de base (ex : app, production)
  • Vous pouvez ajouter plusieurs bases

Utilisateurs​

Créez au moins un utilisateur lors de la configuration :

  • Entrez un nom d'utilisateur
  • Un mot de passe sécurisé est auto-généré
  • Vous pouvez ajouter plusieurs utilisateurs avec différents niveaux d'accès

Accès Public (Optionnel)​

Activez l'accès externe à votre base de données :

  1. Activez Accès Public
  2. Ajoutez les plages CIDR à la liste autorisée, avec une note optionnelle par entrée pour identifier son usage
  3. Seules les IPs listées peuvent se connecter depuis l'extérieur de votre projet
Bonne Pratique de Sécurité

Gardez l'accès public désactivé sauf si nécessaire. Utilisez la liste d'IP autorisées pour restreindre l'accès aux adresses connues uniquement.

6. Créer la Base de Données​

  1. Vérifiez votre configuration
  2. Cliquez sur Créer
  3. Attendez le provisionnement (~30 secondes)

Après la Création​

Voir les Détails de Connexion​

  1. Allez dans votre base de données
  2. Cliquez sur l'onglet Connexion
  3. Consultez ou copiez :
    • Hôte
    • Port
    • Nom d'utilisateur
    • Mot de passe
    • Chaîne de connexion

Tester la Connexion​

Depuis un conteneur dans le même projet (format DNS interne {service-name}.{namespace}) :

# Avec psql
psql postgresql://postgres:[email protected]:5432/postgres

# Requête de test
SELECT version();

Configurer Votre Application​

Définissez la variable d'environnement DATABASE_URL dans votre conteneur :

DATABASE_URL=postgresql://postgres:[email protected]:5432/postgres

Le namespace est automatiquement assigné à votre projet. Vous trouverez la chaîne de connexion complète dans l'onglet Connexion de la base de données.

Exemples de Connexion​

Node.js (pg)​

const { Pool } = require('pg');

const pool = new Pool({
connectionString: process.env.DATABASE_URL,
ssl: false // Les connexions internes n'ont pas besoin de SSL
});

// Exemple de requête
const result = await pool.query('SELECT * FROM users WHERE id = $1', [userId]);

Python (psycopg2)​

import psycopg2
import os

conn = psycopg2.connect(os.environ['DATABASE_URL'])
cursor = conn.cursor()
cursor.execute('SELECT * FROM users WHERE id = %s', (user_id,))

Go (pgx)​

import (
"context"
"os"
"github.com/jackc/pgx/v5/pgxpool"
)

pool, err := pgxpool.New(context.Background(), os.Getenv("DATABASE_URL"))
if err != nil {
log.Fatal(err)
}

Ruby (pg)​

require 'pg'

conn = PG.connect(ENV['DATABASE_URL'])
result = conn.exec('SELECT * FROM users WHERE id = $1', [user_id])

Configuration Initiale​

Ajouter Plus de Bases de Données​

Vous pouvez créer des bases supplémentaires après la configuration initiale :

CREATE DATABASE myapp_test;
CREATE DATABASE analytics;

Ajouter Plus d'Utilisateurs (Rôles)​

  1. Accédez à votre instance PostgreSQL
  2. Cliquez sur l'onglet Databases & Users
  3. Cliquez sur Create Role
  4. Entrez un nom de rôle
  5. Configurez éventuellement l'accès aux bases avec les permissions : Superuser, Full, Write ou Read Only
  6. Cliquez sur Create Role
  7. Un mot de passe est auto-généré et affiché une seule fois — copiez-le immédiatement

Pour modifier le niveau d'accès d'un rôle existant, cliquez sur l'icône crayon à côté du rôle dans l'onglet Databases & Users.

Rôles provisionnés par une connexion

Les rôles créés par une connexion ne peuvent pas être modifiés ou supprimés depuis cet onglet. Gérez-les via la connexion qui les a provisionnés.

Gestion des mots de passe

Pour réinitialiser le mot de passe d'un rôle, cliquez sur l'icône clé à côté du rôle dans l'onglet Databases & Users.

Activer les Extensions​

Activez les extensions couramment nécessaires :

-- Génération UUID
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";

-- Recherche plein texte
CREATE EXTENSION IF NOT EXISTS "pg_trgm";

-- Statistiques des requêtes
CREATE EXTENSION IF NOT EXISTS "pg_stat_statements";

Dépannage​

Connexion Refusée​

  • Vérifiez que la base de données est à l'état Running
  • Vérifiez que vous vous connectez depuis le même projet
  • Vérifiez le hostname et le port

Échec d'Authentification​

  • Vérifiez le mot de passe (copiez depuis l'onglet Connexion)
  • Vérifiez que le nom d'utilisateur est correct
  • Attention aux caractères spéciaux dans le mot de passe

Timeout de Connexion​

  • Assurez-vous que votre conteneur est dans le même projet
  • Vérifiez les problèmes réseau
  • Vérifiez que la base de données n'est pas surchargée

Trop de Connexions​

  • Vérifiez le pooling de connexions de votre application
  • Passez à une classe de calcul supérieure
  • Revoyez et fermez les connexions inactives
-- Vérifier les connexions actives
SELECT count(*) FROM pg_stat_activity;

-- Terminer les connexions inactives
SELECT pg_terminate_backend(pid)
FROM pg_stat_activity
WHERE state = 'idle'
AND query_start < now() - interval '1 hour';

Bonnes Pratiques​

Utiliser le Connection Pooling​

Pour les applications de production :

  • Utilisez un pool de connexions (PgBouncer, intégré dans beaucoup de drivers)
  • Définissez des tailles de pool appropriées
  • Fermez les connexions quand c'est fait

Sécuriser Votre Base de Données​

  • Utilisez des utilisateurs spécifiques pour différentes apps
  • Accordez des permissions minimales
  • Renouvelez les mots de passe régulièrement

Planifier la Croissance​

  • Surveillez l'utilisation du stockage
  • Configurez des alertes pour l'utilisation élevée
  • Planifiez les mises à niveau de calcul à l'avance

Prochaines Étapes​