This is an automated email from the ASF dual-hosted git repository.
yufei pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/polaris.git
The following commit(s) were added to refs/heads/main by this push:
new 740993963 Doc: Add breaking changes section for 1.1 release (#2654)
740993963 is described below
commit 740993963cb41c2c1b4638be5e04dd00f1263c98
Author: Prashant Singh <[email protected]>
AuthorDate: Wed Sep 24 11:55:35 2025 -0700
Doc: Add breaking changes section for 1.1 release (#2654)
---
CHANGELOG.md | 13 +++++++++++++
site/content/downloads/_index.md | 16 ++++++++++++++++
2 files changed, 29 insertions(+)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b409ff135..c58bdab1c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -95,6 +95,19 @@ 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 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,
+ 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 11531c511..b351f8ca0 100644
--- a/site/content/downloads/_index.md
+++ b/site/content/downloads/_index.md
@@ -54,6 +54,22 @@ 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 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,
+ 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 |
