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
- Sélectionnez votre projet dans le sélecteur de projets
- Cliquez sur Bases de données dans la barre latérale
- 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
Utilisez uniquement des lettres minuscules, chiffres et tirets. Le nom devient partie du DNS interne.
Version PostgreSQL
Sélectionnez votre version PostgreSQL :
| Version | Recommandation |
|---|---|
| 17 | Dernières fonctionnalités, nouveaux projets |
| 16 | Stable, recommandé pour la production |
| 15 | Largement testé, choix sûr |
| 14-13 | Compatibilité 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.
| Classe | Ratio CPU:RAM | CPU Max | RAM Max | Description |
|---|---|---|---|---|
| Eco | 1:2 | 3 cores | 6 Go | Développement et tests |
| Standard | 1:4 | 15 cores | 58 Go | Bases de production générales |
| Production | 1:4 | 6 cores | 28 Go | Bases 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
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)
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
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 :
- Activez Accès Public
- Ajoutez les plages CIDR à la liste autorisée, avec une note optionnelle par entrée pour identifier son usage
- Seules les IPs listées peuvent se connecter depuis l'extérieur de votre projet
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
- Vérifiez votre configuration
- Cliquez sur Créer
- Attendez le provisionnement (~30 secondes)
Après la Création
Voir les Détails de Connexion
- Allez dans votre base de données
- Cliquez sur l'onglet Connexion
- 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)
- Accédez à votre instance PostgreSQL
- Cliquez sur l'onglet Databases & Users
- Cliquez sur Create Role
- Entrez un nom de rôle
- Configurez éventuellement l'accès aux bases avec les permissions : Superuser, Full, Write ou Read Only
- Cliquez sur Create Role
- 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.
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.
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