Extension
    • PDF

    Extension

    • PDF

    Article Summary

    VPC環境で利用できます。

    作成した PostgreSQLの Extensionを管理できます。Extensionを変更すると、Extensionの種類に応じてサービス全体に適用されるか、選択した Databaseに適用されます。一部の Extensionの場合、Extensionを変更すると、DB Serverが自動的に再起動されます。

    Extensionのインストール

    Extensionをインストールする方法は、次のとおりです。

    1. NAVERクラウドプラットフォームコンソールで、 Services > Database > Cloud DB for PostgreSQL メニューを順にクリックします。
    2. DB Server メニューをクリックします。
    3. 管理する PostgreSQL Serverをクリックし、 [DB管理] ボタンをクリックします。
    4. [DB Serverの詳細を見る] ボタンをクリックします。
    5. DB Serviceの詳細を見る画面が表示されたら、 Extension管理 タブメニューをクリックします。
      clouddbforpostgresql-extension-1-1
    6. Extension Name ドロップダウンリストからインストールする Extensionを選択します。
    7. Database Name ドロップダウンリストからインストールする Databaseを選択します。
    • 「passwordcheck」のようにすべての Databaseに適用される Extensionを選択した場合、 Database Name ドロップダウンリストが無効になります。
    • インストールされた Databaseに cdb_adminスキーマが別途作成され、選択した Extensionがインストールされます。
    1. [インストール] ボタンをクリックします。
    • DB Serverの再起動が必要な場合、DB Server再起動のポップアップが表示されます。
      clouddbforpostgresql-extension-1-2
    • DB Serverの再起動が必要ない場合、Extensionのインストールのポップアップが表示されます。
      clouddbforpostgresql-extension-1-3
    1. ポップアップ内容を確認し、 [インストール] ボタンをクリックします。

    Extension設定

    Extensionの設定の変更方法は、従来の DB config設定の変更方法と同じです。詳細は、DB Config管理をご参照ください。

    注意

    設定した Config値が適切でない場合、Extensionが正常に動作しない場合があります。Config変数の動作を十分に理解した上で Extensionを設定してください。

    Extension削除

    Extensionを削除する方法は、次のとおりです。

    1. NAVERクラウドプラットフォームコンソールで、 Services > Database > Cloud DB for PostgreSQL メニューを順にクリックします。

    2. DB Server メニューをクリックします。

    3. 管理する PostgreSQL Serverをクリックし、 [DB管理] ボタンをクリックします。

    4. [DB Serverの詳細を見る] ボタンをクリックします。

    5. DB Serviceの詳細を見る画面が表示されたら、 Extension管理 タブメニューをクリックします。

    6. Extension管理ページで削除する Extension右側の [削除] ボタンをクリックします。

      • DB Serverの再起動が必要ない場合、Extension削除のポップアップが表示されます。
        clouddbforpostgresql-extension-1-4
      • DB Serverの再起動が必要な場合、Extension削除および DB Server再起動のポップアップが表示されます。
        clouddbforpostgresql-extension-1-5
    7. ポップアップの内容を確認して「確認しました」にチェックを入れ、 [削除] ボタンをクリックします。

    Extensionを使用する

    Extensionを使用する方法は、次のとおりです。

    Extensionを使用する:コンソールでインストールされた Extension

    • superuser権限が必要な extensionの場合、コンソールでのみインストールできます。
    • この extensionは別のスキーマである"cdb_admin"を提供し、そのスキーマの下にインストールされます。
    • インストール後、session levelで"cdb admin"スキーマを search pathに追加するか、明示的に cdb admin.{extension object}の形で使用します。

    search_pathを利用する例は、次のとおりです。

    show search_path;
    set search_path = "$user", public, cdb_admin;
    create table cdb_test (val vector(3));
    select userid from pg_stat_statements limit 1;
    

    明示的に使用する例は、次のとおりです。

    create table cdb_test (val cdb_admin.vector(3));
    select userid from cdb_admin.pg_stat_statements limit 1;
    

    サポート Extensionリスト

    NAVERクラウドプラットフォームの Cloud DB for PostgreSQLサービスでサポートする Extensionのリストは、次のとおりです。

    NAVERクラウドプラットフォームコンソールでインストールできる Extensionは、次のとおりです。

    Extension名説明再起動必要インストール範囲公式ホームページ
    pgvectorvectorに対する typeと演算を提供ODatabasehttps://github.com/pgvector/pgvector
    pg_stat_statements実行された SQL statementsの統計を提供XDatabasehttps://www.postgresql.org/docs/ja/current/pgstatstatements.html
    passwordcheckCREATE ROLEもしくは ALTER ROLEを実行する際に Userの passwordを検査し、脆弱な場合はエラーを返すOすべてのサービスhttps://www.postgresql.org/docs/ja/current/passwordcheck.html
    参考

    「再起動必要」と表記された Extensionは、サービスレベルでの最初のインストールまたは最後の削除時に自動的に再起動されます。

    ユーザーが直接インストールできる Extensionのリストは、次のとおりです。ユーザーが直接インストールできる Extensionは superuser権限が必要ないので、Extensionを直接作成できます。

    • btree_gin
    • btree_gist
    • citext
    • cube
    • dict_int
    • fuzzystrmatch
    • hstore
    • intarray
    • isn
    • lo
    • ltree
    • pg_trgm
    • pgcrypto
    • seg
    • tablefunc
    • tcn
    • tsm system rows
    • tsm system time
    • unaccent
    • uuid-ossp

    ユーザーが直接 Extensionを作成する方法は、次のとおりです。

    psql -h {ip} -p {port} -d {db name} -U {user name}
    create extension "uuid-ossp" with {schema name};
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.