Aller au contenu

Préparer PostgreSQL

Cette procédure vérifie que votre instance PostgreSQL 18 répond aux exigences de SmartAGT, puis y installe l’extension pgvector.

Prérequis

  • Système conforme aux prérequis.
  • Console avec sudo (Linux) ou PowerShell 64 bits administrateur (Windows).
  • Instance PostgreSQL joignable par une adresse virtuelle stable, par exemple postgres.example.test. Sa haute disponibilité relève de votre infrastructure.
  • Système de chaque serveur PostgreSQL conforme aux prérequis.
  • Console avec sudo (Linux) ou PowerShell 64 bits administrateur (Windows).

Exigences

Exigence Attendu Référence
Version PostgreSQL 18 x64, cluster en UTF-8, client psql Linux, Windows
Écoute localhost par défaut, ou port 5432 ouvert à SmartAGT pour une instance distante Connexions
Accès Les rôles SmartAGT n’atteignent que leurs bases : règles d’accès ci-dessous pg_hba.conf
Extensions pgvector, installée ci-dessous ; unaccent, fournie avec PostgreSQL pgvector
Chiffrement Facultatif en PoC ; requis en production ou pour une instance distante PostgreSQL SSL
Exigence Attendu Référence
Version PostgreSQL 18 x64, cluster en UTF-8, client psql Linux, Windows
Écoute Port 5432 de l'adresse virtuelle, ouvert aux nœuds Backend et Frontend Connexions
Connexions max_connections dimensionné pour les services de tous les nœuds Connexions
Accès Les rôles SmartAGT n’atteignent que leurs bases : règles d’accès ci-dessous pg_hba.conf
Extensions pgvector, installée ci-dessous, et unaccent, fournie avec PostgreSQL pgvector
Chiffrement Requis : les nœuds joignent une instance distante PostgreSQL SSL

Règles d’accès

Placez ces règles avant les autorisations générales de pg_hba.conf :

host      smartagt,smartagt_vector             smartagt     127.0.0.1/32 scram-sha-256
host      smartagt,smartagt_vector             smartagt     ::1/128      scram-sha-256
host      smartagt_bff                         smartagt_bff 127.0.0.1/32 scram-sha-256
host      smartagt_bff                         smartagt_bff ::1/128      scram-sha-256
host      all                                  smartagt,smartagt_bff 0.0.0.0/0 reject
host      all                                  smartagt,smartagt_bff ::/0      reject

Les deux rejets finaux empêchent les rôles SmartAGT de retomber sur une autorisation générale. Composants sur d’autres serveurs : ajoutez avant ces rejets une règle par CIDR source, hôtes Platform pour smartagt,smartagt_vector, hôtes Frontend pour smartagt_bff.

Sur chaque serveur PostgreSQL de l'instance, placez ces règles avant les autorisations générales de pg_hba.conf :

host      smartagt,smartagt_vector             smartagt     <CIDR des nœuds Backend>  scram-sha-256
host      smartagt_bff                         smartagt_bff <CIDR des nœuds Frontend> scram-sha-256
host      all                                  smartagt,smartagt_bff 0.0.0.0/0 reject
host      all                                  smartagt,smartagt_bff ::/0      reject

Les deux rejets finaux empêchent les rôles SmartAGT de retomber sur une autorisation générale. Les nœuds Backend, workers compris, joignent smartagt et smartagt_vector, les nœuds Frontend smartagt_bff.

Rechargez ensuite la configuration (SELECT pg_reload_conf();).

Installer pgvector

L’extension s’installe sur le serveur PostgreSQL.

L’extension s’installe sur chaque serveur PostgreSQL de l'instance, primaire et réplicas.

Sur Debian ou Ubuntu, avec PostgreSQL 18 installé depuis le dépôt PGDG :

sudo apt-get update
sudo apt-get install -y postgresql-18-pgvector

Résultat attendu : vector.control est présent dans /usr/share/postgresql/18/extension/.

Prérequis :

  • les sources pgvector 0.8.7 extraites sous C:\build\pgvector ;
  • les outils C++ de Visual Studio ;
  • l’invite x64 Native Tools Command Prompt ouverte en administrateur.

La compilation peut se faire sur un poste de préparation Windows x64 équipé de PostgreSQL 18.

Adaptez PGROOT au répertoire de PostgreSQL :

set "PGROOT=C:\app\PostgreSQL\18"
cd /d C:\build\pgvector
nmake /F Makefile.win
nmake /F Makefile.win install

Si vous compilez sur un poste de préparation, transférez les fichiers compilés vers les mêmes sous-dossiers du serveur : lib\vector.dll, share\extension\vector.control et share\extension\vector--*.sql.

Résultat attendu : vector.control est présent dans C:\app\PostgreSQL\18\share\extension\.

Source : installation officielle pgvector.