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.