Releases

We are continually improving Materialize with new features and bug fixes. We periodically release these improvements to your Materialize account. This page describes the changes in each release and the process by which they are deployed.

Release notes

Version Release date
v0.33 November 30, 2022      Not yet released.
v0.32 November 16, 2022
v0.31 November 9, 2022
v0.30 November 2, 2022
v0.29 October 26, 2022
v0.28 October 19, 2022
v0.27 October 12, 2022

For versions that predate cloud-native Materialize, see our historical release notes and documentation.

Schedule

We release a new version of Materialize approximately every week. Each version includes both new features and bug fixes.

On weeks with a scheduled release, we deploy the release to Materialize accounts during the scheduled maintenance window on Wednesday from 4-6pm ET.

We may occasionally deploy unscheduled releases to fix urgent bugs during unplanned maintenance windows. Due to the unexpected nature of these bugs, we cannot provide advance notice of these releases.

The deployment of a new release of Materialize causes an interruption in service. The length of the service interruption is proportional to the size of your sources, sinks, and indexes. We plan to support zero-downtime deployments in a future release of Materialize.

We announce both planned and unplanned maintenance windows on our status page.

You can also use our status page API to programmatically access the information on our status page.

Versioning

Each release is associated with an internal version number. You can determine what release your Materialize region is running by executing:

SELECT mz_version();

Scheduled weekly releases increase the middle component of the version number and reset the final component to zero (e.g., v0.26.2 -> v0.27.0). Unscheduled releases increase the final component of the version number (e.g., v0.27.0 -> v0.27.1).

Backwards compatibility

Materialize maintains backwards compatibility whenever possible. You can expect applications that work with the current version of Materialize to work with all future versions of Materialize with only minor changes to the application’s code.

Very occasionally, a bug fix may require breaking backwards compatibility. These changes are approved only after weighing the severity of the bug against the number of users that will be affected by the backwards-incompatible change. Backwards-incompatible changes are always clearly marked as such in the release notes.

There are several aspects of the product that are not considered part of Materialize’s stable interface:

  • Features that are in alpha (labeled as such in the documentation)
  • The EXPLAIN statement
  • Objects in the mz_internal schema
  • Any undocumented features or behavior

These unstable interfaces are not subject to the backwards-compatibility policy. If you choose to use these unstable interfaces, you should be aware of the risk of backwards-incompatible changes. Backwards-incompatible changes may be made to these unstable interfaces at any time and without mention in the release notes.

Back to top ↑