Charmed PostgreSQL
- By Canonical Data Platform
- Databases
Channel | Revision | Published | Runs on |
---|---|---|---|
latest/stable | 316 | 11 Aug 2023 | |
14/stable | 288 | 18 Apr 2023 | |
14/candidate | 326 | 19 Sep 2023 | |
14/beta | 330 | 27 Sep 2023 | |
14/edge | 330 | 26 Sep 2023 |
juju deploy postgresql --channel 14/stable
You will need Juju 2.9 to be able to run this command. Learn how to upgrade to Juju 2.9.
Deploy universal operators easily with Juju, the Universal Operator Lifecycle Manager.
Platform:
How to enable plugins/extensions
Warning: The feature is currently available in the channel 14/edge
only (revision 304+) and will be released to the channel 14/stable
soon.
Enable plugins/extensions requires that you:
Enable the plugin/extension by setting True
as the value of its respective config option, like in the following example:
juju config postgresql plugin_<plugin name>_enable=True
Then you can relate your application charm with the PostgreSQL application and it should work as expected.
If your application charm requests extensions through db
or db-admin
relation data, but the extension is not enabled yet, you’ll see that the PostgreSQL application goes to a blocked state with the following message:
postgresql/0* blocked idle 10.1.123.30 extensions requested through relation
Also, in the Juju debug logs we can see the list of extensions that need to be enabled:
unit-postgresql-0: 18:04:51 ERROR unit.postgresql/0.juju-log db:5: ERROR - `extensions` (pg_trgm, unaccent) cannot be requested through relations - Please enable extensions through `juju config` and add the relation again.
After enabling the needed extensions through the config options the charm will unblock. If you have removed the relation, you can add it back again.
If the application charm uses the new postgresql_client
interface, it can use the is_postgresql_plugin_enabled helper method from the data interfaces library to check whether the plugin/extension is already enabled in the database.
Not all PostgreSQL extensions are available. The list of supported extensions is available at Supported plugins/extensions.
Help us improve this documentation
Most of this documentation can be collaboratively discussed and changed on the respective topic in the doc category of the Charmhub forum. See the documentation guidelines if you’d like to contribute.