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.

482-e STS (18 Aug 2026)#

  • Removed support for Alluxio-backed exchange storage for fault-tolerant execution. If you configured Alluxio as the exchange storage provider for fault-tolerant execution, you must migrate to a supported alternative before upgrading.

  • Removed support for the Alluxio file system in the Delta Lake, Hive, Hudi, and Iceberg connectors. This does not affect support for the Alluxio file system cache. If you use the Alluxio file system with any of these connectors, you must migrate to a supported file system before upgrading.

  • Removed the snowflake_jdbc connector. The snowflake_parallel connector is now the only implementation of the Snowflake connector. To avoid disruption, migrate to the snowflake_parallel connector before upgrading.

  • Removed support for creating external Hive tables with the Unity catalog with Hive.

  • The hive.max-initial-splits and hive.max-initial-split-size configuration properties have been removed from the Hive connector. Remove these from your connector configuration before upgrading.

  • The implicit coercion between char and varchar has been reversed. A char value now coerces to varchar with trailing spaces removed, and comparisons between char and varchar now follow varchar semantics with no blank padding, making trailing spaces significant. Review any queries or applications that rely on the previous behavior before upgrading.

  • The lower_bounds and upper_bounds columns of the Iceberg $files metadata table have changed from map(integer, varchar) to typed row values. Update any queries that read these columns before upgrading.

  • The target_max_file_size and parquet_writer_row_group_size Iceberg session properties have been removed, including the deprecated parquet_writer_block_size alias. Remove any references to these session properties before upgrading.

  • Filtering varchar columns in the Synapse connector could return incorrect results where stored values differ only in trailing spaces. Inequality and range predicates are no longer pushed down. A DELETE or UPDATE that relied on pushing down these predicates now fails. Review affected queries before upgrading.

  • The DB2 connector no longer pushes down inequality and range predicates on VARCHAR columns to prevent incorrect results caused by trailing space differences. Equality and IN predicates on VARCHAR columns are now re-evaluated by the engine after retrieval. Review any queries that filter VARCHAR columns in the DB2 connector for potential performance impact before upgrading.

  • File system caching is no longer configured at the catalog level. It is now configured once per node via cache-manager.config-files in config.properties. Move all fs.cache.* settings from catalog properties to the node-level. See File system cache for more information.

  • The DynamicFilter parameter of ConnectorSplitManager.getSplits was removed from the Service Provider Interface (SPI). Replace it with the set of dynamic filter columns, and pass the current predicate to ConnectorSplitSource.getNextBatch as a DynamicFilterSnapshot.

  • The predicate API was removed from the public SPI class io.trino.spi.connector.Constraint. Migrate to the ConnectorExpressionEvaluator interface for evaluating expressions during partition and split pruning.

  • Removed deprecated methods without the ConnectorTableCredentials parameter from ConnectorPageSourceProvider and ConnectorPageSinkProvider in SPI.

  • Removed a deprecated method from TableFunctionProcessorProvider in SPI.

481-e STS (15 Jun 2026)#

  • Legacy Hadoop-based object storage support has been removed from the Delta Lake, Hive, and Iceberg connectors. Any catalog using fs.hadoop.enabled=true for cloud object storage or the legacy hive.s3.*, hive.azure.*, or hive.gcs.* configuration properties fail to start after upgrading. fs.hadoop.enabled now only activates HDFS support. You must migrate to native file system support before upgrading:

    • S3: set fs.native-s3.enabled=true and rename hive.s3.* properties

    • Azure: set fs.native-azure.enabled=true and rename hive.azure.* properties

    • GCS: set fs.native-gcs.enabled=true and rename hive.gcs.* properties

    See the migration guides for full property mapping tables.

  • The internal-communication.shared-secret and node.environment configuration properties are no longer supported in connector configuration files when managed statistics is enabled. Configurations containing these properties fail to initialize on startup, regardless of whether managed statistics is enabled. Remove these properties from your configurations before upgrading.

  • Geospatial functions now reject WKT input containing invalid geometry that was previously accepted and silently corrected. Queries passing non-conforming WKT strings now fail with a parse error. Validate and correct any WKT inputs in your queries before upgrading.

  • ST_Union() now returns an empty geometry collection instead of NULL when called with no input rows. Update any queries that check for a NULL result from ST_Union() on empty inputs.

  • ST_Union() no longer inserts additional vertices at intersection points when unioning a point with a line. Queries that depended on those extra intersection vertices in the output geometry produce different results after upgrading.

  • Removed the ai.agent.persona-directory-path configuration property and support for defining custom personas in JSON files. Remove the property from your coordinator configuration file or the cluster fails to start. You can now create and manage custom personas in the UI.

  • The Trino S3 file system implementation (io.trino.hdfs.s3.TrinoS3FileSystem) was removed in Trino 481. If you use Ranger Audit with SEP, you must update your file system to one supported directly by Hadoop. Reference Hadoop documentation for more information. For one example, if you are using Ranger Audit to S3, update the following properties in your Ranger Audit configuration:

Ranger Audit to S3 properties#

Former property

Former value

New property

New value

xasecure.audit.destination.hdfs.config.fs.s3.impl

io.trino.hdfs.s3.TrinoS3FileSystem

xasecure.audit.destination.hdfs.config.fs.s3a.impl

org.apache.hadoop.fs.s3a.S3AFileSystem

xasecure.audit.destination.hdfs.config.fs.AbstractFileSystem.s3.impl

io.trino.hdfs.s3.TrinoS3FileSystem

xasecure.audit.destination.hdfs.config.fs.AbstractFileSystem.s3a.impl

org.apache.hadoop.fs.s3a.S3AFileSystem

xasecure.audit.destination.hdfs.config.trino.s3.endpoint

Unchanged

xasecure.audit.destination.hdfs.config.fs.s3a.endpoint

Unchanged

xasecure.audit.destination.hdfs.config.trino.s3.access-key

Unchanged

xasecure.audit.destination.hdfs.config.fs.s3a.access.key

Unchanged

xasecure.audit.destination.hdfs.config.trino.s3.secret-key

Unchanged

xasecure.audit.destination.hdfs.config.fs.s3a.secret.key

Unchanged

xasecure.audit.destination.hdfs.config.trino.s3.path-style-access

Unchanged

xasecure.audit.destination.hdfs.config.fs.s3a.path.style.access

Unchanged

Additionally, xasecure.audit.destination.hdfs.dir must have the s3a:/// scheme instead of s3:///.

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.