Extension管理

Prev Next

VPC環境で利用できます。

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

Extensionのインストール

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

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、 i_menu > 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
  2. ポップアップ内容を確認し、[インストール] ボタンをクリックします。

Extension設定

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

注意

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

Extension削除

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

  1. NAVERクラウドプラットフォームコンソールの VPC環境で、 i_menu > 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名 説明 再起動必要 インストール範囲 公式ホームページ
pgvector vectorに対する typeと演算を提供 O Database https://github.com/pgvector/pgvector
pg_stat_statements 実行された SQL statementsの統計を提供 X Database https://www.postgresql.org/docs/current/pgstatstatements.html
passwordcheck CREATE ROLEもしくは ALTER ROLEを実行する際に Userの passwordを検査し、脆弱な場合はエラーを返す O すべてのサービス https://www.postgresql.org/docs/current/passwordcheck.html
postgres_fdw PostgreSQLで他の PostgreSQLサーバのテーブルを外部テーブルのように照会・操作できるようにする Foreign Data Wrapper(FDW) X Database https://www.postgresql.org/docs/current/postgres-fdw.html
PostGIS 地理空間データの保存、インデックス作成およびクエリ提供 O Database https://postgis.net
参考
  • 「再起動必要」と表記された Extensionは、サービスレベルでの最初のインストールまたは最後の削除時に自動的に再起動されます。
  • PostGISは、Rocky Linuxと PostgreSQL 14バージョン以上でのみサポートします。

ユーザーが直接インストールできる 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};