Extensions PostgreSQL
Améliorez votre base de données PostgreSQL avec des extensions puissantes.
Vue d'Ensemble
Les extensions PostgreSQL ajoutent des fonctionnalités au-delà de la base de données de base. SailOps supporte de nombreuses extensions populaires prêtes à l'emploi.
Extensions Disponibles
Toutes les extensions ne sont pas disponibles sur toutes les versions majeures
de PostgreSQL, et certaines nécessitent une image de conteneur spécialisée.
SailOps choisit automatiquement la bonne image selon les extensions
sélectionnées. Consultez
Compatibilité des images & limitations
avant d'activer PostGIS, TimescaleDB, pg_cron, pgrouting ou ogr_fdw.
Extensions de Base
| Extension | Description |
|---|---|
pgcrypto | Fonctions cryptographiques |
uuid-ossp | Génération UUID |
pg_stat_statements | Statistiques des requêtes |
plpgsql | Langage procédural PL/pgSQL |
Recherche & Texte
| Extension | Description |
|---|---|
pg_trgm | Correspondance par trigrammes pour recherche floue |
fuzzystrmatch | Correspondance de chaînes floue |
unaccent | Supprimer les accents des chaînes |
Types de Données
| Extension | Description |
|---|---|
hstore | Stockage clé-valeur |
ltree | Structures arborescentes hiérarchiques |
citext | Texte insensible à la casse |
cube | Cubes multidimensionnels |
Géographique
| Extension | Description |
|---|---|
postgis | Objets et requêtes géographiques |
postgis_topology | Données topologiques |
postgis_tiger_geocoder | Géocodage US |
JSON & Tableaux
| Extension | Description |
|---|---|
jsonb_plpython3u | JSON dans PL/Python |
Monitoring
| Extension | Description |
|---|---|
pg_stat_statements | Performance des requêtes |
pg_stat_kcache | Stats système |
pgrowlocks | Verrouillage au niveau ligne |
Compatibilité des images & limitations
Les extensions ne sont pas toutes fournies dans la même image de conteneur.
Lorsque vous créez ou modifiez une base PostgreSQL, SailOps examine les
extensions demandées et sélectionne automatiquement l'image runtime
appropriée — vous ne choisissez jamais d'image manuellement. Si vous demandez
une combinaison qu'aucune image ne peut satisfaire, l'API rejette la requête
avec une erreur 400 explicite au lieu de produire un cluster cassé.
Images runtime
| Image | Contenu | Utilisée quand |
|---|---|---|
| Standard | PostgreSQL + extensions contrib, pgaudit, pgvector | Par défaut — toute combinaison d'extensions core/contrib |
| PostGIS | Tout le contenu de Standard plus la famille PostGIS | Vous demandez une extension PostGIS (PG 15–17 uniquement) |
| TimescaleDB | TimescaleDB plus PostGIS (sans le backend SFCGAL), pgvector, pg_cron, pgrouting, contrib | Vous demandez timescaledb, pg_cron ou pgrouting |
Comme les images PostGIS et TimescaleDB sont construites au-dessus de l'image
Standard, pgvector, pgaudit et toutes les extensions contrib y restent
disponibles. En particulier, PostGIS et pgvector sont compatibles et
peuvent être activés sur la même base.
L'image PostGIS n'est approuvée que pour PostgreSQL 15, 16 et 17 — la
famille PostGIS n'est pas disponible sur PG 13 ou 14. L'image TimescaleDB
embarque PostGIS mais sans le backend SFCGAL, donc postgis_sfcgal ne peut
pas être combinée avec timescaledb (voir Combinaisons incompatibles).
Matrice de compatibilité
Légende : ✅ disponible · ❌ non disponible. La colonne Image indique l'image minimale requise ; SailOps fait évoluer l'image automatiquement pour couvrir tout ce que vous sélectionnez.
| Extension | Image | PG 13 | PG 14 | PG 15 | PG 16 | PG 17 | Notes |
|---|---|---|---|---|---|---|---|
Toutes les extensions core & contrib (plpgsql, pgcrypto, uuid-ossp, hstore, ltree, pg_trgm, pg_stat_statements, …) | Standard | ✅ | ✅ | ✅ | ✅ | ✅ | Toujours disponibles |
pgvector | Standard | ✅ | ✅ | ✅ | ✅ | ✅ | Incluse dans l'image Standard |
pgaudit | Standard | ✅ | ✅ | ✅ | ✅ | ✅ | Incluse dans l'image Standard |
postgis, postgis_topology, postgis_raster, postgis_tiger_geocoder, address_standardizer, address_standardizer_data_us | PostGIS | ❌ | ❌ | ✅ | ✅ | ✅ | Bascule la base sur l'image PostGIS, approuvée uniquement pour PG 15–17 |
postgis_sfcgal | PostGIS | ❌ | ❌ | ✅ | ✅ | ✅ | Géométrie 3D (backend SFCGAL) sur l'image PostGIS (PG 15–17). Ne peut pas être combinée avec timescaledb — l'image TimescaleDB n'a pas de backend SFCGAL |
timescaledb | TimescaleDB | ❌ | ❌ | ✅ | ✅ | ✅ | Support de PG 13/14 abandonné dans les versions récentes |
pg_cron | TimescaleDB | ❌ | ❌ | ✅ | ✅ | ✅ | Fournie uniquement dans l'image TimescaleDB, qui exige PG 15+ |
pgrouting | TimescaleDB | ❌ | ❌ | ✅ | ✅ | ✅ | Fournie uniquement dans l'image TimescaleDB, qui exige PG 15+ ; dépend de postgis |
ogr_fdw | — | ❌ | ❌ | ❌ | ❌ | ❌ | Non disponible dans aucune image actuelle |
Correspondance des versions TimescaleDB
Lorsque vous activez timescaledb, SailOps utilise l'image officielle
timescaledb-ha. La version majeure de PostgreSQL choisie détermine la version
de TimescaleDB embarquée :
| PostgreSQL | TimescaleDB | Statut |
|---|---|---|
| 13, 14 | — | Non supporté |
| 15 | 2.27.1 | Supporté (ancienne ligne de version) |
| 16 | 2.27.1 | Entièrement supporté |
| 17 | 2.27.1 | Entièrement supporté |
Combinaisons incompatibles
L'API renvoie une erreur 400 — sans modifier le cluster — pour ces
requêtes :
| Requête | Raison du rejet |
|---|---|
| Toute extension PostGIS sur PG 13 ou 14 | L'image PostGIS n'est approuvée que pour PG 15, 16 et 17 |
timescaledb sur PG 13 ou 14 | TimescaleDB ne supporte plus ces versions majeures |
pg_cron ou pgrouting sur PG 13 ou 14 | Seule l'image TimescaleDB les fournit, et elle exige PG 15+ |
postgis_sfcgal combinée avec timescaledb | L'image TimescaleDB approuvée embarque PostGIS sans le backend SFCGAL |
ogr_fdw (toute version) | Aucune image SailOps ne fournit cette extension actuellement |
Changement d'image sur une base existante
Ajouter ou retirer une extension qui modifie l'image requise (par exemple
activer timescaledb sur une base qui tournait sur l'image Standard) déclenche
un redémarrage progressif du cluster pour migrer vers la nouvelle image.
Planifiez ce type de changement pendant une fenêtre de maintenance. Retirer
l'extension et revenir à l'image Standard fonctionne de la même manière.
Besoin de ogr_fdw ou d'une autre extension non supportée ?
Si vous avez besoin d'une extension qui n'est pas encore disponible, contactez [email protected] en précisant le nom de l'extension et votre cas d'usage — voir Demander de Nouvelles Extensions.
Installer des Extensions
Avec CREATE EXTENSION
-- Activer la génération UUID
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
-- Activer la recherche par trigrammes
CREATE EXTENSION IF NOT EXISTS pg_trgm;
-- Activer la cryptographie
CREATE EXTENSION IF NOT EXISTS pgcrypto;
Voir les Extensions Installées
SELECT * FROM pg_extension;
Supprimer des Extensions
DROP EXTENSION IF EXISTS extension_name;
Guide des Extensions Populaires
uuid-ossp - Génération UUID
Générer des identifiants uniques :
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
-- Générer un UUID aléatoire
SELECT uuid_generate_v4();
-- Résultat : 6ba7b810-9dad-11d1-80b4-00c04fd430c8
-- Utiliser dans les tables
CREATE TABLE users (
id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
email VARCHAR(255) NOT NULL
);
pgcrypto - Chiffrement
Hachage sécurisé des mots de passe et chiffrement :
CREATE EXTENSION IF NOT EXISTS pgcrypto;
-- Hacher un mot de passe
SELECT crypt('mypassword', gen_salt('bf'));
-- Résultat : $2a$06$...
-- Vérifier un mot de passe
SELECT crypt('mypassword', stored_hash) = stored_hash;
-- Chiffrer des données
SELECT encrypt('secret data', 'encryption_key', 'aes');
-- Déchiffrer des données
SELECT decrypt(encrypted_data, 'encryption_key', 'aes');
pg_trgm - Recherche Floue
Recherches rapides par similarité :
CREATE EXTENSION IF NOT EXISTS pg_trgm;
-- Créer un index trigramme
CREATE INDEX idx_users_name_trgm ON users USING gin (name gin_trgm_ops);
-- Rechercher des noms similaires
SELECT * FROM users
WHERE name % 'Jhon' -- Correspond à "John"
ORDER BY similarity(name, 'Jhon') DESC;
-- Seuil de similarité
SELECT set_limit(0.3); -- Définir le seuil (0-1)
pg_stat_statements - Analyse des Requêtes
Surveiller les performances des requêtes :
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
-- Voir les requêtes les plus longues par temps total
SELECT
query,
calls,
total_exec_time / 1000 as total_seconds,
mean_exec_time as avg_ms,
rows
FROM pg_stat_statements
ORDER BY total_exec_time DESC
LIMIT 10;
-- Réinitialiser les statistiques
SELECT pg_stat_statements_reset();
PostGIS - Données Géographiques
Stocker et interroger des données géographiques :
CREATE EXTENSION IF NOT EXISTS postgis;
-- Créer une table avec localisation
CREATE TABLE places (
id SERIAL PRIMARY KEY,
name VARCHAR(255),
location GEOGRAPHY(POINT, 4326)
);
-- Insérer un point
INSERT INTO places (name, location)
VALUES ('Paris', ST_GeographyFromText('POINT(2.3522 48.8566)'));
-- Trouver les lieux dans un rayon de 10km
SELECT name
FROM places
WHERE ST_DWithin(
location,
ST_GeographyFromText('POINT(2.2945 48.8584)'),
10000 -- 10km en mètres
);
-- Calculer la distance
SELECT
a.name,
b.name,
ST_Distance(a.location, b.location) / 1000 as km
FROM places a, places b
WHERE a.id != b.id;
citext - Texte Insensible à la Casse
Simplifier les comparaisons insensibles à la casse :
CREATE EXTENSION IF NOT EXISTS citext;
CREATE TABLE users (
id SERIAL PRIMARY KEY,
email CITEXT UNIQUE NOT NULL
);
-- Ces valeurs sont traitées comme égales
INSERT INTO users (email) VALUES ('[email protected]');
INSERT INTO users (email) VALUES ('[email protected]'); -- Erreur : doublon
-- Requêtes insensibles à la casse
SELECT * FROM users WHERE email = '[email protected]'; -- Fonctionne !
hstore - Stockage Clé-Valeur
Colonnes clé-valeur flexibles :
CREATE EXTENSION IF NOT EXISTS hstore;
CREATE TABLE products (
id SERIAL PRIMARY KEY,
name VARCHAR(255),
attributes HSTORE
);
-- Insérer avec des attributs
INSERT INTO products (name, attributes)
VALUES ('Laptop', 'brand => Dell, ram => 16GB, screen => 15.6');
-- Requête par attribut
SELECT * FROM products
WHERE attributes -> 'brand' = 'Dell';
-- Accéder à un attribut spécifique
SELECT name, attributes -> 'ram' as ram
FROM products;
-- Vérifier si une clé existe
SELECT * FROM products
WHERE attributes ? 'ssd';
ltree - Structures Arborescentes
Données hiérarchiques :
CREATE EXTENSION IF NOT EXISTS ltree;
CREATE TABLE categories (
id SERIAL PRIMARY KEY,
path LTREE,
name VARCHAR(255)
);
-- Insérer des données hiérarchiques
INSERT INTO categories (path, name) VALUES
('root', 'Toutes les Catégories'),
('root.electronics', 'Électronique'),
('root.electronics.computers', 'Ordinateurs'),
('root.electronics.phones', 'Téléphones');
-- Trouver tous les descendants
SELECT * FROM categories
WHERE path <@ 'root.electronics';
-- Trouver les ancêtres
SELECT * FROM categories
WHERE path @> 'root.electronics.computers';
Gestion des Extensions
Vérifier les Extensions Disponibles
SELECT * FROM pg_available_extensions
ORDER BY name;
Versions des Extensions
SELECT name, default_version, installed_version
FROM pg_available_extensions
WHERE installed_version IS NOT NULL;
Mettre à Jour les Extensions
ALTER EXTENSION extension_name UPDATE;
Bonnes Pratiques
1. Activez Uniquement ce dont Vous Avez Besoin
Chaque extension a un coût. N'activez que les extensions nécessaires.
2. Testez d'Abord en Développement
Installez et testez les extensions en développement avant la production.
3. Surveillez les Performances
Certaines extensions impactent les performances. Surveillez après activation.
4. Vérifiez la Compatibilité
Vérifiez la compatibilité des extensions avec votre version PostgreSQL.
Demander de Nouvelles Extensions
Besoin d'une extension non listée ?
- Contactez [email protected]
- Fournissez le nom de l'extension et le cas d'usage
- Nous évaluerons et répondrons sous 48 heures
Dépannage
Extension Non Trouvée
ERROR: extension "xyz" is not available
L'extension peut ne pas être supportée. Contactez le support.
Permission Refusée
ERROR: permission denied to create extension
Seul le superuser (postgres) peut créer des extensions.
Incompatibilité de Version
ERROR: extension "xyz" has no installation script for version "x.y"
La version de l'extension peut ne pas être compatible avec votre version PostgreSQL.