Hologres:Extensions

Sınırlamalar

• Bir uzantı, veritabanı başına yalnızca tek bir ad alanına yüklenebilir. Örneğin, bir uzantıyı varsayılan ad alanına yüklemek, aynı veritabanındaki başka bir ad alanına yüklemenizi engeller.

• Uzantının veritabanındaki tüm ad alanlarında kullanılabilir olması için pg_catalog sistem ad alanına yükleyin. Herhangi bir ad alanı belirtilmezse uzantı varsayılan olarak public ad alanına yüklenir.

• Yalnızca Superuser izinlerine sahip hesaplar uzantı yükleyebilir veya kaldırabilir.

• Şu anda yalnızca yerleşik sistem uzantıları desteklenmektedir. Özel veya harici uzantılar yüklenemez.

Desteklenen uzantılar

Uzantı yükleme

Bir uzantıyı pg_catalog ad alanına yüklemek, bunun veritabanındaki tüm ad alanlarında kullanılabilir olmasını sağlar. Uzantıyı başka bir ad alanına yüklerseniz işlevlerine yalnızca o ad alanının search_path değeri dahilinde erişilebilir.

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

Örnek: postgis uzantısını pg_catalog ad alanına yükleyin:

CREATE EXTENSION IF NOT EXISTS postgis SCHEMA pg_catalog;

Geçerli veritabanındaki yüklenen uzantıları görüntüleme

Varsayılan olarak yüklenenler de dahil olmak üzere geçerli veritabanında yüklenen tüm uzantıları listelemek için aşağıdaki sorguyu çalıştırın:

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;

Uzantı kaldırma

-- Requires Superuser permissions
DROP EXTENSION <extension_name>;

Örnek: Ad alanları arasında bir uzantıyı sorgulama

roaringbitmap gibi bazı uzantılar yalnızca public ad alanına yüklenebilir. Tablonuz farklı bir ad alanında bulunuyorsa RB işlevini ad alanı ön eki olmadan çağırmak function xxx does not exist hatasıyla başarısız olur. Bu sorunu çözmek için işlevin önüne public. ekini getirin.

Aşağıdaki örnek sorunu ve çözümü göstermektedir.

1. public dışı bir ad alanında tablo oluşturun ve verilerle doldurun.

   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. search_path değeri public olarak ayarlanmışken RB işlevini kullanarak sorgulama yapın. Sorgu başarılı olur.

   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. search_path değerini test ad alanına değiştirin ve aynı sorguyu çalıştırın. Sorgu başarısız olur.

   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. İşlevi doğru ad alanından çağırmak için önüne public. ekini getirin.

   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;

SSS

Bir uzantı yanlış ad alanına yüklendi. Ad alanlarını değiştirdikten sonra işlevlerine erişilemiyor ve function xxx does not exist hatası döndürülüyor.

Bu durum, bir uzantı public ad alanına yüklendiğinde ancak etkin search_path artık public değerini içermediğinde meydana gelir. Uzantıyı CASCADE olmadan kaldırın ve ardından tüm ad alanlarından erişilebilir hale getirmek için pg_catalog ad alanına yeniden yükleyin:

DROP EXTENSION hologres_fdw;

CREATE EXTENSION IF NOT EXISTS hologres_fdw SCHEMA pg_catalog;