Hologres:拡張機能

制限事項

• 拡張機能は、データベースごとに 1 つのスキーマにのみロードできます。たとえば、データベースのデフォルトスキーマに拡張機能をロードした場合、そのデータベースの他のスキーマに同じ拡張機能をロードすることはできません。

• 拡張機能は、グローバルな pg_catalog システムスキーマにロードできます。これにより、拡張機能の特徴はデフォルトでデータベース内のすべてのスキーマで利用可能になります。スキーマを指定しない場合、拡張機能は public スキーマにロードされます。

• Superuser 権限を持つアカウントのみが拡張機能をロードまたはアンインストールできます。

• 現在、組み込みシステム拡張機能のみがサポートされています。カスタム拡張機能や外部拡張機能をロードすることはできません。

拡張機能

拡張機能のロード

拡張機能は pg_catalog システムスキーマに直接ロードできます。これにより、拡張機能はデフォルトですべてのスキーマで利用可能になります。以下のセクションでは、構文と例を示します。

• 例

  拡張機能をロードするための SQL コマンドは次のとおりです。

  -- このコマンドには Superuser 権限が必要です。
  CREATE extension IF NOT EXISTS <extension_name> SCHEMA <schema_name>;

  パラメーター	説明
  extension_name	ロードする拡張機能の名前。Hologres でサポートされている拡張機能のリストについては、このトピックの表をご参照ください。
  schema_name	拡張機能をロードするスキーマの名前。スキーマを指定しない場合、拡張機能はデフォルトで public スキーマにロードされます。データベースレベルで利用可能にするには、拡張機能を pg_catalog にロードします。

• 例

  次の例は、postgis 拡張機能を pg_catalog スキーマにロードする方法を示しています。

  CREATE extension if not exists postgis schema pg_catalog;

現在のデータベースでロードされている拡張機能の表示

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;

拡張機能のアンインストール

-- このコマンドには Superuser 権限が必要です。
DROP extension <extension_name>;

例: スキーマをまたいだ拡張機能のクエリ

一部の拡張機能は、pg_catalog ではなく、特定のスキーマにのみロードできます。たとえば、roaringbitmap 拡張機能は public スキーマにのみロードできます。public 以外のスキーマにテーブルが存在する場合、Roaring Bitmap (RB) 関数を使用するクエリは、function xxx does not exist というエラーで失敗します。これを防ぐには、関数を呼び出すときに、関数名にデフォルトのスキーマ名をプレフィックスとして付けます。次の例は、roaringbitmap 拡張機能の使用方法を示しています。

1. データの準備。

   public 以外のスキーマにテーブルを作成し、データをインポートします。

   CREATE EXTENSION roaringbitmap;
   
   CREATE SCHEMA test;
   
   -- 指定されたスキーマにテーブルを作成します。
   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 スキーマで 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. 指定されたスキーマに切り替えて、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;
   ERROR:  function rb_or(public.roaringbitmap, public.roaringbitmap) does not exist

4. 解決策: public スキーマで関数を実行するために、RB 関数に public スキーマをプレフィックスとして付けます。

   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;

よくある質問

拡張機能が誤ったスキーマにロードされました。スキーマを切り替えた後、その関数や構文にアクセスできず、function xxx does not exist エラーが報告されます。

• 原因: これは通常、拡張機能が public スキーマにロードされたために発生します。別のスキーマに切り替えると、拡張機能にアクセスできなくなります。

• 解決策: 拡張機能をアンインストールし、pg_catalog スキーマに再ロードします。これにより、拡張機能はすべてのスキーマからアクセス可能になります。次の例は、その方法を示しています。

  重要

  拡張機能をアンインストールする際は、DROP EXTENSION <extension_name> CASCADE; 構文を使用しないでください。このコマンドは、拡張機能に依存するすべてのオブジェクトを削除するため、ご利用のサービスに影響を与える可能性があります。

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