From 6b9159f145fac1ac17771d4be7d6a4f3bb3c390c Mon Sep 17 00:00:00 2001 From: "Rizzo Cascio, Fabio" Date: Mon, 29 Sep 2025 09:40:53 +0100 Subject: [PATCH 1/2] added Aurora postgres to metastore documentation --- site/content/in-dev/unreleased/metastores.md | 32 ++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/site/content/in-dev/unreleased/metastores.md b/site/content/in-dev/unreleased/metastores.md index ef5a5ae94b..ea9218e94e 100644 --- a/site/content/in-dev/unreleased/metastores.md +++ b/site/content/in-dev/unreleased/metastores.md @@ -29,7 +29,11 @@ deprecated EclipseLink persistence backends. This implementation leverages Quarkus for datasource management and supports configuration through environment variables or JVM -D flags at startup. For more information, refer to the [Quarkus configuration reference](https://quarkus.io/guides/config-reference#env-file). +We have 2 options for configuring the persistence backend: +### 1. Relational JDBC metastore with username and password + +using environment variables: ``` POLARIS_PERSISTENCE_TYPE=relational-jdbc @@ -37,6 +41,33 @@ QUARKUS_DATASOURCE_USERNAME= QUARKUS_DATASOURCE_PASSWORD= QUARKUS_DATASOURCE_JDBC_URL= ``` +using properties file: + +``` +polaris.persistence.type=relational-jdbc +quarkus.datasource.jdbc.username= +quarkus.datasource.jdbc.password= +quarkus.datasource.jdbc.jdbc-url= +``` + +### 2. AWS Aurora PostgreSQL metastore using IAM AWS authentication + +``` +polaris.persistence.type=relational-jdbc +quarkus.datasource.jdbc.url=jdbc:postgresql://polaris-cluster.cluster-xyz.us-east-1.rds.amazonaws.com:6160/polaris +quarkus.datasource.jdbc.additional-jdbc-properties.wrapperPlugins=iam +quarkus.datasource.username=dbusername +quarkus.datasource.db-kind=postgresql +quarkus.datasource.jdbc.additional-jdbc-properties.ssl=true +quarkus.datasource.jdbc.additional-jdbc-properties.sslmode=require +quarkus.datasource.credentials-provider=aws + +quarkus.rds.credentials-provider.aws.use-quarkus-client=true +quarkus.rds.credentials-provider.aws.username=dbusername +quarkus.rds.credentials-provider.aws.hostname=polaris-cluster.cluster-xyz.us-east-1.rds.amazonaws.com +quarkus.rds.credentials-provider.aws.port=6160 +``` +This is the basic configuration. For more details, please refer to the [Quarkus plugin documentation](https://docs.quarkiverse.io/quarkus-amazon-services/dev/amazon-rds.html#_configuration_reference) The Relational JDBC metastore currently relies on a Quarkus-managed datasource and supports only PostgresSQL and H2 databases. This limitation is similar to that of EclipseLink, primarily due to underlying schema differences. At this time, official documentation is provided exclusively for usage with PostgreSQL. Please refer to the documentation here: @@ -44,6 +75,7 @@ Please refer to the documentation here: Additionally, the retries can be configured via `polaris.persistence.relational.jdbc.*` properties please ref [configuration]({{% ref "configuration" %}}) +``` ## EclipseLink (Deprecated) {{< alert important >}} EclipseLink persistence will be completely removed from Polaris in 1.3.0 or in 2.0.0 (whichever happens earlier). From a27570fe3152c715255db6d72c0888db1fd36950 Mon Sep 17 00:00:00 2001 From: "Rizzo Cascio, Fabio" Date: Mon, 29 Sep 2025 09:55:06 +0100 Subject: [PATCH 2/2] added Aurora postgres to metastore documentation --- site/content/in-dev/unreleased/metastores.md | 1 - 1 file changed, 1 deletion(-) diff --git a/site/content/in-dev/unreleased/metastores.md b/site/content/in-dev/unreleased/metastores.md index ea9218e94e..c22bbdd907 100644 --- a/site/content/in-dev/unreleased/metastores.md +++ b/site/content/in-dev/unreleased/metastores.md @@ -75,7 +75,6 @@ Please refer to the documentation here: Additionally, the retries can be configured via `polaris.persistence.relational.jdbc.*` properties please ref [configuration]({{% ref "configuration" %}}) -``` ## EclipseLink (Deprecated) {{< alert important >}} EclipseLink persistence will be completely removed from Polaris in 1.3.0 or in 2.0.0 (whichever happens earlier).