How to integrate DB with my charm

Please check the supported interfaces of the current charm first. You have options to use modern (preferred) or legacy interfaces. Make sure you are familiar with Juju integration concepts.

The most existing charms currently use ops-lib-pgsql interface (legacy). Canonical recommends for new charms to use data-platform-libs instead. You can take a look at postgresql-test-app and juju-sdk-tutorial-k8s for more practical examples (the branch 04_integrate_with_psql describes integration with Charmed PostgreSQL (read the great manual first). The legacy charm details are well described here.

Success stories:

• How to migrate Nextcloud to new Postgresql (vm-charms).

FAQ:

• Q: Does the requirer need to set anything in relation data?
  A: it depends on the interface. Check the postgresql_client interface requirements.
• Q: Is there a charm library available, or does my charm need to compile the postgresql relation data on its own?
  A: Yes, the library is available: data-platform-libs. The integration is trivial: example.
• Q: How do I obtain the database url/uri?
  A: it is planned, but currently missing. Meanwhile use this example, or follow:
  

Troubleshooting:

• Please start with Juju troubleshooting guide.
• Check Charmed PostgreSQL K8s troubleshooting hints.

Contact us if you have any questions, issues and/or ideas!