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.