Hologres：Extension擴充

使用限制

• 一個資料庫只能在一個Schema下載入一次Extension。例如在某資料庫的預設Schema下載入了Extension，則此資料庫下其他的Schema不能再載入Extension。

• 可以將extension載入在全域空間pg_catalog系統Schema下，預設該資料庫的所有Schema都能訪問該Extension的功能；如果不指定Schema，則會預設載入在public Schema下。

• 帳號具有Superuser許可權才能載入、卸載Extension。

• 目前僅支援載入系統內建Extension，不支援載入自訂及外部Extension。

Extension擴充

載入Extension

載入Extension時，建議將Extension直接載入到pg_catalog系統Schema下，預設所有Schema都能使用該Extension，載入文法及樣本如下：

• 文法樣本

  載入Extension的SQL命令如下。

  -- 需Superuser許可權執行
  CREATE extension IF NOT EXISTS <extension_name> SCHEMA <schema_name>;

  參數	說明
  extension_name	需要載入的extension名稱，Hologres支援的部分Extension參見本文上述列表。
  schema_name	載入Extension所在的schema名稱。如果不指定schema，則會預設在public下載入Extension，建議載入在pg_catalog下，資料庫層級可用。

• 使用樣本

  在pg_catalog下載入postgis擴充樣本如下。

  CREATE extension if not exists postgis schema pg_catalog;

查看當前資料庫已載入Extension

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;

卸載Extension

-- 需Superuser許可權執行
DROP extension <extension_name>;

跨Schema查詢Extension樣本

部分Extension只能被載入到指定的Schema下，不能被載入到pg_catalog，例如roaringbitmap extension只能被載入到public Schema下，當表存在於非public Schema時，使用RB函數查詢會報錯function xxx does not exist，因此在使用函數時需要加上函數的預設Schema名稱。roaringbitmap Extension的使用樣本如下。

1. 資料準備。

   建立非public Schema的表並匯入資料。

   CREATE EXTENSION roaringbitmap;
   
   CREATE SCHEMA test;
   
   --建立表在指定Schema下
   CREATE TABLE test.t1 (
       id integer,
       bitmap roaringbitmap
   );
   
   --數組位置對應的BIT值為1
   INSERT INTO test.t1
   SELECT
       1,
       RB_BUILD (ARRAY[1, 2, 3, 4, 5, 6, 7, 8, 9, 200]);
   
   --將輸入的多條記錄的值對應位置的BIT值設定為1，最後彙總為一個roaringbitmap
   INSERT INTO test.t1
   SELECT
       2,
       RB_BUILD_AGG (e)
   FROM
       GENERATE_SERIES(1, 100) e;
   

2. 在public Schema下使用RB函數查詢，成功執行。

   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. 切換到指定Schema使用RB函數查詢，報錯。

   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;
   RROR:  function rb_or(public.roaringbitmap, public.roaringbitmap) does not exist

4. 解決方案：在RB函數前加public Schema，將函數放入public Schema執行。

   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;

常見問題

Extension被載入到了錯誤的Schema下，導致切換Schema後無法訪問對應的函數或文法，報錯function xxx does not exist。

• 問題原因：通常是因為Extension被載入到了public Schema下，切換Schema後，無法訪問。

• 解決方案：卸載Extension，並將Extension重新載入到pg_catalog Schema下，這樣所有的Schema都能訪問。樣本如下：

  重要

  卸載Extension時，不建議使用DROP EXTENSION  <extension_name> CASCADE;的文法，否則會將該Extension依賴的相關對象全部刪除，容易對業務產生影響。

  drop extension hologres_fdw;
  
  create extension if not exists hologres_fdw schema pg_catalog;