Hologres:Extensions

Limitaciones

• Una extensión solo se puede cargar en un esquema por base de datos. Por ejemplo, si carga una extensión en el esquema predeterminado, no podrá cargarla en ningún otro esquema de esa misma base de datos.

• Cargue la extensión en el esquema del sistema pg_catalog para que esté disponible en todos los esquemas de la base de datos. Si no se especifica un esquema, la extensión se carga en el esquema public de forma predeterminada.

• Solo las cuentas con permisos de Superuser pueden cargar o desinstalar extensiones.

• Actualmente, solo se admiten extensiones del sistema integradas. No es posible cargar extensiones personalizadas ni externas.

Extensiones compatibles

Cargar una extensión

Al cargar una extensión en pg_catalog, esta estará disponible en todos los esquemas de la base de datos. Si carga una extensión en cualquier otro esquema, sus funciones solo serán accesibles dentro del search_path de dicho esquema.

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

Ejemplo: Cargar la extensión postgis en pg_catalog:

CREATE EXTENSION IF NOT EXISTS postgis SCHEMA pg_catalog;

Consultar las extensiones cargadas en la base de datos actual

Ejecute la siguiente consulta para listar todas las extensiones cargadas en la base de datos actual, incluidas las que se cargan de forma predeterminada:

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;

Desinstalar una extensión

-- Requires Superuser permissions
DROP EXTENSION <extension_name>;

Ejemplo: Consultar una extensión entre esquemas

Algunas extensiones, como roaringbitmap, solo se pueden cargar en el esquema public. Si su tabla se encuentra en un esquema diferente y llama a una función RB sin el prefijo del esquema, se producirá el error function xxx does not exist. Para resolverlo, anteponga public. al nombre de la función.

El siguiente ejemplo muestra el problema y su solución.

1. Cree una tabla en un esquema distinto de public e insértela datos.

   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. Realice una consulta con una función RB mientras search_path está configurado como public. La consulta se ejecuta correctamente.

   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. Cambie search_path al esquema test y ejecute la misma consulta. La consulta falla.

   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. Anteponga public. a la función para invocarla desde el esquema correcto.

   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;

Preguntas frecuentes

Se cargó una extensión en el esquema incorrecto. Tras cambiar de esquema, sus funciones no son accesibles y devuelven function xxx does not exist.

Esto ocurre cuando una extensión se carga en el esquema public, pero el search_path activo ya no incluye public. Desinstale la extensión sin usar CASCADE y vuelva a cargarla en pg_catalog para que sea accesible desde todos los esquemas:

DROP EXTENSION hologres_fdw;

CREATE EXTENSION IF NOT EXISTS hologres_fdw SCHEMA pg_catalog;