Aller au contenu

Préparer les bases

Cette procédure crée les trois bases SmartAGT, leurs deux rôles applicatifs et les extensions de la base vectorielle.

Base Propriétaire Contenu
smartagt smartagt Données applicatives, configuration et état des traitements
smartagt_vector smartagt Index documentaires, extensions vector et unaccent
smartagt_bff smartagt_bff Données de session du Frontend service

Prérequis

  • PostgreSQL 18 et pgvector préparés : Préparer PostgreSQL.
  • Un accès administrateur PostgreSQL, uniquement pour la préparation.

Procédure

1. Ouvrir la session SQL

sudo -u postgres psql -X -d postgres -v ON_ERROR_STOP=1
& 'C:\app\PostgreSQL\18\bin\psql.exe' -X -h localhost -U postgres -d postgres -W -v ON_ERROR_STOP=1

Adaptez le chemin de psql.exe à votre installation. Saisissez le mot de passe administrateur choisi à l’installation de PostgreSQL.

Ouvrez la session en TCP, sur l'adresse virtuelle de l'instance :

psql -X -h postgres.example.test -U postgres -d postgres -W -v ON_ERROR_STOP=1
& 'C:\app\PostgreSQL\18\bin\psql.exe' -X -h postgres.example.test -U postgres -d postgres -W -v ON_ERROR_STOP=1

Adaptez le chemin de psql.exe à votre installation.

Saisissez le mot de passe administrateur de l'instance. Si PostgreSQL est déjà chiffré (PostgreSQL SSL), posez avant la session PGSSLMODE=verify-full et PGSSLROOTCERT vers l’autorité.

Résultat attendu : l’invite postgres=# s’affiche.

2. Créer les rôles

Dans psql :

CREATE ROLE smartagt LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOREPLICATION;
CREATE ROLE smartagt_bff LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOREPLICATION;

Définissez un mot de passe distinct par rôle, d’au moins 20 caractères parmi lettres, chiffres, - et _, et conservez-le dans votre gestionnaire de secrets. psql le demande deux fois, sans l’afficher : attendez les deux demandes avant de continuer.

\password smartagt

Faites de même pour le Frontend service :

\password smartagt_bff

Résultat attendu : psql répond deux fois CREATE ROLE et accepte les deux mots de passe.

3. Créer les bases

CREATE DATABASE smartagt OWNER smartagt ENCODING 'UTF8' TEMPLATE template0;
CREATE DATABASE smartagt_vector OWNER smartagt ENCODING 'UTF8' TEMPLATE template0;
CREATE DATABASE smartagt_bff OWNER smartagt_bff ENCODING 'UTF8' TEMPLATE template0;
REVOKE ALL ON DATABASE smartagt FROM PUBLIC;
REVOKE ALL ON DATABASE smartagt_vector FROM PUBLIC;
REVOKE ALL ON DATABASE smartagt_bff FROM PUBLIC;

Résultat attendu : psql répond trois fois CREATE DATABASE, puis trois fois REVOKE.

4. Activer les extensions

\connect smartagt_vector
CREATE EXTENSION vector;
CREATE EXTENSION unaccent;
\quit

Résultat attendu : psql répond deux fois CREATE EXTENSION.

Cas particuliers

Serveur PostgreSQL distant

Ouvrez la session en TCP, avec le nom du serveur :

psql -X -h postgres.example.test -U postgres -d postgres -W -v ON_ERROR_STOP=1

Sous Windows, remplacez localhost par ce nom dans la commande de l’étape 1. Si PostgreSQL est chiffré (PostgreSQL SSL), posez avant la session PGSSLMODE=verify-full et PGSSLROOTCERT vers l’autorité. Avec les scripts, indiquez le serveur avec --host (Linux) ou -DatabaseHost (Windows).

Instance répliquée

Les bases, les rôles et les extensions se créent une seule fois, sur le primaire joint par l'adresse virtuelle : la réplication les porte sur les autres serveurs. pgvector doit être installée sur chacun d'eux : Préparer PostgreSQL.

Bases déjà créées par le DBA

Vérifiez avec lui que les trois bases appartiennent aux rôles indiqués dans le tableau, et que vector et unaccent sont activées dans smartagt_vector. La procédure n’est alors pas à rejouer.

Création interrompue

En cas d’interruption après une création partielle, contrôlez les objets créés avec le DBA avant de reprendre à l’étape concernée.