データベース拡張機能を構成する

このページでは、AlloyDB で PostgreSQL 拡張機能を有効または無効にする方法について説明します。

AlloyDB でサポートされている拡張機能の一覧については、サポートされているデータベース拡張機能をご覧ください。

始める前に

  • 使用している Google Cloud プロジェクトで、AlloyDB へのアクセスが有効になっている必要があります。
  • 使用している Google Cloud プロジェクトに、次のいずれかの IAM ロールが必要です。
    • roles/alloydb.admin（AlloyDB 管理者の事前定義 IAM ロール）
    • roles/owner（オーナーの基本 IAM ロール）
    • roles/editor（編集者の基本 IAM ロール）

    これらのロールを付与されていない場合は、組織管理者に連絡してアクセス権をリクエストしてください。

拡張機能を有効にする

一般に、拡張機能を有効にするには、AlloyDB クラスタのプライマリ インスタンスのデータベースに接続し、LOAD または CREATE EXTENSION コマンドを入力します。

ただし、拡張機能によっては、LOAD コマンドまたは CREATE EXTENSION コマンドを使用して拡張機能を有効にする前に、1 つ以上のデータベース フラグを設定する必要があります。これらのフラグは、拡張機能を使用する AlloyDB インスタンス（プライマリ インスタンスまたは読み取りプール インスタンス）に設定します。

手順

  1. 必要に応じて、拡張機能を使用するインスタンス（プライマリ インスタンスまたは読み取りプール インスタンス）に 適切なデータベース フラグを設定します。

    サポートされている拡張機能のリストには、この手順が必要な拡張機能と、設定する必要があるデータベース フラグが示されています。

  2. psql クライアントをインスタンスに接続するの説明に従って、psql クライアントをクラスタのプライマリ インスタンスに接続します。

  3. psql コマンド プロンプトで、データベースに接続して拡張機能を作成します。
  4. \c DB_NAME
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
    5.
  5. 必要に応じて、前の手順を繰り返して他のデータベースに接続し、各データベースに拡張機能を作成します。

拡張機能を無効にする

拡張機能を無効にするには、有効にするために行った手順を逆にします。

  1. psql クライアントをインスタンスに接続するの説明に従って、psql クライアントをクラスタのプライマリ インスタンスに接続します。

  2. psql コマンド プロンプトで、拡張機能が有効になっているデータベースに接続し、拡張機能を削除します。
    \c DB_NAME
DROP EXTENSION EXTENSION_NAME;
  3. 前の手順を繰り返して、拡張機能が有効になっている他のすべてのデータベースに接続し、各データベースで拡張機能を削除します。

  4. 拡張機能で、データベース フラグが使用されたインスタンスに設定されていることが必要だった場合は、インスタンスのデータベース フラグを構成するの手順に沿って、データベース フラグが使用された各インスタンスからフラグを削除します。

    サポートされている拡張機能のリストには、データベース フラグの設定が必要な拡張機能と、必要なフラグが示されています。