This topic describes how to manage extensions for PolarDB using the PolarDB for PostgreSQL console. Supported operations include filtering, installing, uninstalling, upgrading, and checking for updates.
Prerequisites
The cluster must have at least one privileged account and one database.
Notes
-
If an extension requires preloading via the
shared_preload_librariesparameter and is not already listed in theshared_preload_librariesparameter value, installing it automatically restarts the cluster.NoteYou can view the
shared_preload_librariesparameter configuration in Parameter Settings to confirm whether the extension you plan to install depends on preloading viashared_preload_librariesand whether it is already included in theshared_preload_librariesparameter value. -
Do not install the Ganos and PostGIS extensions in the same schema.
-
To install the ganos_tiger_geocoder or postgis_tiger_geocoder extensions, your cluster version must be PostgreSQL 14 (minor engine version 14.9.14.0 or later).
-
Uninstalling an extension may cause data loss or service disruption. Proceed with caution.
Procedure
-
Log on to the PolarDB console and select the region of your cluster from the top navigation bar.
-
Click the ID of your destination cluster to go to its Overview page.
-
In the navigation pane on the left, choose Configuration and Management > Plugin Management.
-
On the Extension Management page, you can filter, install, uninstall, upgrade, and check for updates for extensions.
Filter extensions
-
On the Extension Management page, use the drop-down list in the upper-right corner to switch to your target database.
-
In the upper-right corner, select one or more extension types from the Select an extension type drop-down list.
Select your target database (such as
testdb) from the database drop-down list in the upper-right corner to filter extensions available for that database.
You can also enter an extension name directly in the search box in the upper-left corner to find a specific extension.
Install extensions
Install a single extension
Install a single extension using one of the following methods.
-
Install from the Extension Overview page.
-
On the Extension Overview page, review popular extensions and their scenarios.
-
Click Install next to your target extension.
-
In the Install Extension dialog box, select the target Database Name and Database Account.
-
Click OK to install the extension into the target database.
-
-
Install from the Extension Management page.
-
On the Extension Management page, click the Uninstalled Extensions tab.
-
Click Install in the Operation column for your target extension.
-
In the Install Extension dialog box, select the target Database Account.
-
Click OK to install the extension into the target database.
-
Install multiple extensions at once
You can also install multiple extensions in a batch.
-
On the Extension Management page, click the Uninstalled Extensions tab.
-
Select the extensions you want to install and click Batch Install.
-
In the Install Extension dialog box, select the target Database Account.
-
Click OK to install the extensions into the target database.
Uninstall extensions
Uninstall a single extension
-
On the Extension Management page, click the Installed Extensions tab.
-
Click Uninstall in the Actions column for your target extension.
-
In the Uninstall Extension dialog box, click OK.
Uninstall multiple extensions at once
-
On the Extension Management page, click the Installed Extensions tab.
-
Select the extensions you want to uninstall and click Batch Uninstall.
-
In the Uninstall Extension dialog box, click OK.
Uninstalling an extension may cause data loss or service disruption. Proceed with caution.
Upgrade extensions
-
On the Extension Management page, click the Installed Extensions tab.
-
Click Update in the Operation column for your target extension to upgrade it to the latest version.
If the Upgrade button in the Actions column is grayed out, the extension is already at the latest version.
Check for updates
-
On the Extension Management page, click the Installed Extensions tab.
-
Click Check for Updates to display a list of extensions that require upgrades.