このトピックでは、ApsaraDB RDS コンソールで ApsaraDB RDS for PostgreSQL の拡張機能を管理する方法について説明します。これには、拡張機能のフィルタリング、インストール、アンインストール、アップグレード、および他のデータベースへの適用方法が含まれます。
前提条件
-
メジャーバージョンが PostgreSQL 10 以降であること。
-
インスタンスのマイナーバージョンが 20230330 以降であること。マイナーバージョンの確認方法とアップグレード方法については、「マイナーバージョンのアップグレード」をご参照ください。
-
インスタンスが ESSD または Premium ESSD を使用するプライマリインスタンスであること。
-
インスタンスに、少なくとも 1 つの特権アカウントと 1 つのデータベースがあること。特権アカウントとデータベースの作成方法については、「アカウントとデータベースの作成」をご参照ください。
使用上の注意
-
shared_preload_librariesパラメーターによるプリロードが必要で、まだパラメーターの値に含まれていない拡張機能をインストールすると、インスタンスは自動的に再起動します。説明パラメーターの設定 ページで
shared_preload_librariesパラメーターを確認し、拡張機能がプリロードを必要とするかどうか、また、その値にすでに含まれているかどうかを確認できます。 -
pg_cron拡張機能は、cron.database_nameパラメーターに依存します。このパラメーターへの変更は、インスタンスの再起動後にのみ有効になります。ターゲットデータベースにpg_cronをインストールすると、システムはcron.database_nameをそのデータベースに設定します。そのため、pg_cronがshared_preload_librariesパラメーターの値にすでに含まれている場合でも、インストールによってインスタンスが再起動します。pg_cronは、オフピーク時にインストールしてください。 -
GanosBase と PostGIS の拡張機能は、同じスキーマにはインストールできません。
-
以下の拡張機能をインストールするには、ターゲットデータベースのアカウントが特権アカウントである必要があります。そうでない場合、インストールは失敗します。
ganos_geometry_topology、ganos_tiger_geocoder、postgis_tiger_geocoder、postgis_topology。 -
拡張機能をアンインストールする際は、ご注意ください。この操作は、データ損失やサービス中断を引き起こす可能性があります。
手順
- RDSインスタンスにアクセスし、上部のリージョンを選択し、対象のRDSインスタンスのIDをクリックします。
-
左側のナビゲーションペインで、プラグイン をクリックします。
-
[拡張機能マーケットプレイス] タブでは、人気の拡張機能を表示してインストールしたりできます。
-
対象の拡張機能の [インストール] をクリックして、ターゲットデータベースにインストールします。
-
-
プラグインの管理 タブで、データベースを名前で選択し、その拡張機能を管理します。
-
拡張機能のフィルタリング
プラグインによるフィルタリング を使用して、機能別に拡張機能をフィルタリングします。複数の機能を選択できます。
-
拡張機能のインストール
プラグインがインストールされていません タブで、対象の拡張機能を探し、[操作] 列の [インストール] をクリックします。
複数の拡張機能を選択して、一括でインストールすることもできます。
-
拡張機能のアンインストール
プラグインがインストール済みです タブで、対象の拡張機能を探し、[操作] 列の [アンインストール] をクリックします。
複数の拡張機能を選択して、一括でアンインストールすることもできます。
重要拡張機能をアンインストールする際は、ご注意ください。この操作は、データ損失やサービス中断を引き起こす可能性があります。
-
拡張機能のアップグレード
プラグインがインストール済みです タブで、対象の拡張機能を探し、[操作] 列の [バージョンアップグレード] をクリックします。
説明拡張機能の [操作] 列に [バージョンアップグレード] ボタンが表示されない場合、その拡張機能は最新バージョンです。
-
他のデータベースへの拡張機能の適用
プラグインがインストール済みです タブで、他のデータベースに適用 をクリックして、現在のデータベースにあるすべての拡張機能を他のデータベースにインストールします。
-
-
API リファレンス
|
API |
説明 |
|
指定した 1 つ以上の拡張機能をターゲットデータベースにインストールします。 説明
この API オペレーションを呼び出した後に拡張機能が作成されない場合は、お使いのインスタンスのメジャーバージョンがその拡張機能をサポートしているかどうかを確認してください。詳細については、「ApsaraDB RDS for PostgreSQL でサポートされる拡張機能」をご参照ください。 |
|
|
インスタンスの指定したデータベース内にあるすべての拡張機能に関する情報を照会します。 |
|
|
ターゲットデータベース内の指定した 1 つ以上の拡張機能をアップグレードします。 |
|
|
ターゲットデータベースから指定した 1 つ以上の拡張機能を削除します。 |