Hologres:Extensions

Limites

• Une extension ne peut être chargée que dans un seul schéma par base de données. Par exemple, si vous chargez une extension dans le schéma par défaut, vous ne pourrez pas la charger dans un autre schéma de cette même base de données.

• Chargez une extension dans le schéma système pg_catalog pour la rendre disponible dans tous les schémas de la base de données. Si aucun schéma n'est spécifié, l'extension est chargée par défaut dans le schéma public.

• Seuls les comptes disposant des autorisations Superuser peuvent charger ou désinstaller des extensions.

• Actuellement, seules les extensions système intégrées sont prises en charge. Les extensions personnalisées ou externes ne peuvent pas être chargées.

Extensions prises en charge

Charger une extension

Le chargement d'une extension dans pg_catalog la rend disponible dans tous les schémas de la base de données. Si vous chargez une extension dans un autre schéma, ses fonctions ne sont accessibles que via le search_path de ce schéma.

-- Requires Superuser permissions
CREATE EXTENSION IF NOT EXISTS <extension_name> SCHEMA <schema_name>;

Exemple : Chargez l'extension postgis dans pg_catalog :

CREATE EXTENSION IF NOT EXISTS postgis SCHEMA pg_catalog;

Consulter les extensions chargées dans la base de données actuelle

Exécutez la requête suivante pour répertorier toutes les extensions chargées dans la base de données actuelle, y compris celles chargées par défaut :

SELECT
    e.extname AS "Name",
    e.extversion AS "Version",
    n.nspname AS "Schema",
    c.description AS "Description"
FROM
    pg_catalog.pg_extension e
    LEFT JOIN pg_catalog.pg_namespace n ON n.oid = e.extnamespace
    LEFT JOIN pg_catalog.pg_description c ON c.objoid = e.oid
        AND c.classoid = 'pg_catalog.pg_extension'::pg_catalog.regclass
    ORDER BY 1;

Désinstaller une extension

-- Requires Superuser permissions
DROP EXTENSION <extension_name>;

Exemple : Interroger une extension entre plusieurs schémas

Certaines extensions, telles que roaringbitmap, ne peuvent être chargées que dans le schéma public. Si votre table se trouve dans un schéma différent, l'appel d'une fonction RB sans préfixe de schéma échoue avec l'erreur function xxx does not exist. Pour résoudre ce problème, ajoutez le préfixe public. à la fonction.

L'exemple suivant illustre le problème et sa solution.

1. Créez une table dans un schéma autre que public et remplissez-la avec des données.

   CREATE EXTENSION roaringbitmap;
   
   CREATE SCHEMA test;
   
   -- Create a table in the test schema
   CREATE TABLE test.t1 (
       id integer,
       bitmap roaringbitmap
   );
   
   -- Insert a bitmap from an array
   INSERT INTO test.t1
   SELECT 1, RB_BUILD(ARRAY[1, 2, 3, 4, 5, 6, 7, 8, 9, 200]);
   
   -- Insert a bitmap aggregated from a series
   INSERT INTO test.t1
   SELECT 2, RB_BUILD_AGG(e)
   FROM GENERATE_SERIES(1, 100) e;

2. Interrogez à l'aide d'une fonction RB alors que search_path est défini sur public. La requête aboutit.

   SELECT RB_OR(a.bitmap, b.bitmap)
   FROM (SELECT bitmap FROM test.t1 WHERE id = 1) AS a,
        (SELECT bitmap FROM test.t1 WHERE id = 2) AS b;

3. Basculez search_path vers le schéma test et exécutez la même requête. La requête échoue.

   SET search_path TO test;
   
   SELECT RB_OR(a.bitmap, b.bitmap)
   FROM (SELECT bitmap FROM test.t1 WHERE id = 1) AS a,
        (SELECT bitmap FROM test.t1 WHERE id = 2) AS b;
   -- ERROR: function rb_or(public.roaringbitmap, public.roaringbitmap) does not exist

4. Ajoutez le préfixe public. à la fonction pour l'appeler depuis le schéma correct.

   SELECT public.RB_OR(a.bitmap, b.bitmap)
   FROM (SELECT bitmap FROM test.t1 WHERE id = 1) AS a,
        (SELECT bitmap FROM test.t1 WHERE id = 2) AS b;

FAQ

Une extension a été chargée dans le mauvais schéma. Après avoir changé de schéma, ses fonctions sont inaccessibles et renvoient l'erreur function xxx does not exist.

Ce problème survient lorsqu'une extension est chargée dans le schéma public mais que le search_path actif n'inclut plus public. Désinstallez l'extension sans utiliser CASCADE, puis rechargez-la dans pg_catalog pour la rendre accessible depuis tous les schémas :

DROP EXTENSION hologres_fdw;

CREATE EXTENSION IF NOT EXISTS hologres_fdw SCHEMA pg_catalog;