Aller au contenu principal

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​

La disponibilité dépend de l'image runtime

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​

ExtensionDescription
pgcryptoFonctions cryptographiques
uuid-osspGénération UUID
pg_stat_statementsStatistiques des requêtes
plpgsqlLangage procédural PL/pgSQL

Recherche & Texte​

ExtensionDescription
pg_trgmCorrespondance par trigrammes pour recherche floue
fuzzystrmatchCorrespondance de chaînes floue
unaccentSupprimer les accents des chaînes

Types de Données​

ExtensionDescription
hstoreStockage clé-valeur
ltreeStructures arborescentes hiérarchiques
citextTexte insensible à la casse
cubeCubes multidimensionnels

Géographique​

ExtensionDescription
postgisObjets et requêtes géographiques
postgis_topologyDonnées topologiques
postgis_tiger_geocoderGéocodage US

JSON & Tableaux​

ExtensionDescription
jsonb_plpython3uJSON dans PL/Python

Monitoring​

ExtensionDescription
pg_stat_statementsPerformance des requêtes
pg_stat_kcacheStats système
pgrowlocksVerrouillage 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​

ImageContenuUtilisée quand
StandardPostgreSQL + extensions contrib, pgaudit, pgvectorPar défaut — toute combinaison d'extensions core/contrib
PostGISTout le contenu de Standard plus la famille PostGISVous demandez une extension PostGIS (PG 15–17 uniquement)
TimescaleDBTimescaleDB plus PostGIS (sans le backend SFCGAL), pgvector, pg_cron, pgrouting, contribVous 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.

ExtensionImagePG 13PG 14PG 15PG 16PG 17Notes
Toutes les extensions core & contrib (plpgsql, pgcrypto, uuid-ossp, hstore, ltree, pg_trgm, pg_stat_statements, …)Standard✅✅✅✅✅Toujours disponibles
pgvectorStandard✅✅✅✅✅Incluse dans l'image Standard
pgauditStandard✅✅✅✅✅Incluse dans l'image Standard
postgis, postgis_topology, postgis_raster, postgis_tiger_geocoder, address_standardizer, address_standardizer_data_usPostGIS❌❌✅✅✅Bascule la base sur l'image PostGIS, approuvée uniquement pour PG 15–17
postgis_sfcgalPostGIS❌❌✅✅✅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
timescaledbTimescaleDB❌❌✅✅✅Support de PG 13/14 abandonné dans les versions récentes
pg_cronTimescaleDB❌❌✅✅✅Fournie uniquement dans l'image TimescaleDB, qui exige PG 15+
pgroutingTimescaleDB❌❌✅✅✅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 :

PostgreSQLTimescaleDBStatut
13, 14—Non supporté
152.27.1Supporté (ancienne ligne de version)
162.27.1Entièrement supporté
172.27.1Entièrement supporté

Combinaisons incompatibles​

L'API renvoie une erreur 400 — sans modifier le cluster — pour ces requêtes :

RequêteRaison du rejet
Toute extension PostGIS sur PG 13 ou 14L'image PostGIS n'est approuvée que pour PG 15, 16 et 17
timescaledb sur PG 13 ou 14TimescaleDB ne supporte plus ces versions majeures
pg_cron ou pgrouting sur PG 13 ou 14Seule l'image TimescaleDB les fournit, et elle exige PG 15+
postgis_sfcgal combinée avec timescaledbL'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 ?

  1. Contactez [email protected]
  2. Fournissez le nom de l'extension et le cas d'usage
  3. 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.

Sujets Connexes​