From 822ad83effc0ec865360072554a843bebeee461a Mon Sep 17 00:00:00 2001 From: Prashant Date: Mon, 22 Sep 2025 17:33:09 -0700 Subject: [PATCH 1/3] Doc: Add breaking changes section for 1.1 release --- CHANGELOG.md | 11 +++++++++++ site/content/downloads/_index.md | 14 ++++++++++++++ 2 files changed, 25 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index b409ff135c..1d13d01c95 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -95,6 +95,17 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. - **Breaking changes** - Helm chart: the default value of the `authentication.tokenBroker.secret.symmetricKey.secretKey` property has changed from `symmetric.pem` to `symmetric.key`. + - For migrations from 1.0.x to 1.1.x, users using JDBC persistence must ensure that they, + run following SQL statement under `POLARIS_SCHEMA` to make sure version table exists: + `CREATE TABLE IF NOT EXISTS version ( + version_key TEXT PRIMARY KEY, + version_value INTEGER NOT NULL + ); + INSERT INTO version (version_key, version_value) + VALUES ('version', 1) + ON CONFLICT (version_key) DO UPDATE + SET version_value = EXCLUDED.version_value; + COMMENT ON TABLE version IS 'the version of the JDBC schema in use';` - **Deprecations** - The property `polaris.active-roles-provider.type` is deprecated for removal. - The `ActiveRolesProvider` interface is deprecated for removal. diff --git a/site/content/downloads/_index.md b/site/content/downloads/_index.md index 6e79cca29f..a45f912a9d 100644 --- a/site/content/downloads/_index.md +++ b/site/content/downloads/_index.md @@ -54,6 +54,20 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. - Fix drop view with default server configuration - Fix MinIO support - Remove ThreadLocal +- **Breaking changes** + - Helm chart: the default value of the `authentication.tokenBroker.secret.symmetricKey.secretKey` property has changed + from `symmetric.pem` to `symmetric.key`. + - For migrations from 1.0.x to 1.1.x, users using JDBC persistence must ensure that they, + run following SQL statement under `POLARIS_SCHEMA` to make sure version table exists: + `CREATE TABLE IF NOT EXISTS version ( + version_key TEXT PRIMARY KEY, + version_value INTEGER NOT NULL + ); + INSERT INTO version (version_key, version_value) + VALUES ('version', 1) + ON CONFLICT (version_key) DO UPDATE + SET version_value = EXCLUDED.version_value; + COMMENT ON TABLE version IS 'the version of the JDBC schema in use';` ## 1.0.1 | Artifact | PGP Sig | SHA-512 | From aae67836abdad062ca41f3ca5b406b9d4d7364f9 Mon Sep 17 00:00:00 2001 From: Prashant Date: Mon, 22 Sep 2025 17:52:33 -0700 Subject: [PATCH 2/3] Address review feedback --- CHANGELOG.md | 8 +++++--- site/content/downloads/_index.md | 8 +++++--- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1d13d01c95..c58bdab1c3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -95,9 +95,10 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. - **Breaking changes** - Helm chart: the default value of the `authentication.tokenBroker.secret.symmetricKey.secretKey` property has changed from `symmetric.pem` to `symmetric.key`. - - For migrations from 1.0.x to 1.1.x, users using JDBC persistence must ensure that they, + - For migrations from 1.0.x to 1.1.x, users using JDBC persistence and wanting to continue using v1 schema, must ensure that they, run following SQL statement under `POLARIS_SCHEMA` to make sure version table exists: - `CREATE TABLE IF NOT EXISTS version ( + ```sql + CREATE TABLE IF NOT EXISTS version ( version_key TEXT PRIMARY KEY, version_value INTEGER NOT NULL ); @@ -105,7 +106,8 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. VALUES ('version', 1) ON CONFLICT (version_key) DO UPDATE SET version_value = EXCLUDED.version_value; - COMMENT ON TABLE version IS 'the version of the JDBC schema in use';` + COMMENT ON TABLE version IS 'the version of the JDBC schema in use'; + ``` - **Deprecations** - The property `polaris.active-roles-provider.type` is deprecated for removal. - The `ActiveRolesProvider` interface is deprecated for removal. diff --git a/site/content/downloads/_index.md b/site/content/downloads/_index.md index a45f912a9d..05584b7d00 100644 --- a/site/content/downloads/_index.md +++ b/site/content/downloads/_index.md @@ -57,9 +57,10 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. - **Breaking changes** - Helm chart: the default value of the `authentication.tokenBroker.secret.symmetricKey.secretKey` property has changed from `symmetric.pem` to `symmetric.key`. - - For migrations from 1.0.x to 1.1.x, users using JDBC persistence must ensure that they, + - For migrations from 1.0.x to 1.1.x, users using JDBC persistence must ensure that they and wanting to continue using v1 schema, run following SQL statement under `POLARIS_SCHEMA` to make sure version table exists: - `CREATE TABLE IF NOT EXISTS version ( + ```sql + CREATE TABLE IF NOT EXISTS version ( version_key TEXT PRIMARY KEY, version_value INTEGER NOT NULL ); @@ -67,7 +68,8 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. VALUES ('version', 1) ON CONFLICT (version_key) DO UPDATE SET version_value = EXCLUDED.version_value; - COMMENT ON TABLE version IS 'the version of the JDBC schema in use';` + COMMENT ON TABLE version IS 'the version of the JDBC schema in use'; + ``` ## 1.0.1 | Artifact | PGP Sig | SHA-512 | From b4b69d1213990e2a253ed1ceded035338732865d Mon Sep 17 00:00:00 2001 From: Prashant Date: Mon, 22 Sep 2025 18:26:36 -0700 Subject: [PATCH 3/3] Address review feedback --- site/content/downloads/_index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/site/content/downloads/_index.md b/site/content/downloads/_index.md index 05584b7d00..5cbcbc410c 100644 --- a/site/content/downloads/_index.md +++ b/site/content/downloads/_index.md @@ -57,8 +57,8 @@ Apache Polaris 1.1.0-incubating was released on September 19th, 2025. - **Breaking changes** - Helm chart: the default value of the `authentication.tokenBroker.secret.symmetricKey.secretKey` property has changed from `symmetric.pem` to `symmetric.key`. - - For migrations from 1.0.x to 1.1.x, users using JDBC persistence must ensure that they and wanting to continue using v1 schema, - run following SQL statement under `POLARIS_SCHEMA` to make sure version table exists: + - For migrations from 1.0.x to 1.1.x, users using JDBC persistence and wanting to continue using v1 schema, must ensure + that they, run following SQL statement under `POLARIS_SCHEMA` to make sure version table exists: ```sql CREATE TABLE IF NOT EXISTS version ( version_key TEXT PRIMARY KEY,