SEP STS breaking changes#

This page compiles the breaking changes introduced in Starburst Enterprise platform (SEP) STS release 471-e and higher. When upgrading between SEP releases, refer to this page to address all breaking changes listed between the two.

480-e STS (14 May 2026)#

  • Removed support for storing AI Agent sessions in coordinator memory. Sessions are now only stored in the Insights database. You must update your configuration file to remove the following properties or the cluster fails to start.

    • ai.agent.session-storage

    • ai.agent.max-sessions

    • ai.agent.session-inactivity-timeout

  • Removed support for Glue v1 SDK. glue now defaults to Glue v2 across all connectors. The following configuration properties used Glue v1 and are no longer applicable. You must update your configuration file to remove the old properties.

    • hive.metastore-cache.cache-partitions

    • hive.metastore-cache.cache-missing

    • hive.metastore-cache.cache-missing-partitions

    • hive.metastore-cache.cache-missing-stats

  • The snowflake_jdbc connector has reached end of support as of 480-e and will be removed in the August 2026 LTS release. You must migrate to the snowflake_parallel connector before upgrading beyond 480-e. Clusters with snowflake_jdbc still configured will fail to start.

  • The enable-large-dynamic-filters configuration property and the corresponding enable_large_dynamic_filters session property have been removed. Remove these from your configuration before upgrading.

  • The dynamic-filtering.small* and dynamic-filtering.large-broadcast* configuration properties have been removed. Remove any references from your configuration before upgrading.

  • The following configuration properties have been removed across the Delta Lake, Hive, Hudi, and Iceberg connectors. Update your connector configurations before upgrading:

    • hive.write-validation-threads: removed with no replacement.

    • hive.fs.new-file-inherit-ownership: removed with no replacement.

    • gc.use-access-token: removed with no replacement. Update your GCS authentication configuration accordingly.

    • parquet.optimized-writer.validation-percentage: use parquet.writer.validation-percentage instead.

    • hive.parquet.writer.block-size: use parquet.writer.block-size instead.

    • hive.parquet.writer.page-size: use parquet.writer.page-size instead.

  • The live files table metadata cache has been removed. The configuration properties metadata.live-files.cache-size, metadata.live-files.cache-ttl, and checkpoint-filtering.enabled are no longer recognized and must be removed from your Delta Lake connector configuration. Clusters fail to start if these properties are present.

  • The iceberg.extended-statistics.enabled configuration property and the extended_statistics_enabled session property have been removed. Extended statistics are now always enabled and no longer require explicit configuration.

  • The default Trino type mapping for the Iceberg variant data type has changed from JSON to variant in Iceberg format version 3 tables. To restore the previous mapping, use the iceberg.legacy-variant-type-mapping=JSON configuration property.

  • Support for reading MySQL BIT(n) columns where n > 1 has been removed. This behavior was previously incorrect. Queries that relied on reading multi-bit BIT columns from MySQL now fail. Review any affected queries or table schemas before upgrading. - Support for reading SingleStore BIT(n) columns where n > 1 has been removed. Review any affected queries or table schemas before upgrading.

  • Support for TypeSignatureParameter, ParameterKind, NamedType, NamedTypeSignature, and NamedTypeParameter has been removed from the SPI.

  • The Confluent Kafka version in SEP was upgraded to 5.5.0. To maintain connectivity, make the following changes to the Kafka JAAS configuration:

    • If your configuration uses the login module class name org.eclipse.jetty.jaas.spi.PropertyFileLoginModule, replace it with the login module class name org.eclipse.jetty.security.jaas.spi.PropertyFileLoginModule.

    • The serviceName property must now be explicitly configured. For example:

    user_admin="admin1"
serviceName="broker1.test.confluent.io";

  • The method of defining admin users for Starburst Portal changes as of this release. If you have a legacy YAML configuration file for Starburst Gateway, any of its authorization and presetUsers blocks are now silently ignored. Instead, you must configure starburst.access-control.authorized-users or starburst.access-control.authorized-groups or both. Portal now fails to start without at least one of these properties in its /etc/starburst/config.properties file. In addition, configure an internal communication shared secret for Portal with the internal-communication.shared-secret property. Note also the following changes:

    • /ui/api/userinfo response: roles is now a set with lowercase values (such as admin instead of ADMIN)

    • /ui/api/info response: the accessControlType field was removed

    • /public/api/v1/backend endpoints now require admin credentials (they previously required an API role)

478-e STS (8 Dec 2025)#

  • As of SEP 478-e, the default implementation of the ConnectorFactory#getSecuritySensitivePropertyName method is abstract. This method identifies configuration properties that may contain security-sensitive information so the engine can mask their values. Custom connectors must provide their own implementation. This change affects only customers who maintain custom plugins.

472-e STS (17 Apr 2025)#

  • The following HTTP client property prefixes have been renamed:

    • workerInfo to worker-info

    • memoryManager to memory-manager

    If you use these properties in your configuration files, the old names are no longer recognized. Update your configurations to use the new names to avoid unexpected behavior.

  • The following Hive metastore HTTP client properties have been removed:

    • hive.metastore.http.client.additional-headers

    • hive.metastore.http.client.authentication.type

    • hive.metastore.http.client.bearer-token

    • hive.metastore.http.client.read-timeout

    If your current configuration includes any of these properties, update your configuration to remove them. If left in place, you may experience connection and authentication issues when interacting with the Hive metastore.

  • The Db2 connector no longer supports setting fetchSize in the JDBC connection URL. You must remove fetchSize from your connection-url property and use the db2.fetch-size property instead.

471-e STS (1 Apr 2025)#

  • The minimum required Java runtime for the JDBC driver and CLI has been updated to Java 11. If you are using an earlier version, you must upgrade to Java 11 or later.

  • The optimize_hash_generation session property and the optimizer.optimize-hash-generation configuration option have been removed. You must remove these properties from your configuration or the cluster fails to start.

  • The following Unity catalog metastore configuration properties have been renamed in the Delta Lake connector:

    • delta.metastore.unity.host to hive.metastore.unity.host

    • delta.metastore.unity.catalog-name to hive.metastore.unity.catalog-name

    • delta.metastore.unity.access-token to hive.metastore.unity.token

    Update these properties in your catalog configuration file or the cluster fails to start.

  • The Kinesis connector has been removed. Update your dependencies and configurations to use an alternative connector.