Hologres:Extensões

Limitações

• É possível carregar cada extensão em apenas um schema por banco de dados. Por exemplo, se você carregar uma extensão no schema padrão, não poderá carregá-la em nenhum outro schema do mesmo banco.

• Carregue a extensão no schema de sistema pg_catalog para disponibilizá-la em todos os schemas do banco de dados. Se nenhum schema for especificado, a extensão será carregada no schema public por padrão.

• Somente contas com permissões de Superuser podem carregar ou desinstalar extensões.

• Atualmente, o Hologres suporta apenas extensões de sistema integradas. Não é possível carregar extensões personalizadas ou externas.

Extensões suportadas

Carregar uma extensão

Carregar uma extensão em pg_catalog torna-a disponível em todos os schemas do banco de dados. Se você carregar uma extensão em qualquer outro schema, as funções dela só estarão acessíveis dentro do search_path desse schema específico.

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

Exemplo: Carregue a extensão postgis em pg_catalog:

CREATE EXTENSION IF NOT EXISTS postgis SCHEMA pg_catalog;

Visualize extensões carregadas no banco de dados atual

Execute a consulta a seguir para listar todas as extensões carregadas no banco de dados atual, incluindo aquelas carregadas por padrão:

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 uma extensão

-- Requires Superuser permissions
DROP EXTENSION <extension_name>;

Exemplo: Consultar uma extensão entre schemas

Algumas extensões, como roaringbitmap, só podem ser carregadas no schema public. Se sua tabela estiver em um schema diferente, chamar uma função RB sem o prefixo do schema resultará no erro function xxx does not exist. Para resolver isso, adicione o prefixo public. à função.

O exemplo a seguir demonstra o problema e a solução.

1. Crie uma tabela em um schema diferente de public e insira dados.

   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. Execute uma consulta usando uma função RB enquanto o search_path estiver definido como public. A consulta será bem-sucedida.

   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. Altere o search_path para o schema test e execute a mesma consulta. A consulta falhará.

   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. Adicione o prefixo public. à função para chamá-la a partir do schema correto.

   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;

Perguntas frequentes

Uma extensão foi carregada no schema errado. Após trocar de schema, suas funções ficaram inacessíveis e retornam function xxx does not exist.

Isso ocorre quando uma extensão é carregada no schema public, mas o search_path ativo não inclui mais o public. Desinstale a extensão sem usar CASCADE e recarregue-a em pg_catalog para torná-la acessível em todos os schemas:

DROP EXTENSION hologres_fdw;

CREATE EXTENSION IF NOT EXISTS hologres_fdw SCHEMA pg_catalog;