PostgreSQL: Utiliser PostgreSQL avec Django

Cette documentation fait partie du guide Premiers pas. Consultez le guide complet ici : Comment débuter avec PostgreSQL.

👋 Bienvenue sur la documentation de Stackhero !

Stackhero propose un service PostgreSQL cloud entièrement managé, conçu pour la fiabilité et la rapidité :

• Connexions et transferts de données illimités pour une montée en charge sans contrainte.
• Interface web PgAdmin incluse pour une gestion intuitive de vos bases de données.
• Extensions populaires incluses, telles que PostGIS, TimescaleDB et PgVector.
• Mises à jour simples en un clic pour garder votre base de données sécurisée et à jour.
• Performance élevée et sécurité renforcée sur une infrastructure privée et dédiée.

Vous pouvez démarrer avec l'hébergement PostgreSQL cloud de Stackhero en quelques minutes seulement. Profitez d'une expérience de base de données fiable et gagnez un temps précieux dans la gestion de vos données.

Si ce n'est pas déjà fait, installez le module psycopg qui sera utilisé pour se connecter à PostgreSQL :

pip install psycopg

Dans cette première étape, vous allez stocker le mot de passe directement dans le fichier settings.py. Cette méthode est uniquement destinée aux tests car elle n'est pas sécurisée. Plus loin dans cette documentation, vous trouverez un exemple de bonne pratique.

Ouvrez le fichier settings.py et ajoutez la configuration suivante :

DATABASES = {
  'default': {
    'ENGINE': 'django.db.backends.postgresql',
    'HOST': '<XXXXXX>.stackhero-network.com',
    'PORT': <PORT>,
    'OPTIONS': {
      'sslmode': 'require',
    },
    'NAME': 'admin',
    'USER': 'admin',
    'PASSWORD': '<ADMIN_PASSWORD>'
  }
}

Attention : cet exemple n'est pas recommandé pour la production et doit être utilisé uniquement pour des tests !

Une fois la connexion fonctionnelle, vous pouvez adopter une méthode plus sécurisée pour stocker les identifiants. L'exemple suivant utilise django-environ et stocke les identifiants dans un fichier .env.

1. Installez django-environ :

   pip install django-environ
   

2. Ouvrez le fichier settings.py et modifiez-le comme suit :

   import environ
   env = environ.Env()
   environ.Env.read_env()
   
   DATABASES = {
     'default': {
       'ENGINE': 'django.db.backends.postgresql',
       'HOST': env('STACKHERO_POSTGRESQL_HOST'),
       'PORT': <PORT>,
       'OPTIONS': {
         'sslmode': 'require',
       },
       'NAME': 'admin',
       'USER': 'admin',
       'PASSWORD': env('STACKHERO_POSTGRESQL_ADMIN_PASSWORD')
     }
   }
   

3. Ouvrez ou créez le fichier .env dans le même dossier que settings.py et ajoutez :

   STACKHERO_POSTGRESQL_HOST=<XXXXXX>.stackhero-network.com
   STACKHERO_POSTGRESQL_ADMIN_PASSWORD=<ADMIN_PASSWORD>
   

4. Enfin, ajoutez .env à votre fichier .gitignore pour éviter que vos identifiants ne soient stockés dans votre dépôt Git :

echo ".env" >> .gitignore