Skip to content

ReadySet Core Releases

ReadySet releases a new version of ReadySet Core on a monthly basis. This page summarizes the changes in each version and links to binaries and docker images.

Warning

Beta versions of ReadySet are backward-incompatible. To upgrade between beta versions, you must therefore clear all data files. Rolling upgrades will be supported with future ReadySet major releases.

beta-2023-01-18

Downloads

Note

ReadySet binaries for Linux require the OpenSSL 1.1.x package. OpenSSL 3.x+ is not currently supported.

Binary (linux-x84_64) Sha256Sum
ReadySet Server d56e663e6fab9b83b12dbe03008623c7c4e3e19bb3ba14eb1c7d45d2b3c5b9d7
ReadySet Adapter 696308d6720b16515aa9ab7587766c858d12910c00f4760f756d9630b44011f8
Binary (darwin-arm64) Sha256Sum
ReadySet Server 0289a07e7dde2fcf94718680328b09300a0f92915be24dcbb00160692d0b40f1
ReadySet Adapter eb287021e25ce7e46386b8bb9629000f4328464796caed43d08cd7c33def83d0
  • ReadySet Server (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset-server:beta-2023-01-18
    

  • ReadySet Adapter (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset:beta-2023-01-18
    

Changes

  • The new custom SHOW READYSET TABLES SQL command returns a list of all tables ReadySet is aware of, along with their snapshotting status if they are being replicated by ReadySet, or "Not replicated" if ReadySet is not replicating them either because the table is unsupported or because the table was not specified as part of --replication-tables. 764f0ed
  • ReadySet now always successfully snapshots SQL views that select from other views. 85d89ed
  • When running the readyset binary, set the new -V/--version option to output build/release information. 0d54fc6
  • ReadySet now correctly handles MySQL clients setting the database in the initial connection handshake. Previously, this was ignored and the client would instead be connected to the default database specified in the --upstream-db-url option. 3ace2e6
  • Added caching support for the MySQL JSON_OVERLAPS() function. 56e2710
  • Added caching support for the MySQL JSON_QUOTE() function. 67a7051
  • Added caching support for the PostgreSQL JSONB_SET_LAX() function. d461cdb
  • Fixed a bug that could cause snapshotting and replication to stall after encountering certain types of errors while loading a view from the upstream database. 3107da9
  • Fixed a bug that caused replication to fail on Aurora Postgres version 13 databases. 9be6443
  • Fixed a bug that could cause a failure loop when replicating a table. adc8f25
  • Fixed an issue where ReadySet would not correctly write out the row description or correct tag for SELECTs that return no results. 02b3fb6

beta-2022-12-15

Downloads

Note

ReadySet binaries for Linux require the OpenSSL 1.1.x package. OpenSSL 3.x+ is not currently supported.

Binary (linux-x84_64) Sha256Sum
ReadySet Server 376a3c31923af51abf5a7ec181181eecaa1308de51efd7f336ebce54222abae0
ReadySet Adapter 7468de0b2611bfdd6df79198709c06d389f1df32223735e851c5070ca77fa82d
Binary (darwin-arm64) Sha256Sum
ReadySet Server a8a2eb79e7c22fe5c6ce140e29931f4a474b89ead8c5f201a7eb4d370ab98861
ReadySet Adapter 0e02417a0435232529cd1ec4b3a2bedb2164334e83c8f92ffb5d2d442e3ac12c
  • ReadySet Server (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset-server:beta-2022-12-15
    

  • ReadySet Adapter (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset:beta-2022-12-15
    

Changes

  • ReadySet now distributes a single readyset adapter binary and docker image for MySQL and Postgres instead of separate readyset-mysql and readyset-psql binaries. When running the readyset binary, set the new --database-type flag or DATABASE_TYPE environment variable to mysql or postgresql to specify which database ReadySet is integrating with. The DATABASE_TYPE environment variable replaces the ENGINE variable, which has been removed. Also, the readyset-adapter docker image has been renamed readyset. e8004b0, 8315587
  • Parallelized the snapshotting of Postgres tables, greatly reducing the time it takes snapshotting to finish. b1999a6
  • Added caching support for the Postgres "CHAR" special character type. 82f87a8
  • Added caching support for the Postgres JSONB_INSERT() function. b25d6c7
  • Added caching support for the Postgres JSONB_SET() function. 9c91a77
  • Added caching support for the Postgres JSONB_PRETTY() function. 055d2fc
  • Added caching support for the MySQL JSON_DEPTH() function. 9186017
  • Added caching support for the MySQL JSON_VALID() function. b72cfa1
  • Added caching support for the Postgres #- operator. a69f0d9
  • Added caching support for CASE WHEN expressions with more than one WHEN branch. e7973bf
  • Added caching support for subqueries directly in the FROM clause of the query. 8d0a633
  • For queries that access tables that ReadySet has not replicated, the SHOW PROXIED QUERIES command now returns no for readyset supported instead of pending. Also, such queries now log at warn-level instead of error-level. 92e258f, 75ba85e
  • Added replication support for "unchanged" Postgres TOAST fields. 9a05b63
  • Added replication support for the Postgres TRUNCATE statement. 405ac80
  • Renamed the NORIA_DEPLOYMENT environment variable to DEPLOYMENT to match the --deployment flag. 7ac9220
  • Renamed the Prometheus metrics endpoint from /prometheus to /metrics. d10d142
  • Fixed a bug with caching the Postgres CHAR data type. 9f151f6
  • Fixed a bug that could lead to missing cache data and/or crashes after inserting large amounts of table data with the Postgres COPY or \copy commands. daa5e1c
  • Fixed a panic that could be triggered when using Postgres as the upstream database. 58c3bd3
  • Fixed a bug where tables and views that failed to replicate from the upstream database would not participate in schema resolution, which could cause certain queries with non-schema-qualified table references to read from a table in the wrong schema rather than being proxied to the upstream database. c8e5c6b
  • Fixed a bug where a query that projects two columns with the same name but different tables would return values from the first of the two columns twice. 6054a1e

beta-2022-11-16

Downloads

Note

ReadySet binaries for Linux require the OpenSSL 1.1.x package. OpenSSL 3.x+ is not currently supported.

Binary (linux-x84_64) Sha256Sum
ReadySet Server 3347c7de63b7a487f493408191d1e9dfb1dd0f46d01653afb9bafe62f5008154
ReadySet Adapter for MySQL 921ae4d9ad41b77addbdc7a9eb3439b547711ca1acdc4bc9a9df690e40fa643d
ReadySet Adapter for Postgres 13472459c23efa590cbe1251d79ff9af4f309bf2d3ee7c0762d0a6e150cf22ff
Binary (darwin-arm64) Sha256Sum
ReadySet Server ed33bff2375a574f65628813e2eadcc7d4ea0914436dfdd87db936afa3054d18
ReadySet Adapter for MySQL cda080d4f231d89b2c95c99961b10ed119b696d13c453765dc394c95fe275a35
ReadySet Adapter for Postgres 7fc278eff4e08de62a9cee655a4b3d721f92653571b9de063e7dea90d6db6c2e
  • ReadySet Server (linux-x84_64)
    docker pull public.ecr.aws/readyset/readyset-server:beta-2022-11-16
    

Bug

ReadySet Adapter images may be broken on certain Mac platforms in this release!

  • ReadySet Adapter (linux-x84_64)
    docker pull public.ecr.aws/readyset/readyset-adapter:beta-2022-11-16
    

Changes

  • Added the ability to filter SHOW PROXIED QUERIES and SHOW CACHES by query_id, e.g, SHOW PROXIED QUERIES WHERE query_id = 'q_7b44f013d9995ffe';. b150cfc
  • Added caching support for several Postgres JSON operators: -, ||, ->, ->>, @>, <@, #>, and #>>. c20aa47, b59a0f5, 1804acc, d3c6085, d29d7e7, 3753cb7, ee0cfaf, fe8b332, 045321b, 60e0352, 42f944b, f9ece02
  • Added caching support for the MySQL || operator, which equivalent to OR. d1796d1, fa8bb66
  • Added caching support for the MySQL DATE_FORMAT() function. b5041a7
  • ReadySet now logs when replication slots are created and dropped. 9f85d98
  • Improved logging to ensure ERROR messages highlight situations that may require manual attention and INFO messages are not overly noisy with debugging details. fb4d42c
  • Fixed a bug that could cause Postgres replication to repeatedly fail on certain tables. 7207efa
  • Fixed a bug where arrays of Postgres enums would fail to replicate from the upstream database. 74e0e71, d964876

beta-2022-11-09

Downloads

Note

ReadySet binaries for Linux require the OpenSSL 1.1.x package. OpenSSL 3.x+ is not currently supported.

Binary (linux-x84_64) Sha256Sum
ReadySet Server d52631fb7b8b0a912aa205f005ffd32b8494f38fb43ea96ccee08b41c216002d
ReadySet Adapter for MySQL 966f4701beca80faf8d572fd261ff8431bbda374557680c2687e452c6cc228d6`
ReadySet Adapter for Postgres 6a1a5a47b3ee138c38d1d493fe5d442dabd001abb4858982dc2dfba3fbd6eaaf
Binary (darwin-arm64) Sha256Sum
ReadySet Server 76d7a65b9ef953af5ea337fa7ed731524c463d961835f7cb80444c6c9cc7a7d3
ReadySet Adapter for MySQL 0c00931f87900e5570cdb83421ceddba64e55abe5316e0f29bd59848849f7884
ReadySet Adapter for Postgres 81faacc0e463f5dbe3b1a0fa5d139ea86e203f36e39d91814cfc1fc391c52d10
  • ReadySet Server (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset-server:beta-2022-11-09
    

  • ReadySet Adapter (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset-adapter:beta-2022-11-09
    

Changes

  • Added replication and caching support for Postgres enumerated data types. d8e428d, e282ae9, 40d217f, ef95276, 5b401a5, 23e6a12, 312dfa0, 2fe679f, 2295188
  • Added caching support for the ?| and ?& JSON operators. f5ae4d, 6598431
  • Fixed a bug that would cause CREATE CACHE commands to fail for MySQL JOIN queries with join conditions in the WHERE clause instead of the ON clause. f9be6d6
  • Upgraded OpenSSL to address a recently identified vulnerability. 4525073
  • ReadySet now logs the names of table/views that fail to snapshot or replicate. 7ffaf07
  • ReadySet now logs queries that fail to parse. a25c401
  • Added node column types to Graphviz data flow visualizations. 30f023b
  • The ReadySet Adapter now fails to start and returns and error when its version does not match the ReadySet Server. e00c742

beta-2022-11-01

Downloads

Note

ReadySet binaries for Linux require the OpenSSL 1.1.x package. OpenSSL 3.x+ is not currently supported.

Binary (linux-x84_64) Sha256Sum
ReadySet Server ea2b82f1faedf5836f704b496277d44906ad85a259dae7631e4749a40f9ba6b6
ReadySet Adapter for MySQL 7aaeba77e70fa5c8f64b0d3ab1603365ae25b3f9bf4d9048a7b84cf63744b73a
ReadySet Adapter for Postgres 7f474cb5c7fc9f799fd84be735660e0abf7595ff108afaabe8c502737c2ffc76
Binary (darwin-arm64) Sha256Sum
ReadySet Server 8a204cd07b85fbbc375ee7e2c9b87ce44b6df3a2dab8e78454d2047f7c02cfd0
ReadySet Adapter for MySQL 44ba62376b0a34fd099cd9c7b83fbb2714a868615d2792e63104b5a6862759b4
ReadySet Adapter for Postgres cc220b6d1dfba79e9a0ad9946205000a072fd29fdcd09d6f510842fde827066f
  • ReadySet Server (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset-server:beta-2022-11-01
    

  • ReadySet Adapter (linux-x84_64)

    docker pull public.ecr.aws/readyset/readyset-adapter:beta-2022-11-01
    

Changes

Since first announcing ReadySet Core in July 2022, ReadySet has made steady progress on increasing SQL support and improving deployment options, including the following highlights:

SQL support

Area Description
Data types ReadySet can now replicate tables with even more MySQL and Postgres data types, including DATE types, the MySQL ENUM type, and the Postgres ARRAY and CITEXT types.
Table namespaces ReadySet can now replicate tables in multiple schemas of a Postgres database.
Schema changes When ReadySet receives certain ALTER TABLE schema change commands via the replication stream, including ADD COLUMN and DROP COLUMN, ReadySet now updates its snapshot and clears all cached queries for the affected table.
Query caching ReadySet can now cache the results of SELECT queries containing the HAVING clause or subqueries in the FROM clause. In addition, all queries that ReadySet does not support are now proxied to the upstream database.

Deployment

Area Description
Helm chart ReadySet's new Helm chart lets you quickly deploy ReadySet Core into a Kubernetes cluster in front of an existing Amazon RDS database. If you don't want to run ReadySet yourself, consider signing up for a fully-managed deployment on ReadySet Cloud.
SSL verification When starting the ReadySet Server and Adapter, you can now tell ReadySet where to find the root certificate for SSL verification using the --ssl_root_cert command-line flag or SSL_ROOT_CERT environment variable.
Cache location When starting the ReadySet Server and Adapter, you can now choose to store cached query results on the Adapter rather than on the Server (the default behavior) by passing the --embedded-readers flag to the Adapter and the --no-readers flag to the Server.
Table replication scope If the queries you want to cache with ReadySet touch only specific tables, when starting the ReadySet Server, you can now restrict the scope of replication accordingly using the --replication_tables command-line flag or REPLICATION_TABLES environment variable.