Documentation Home
MySQL Replication
Download this Excerpt
PDF (US Ltr) - 1.6Mb
PDF (A4) - 1.6Mb


MySQL Replication  /  ...  /  Replication of JSON Documents

4.1.17 Replication of JSON Documents

In MySQL 8.3, it is possible to log partial updates to JSON documents (see Partial Updates of JSON Values). The logging behavior depends on the format used, as described here:

Statement-based replication.  JSON partial updates are always logged as partial updates. This cannot be disabled when using statement-based logging.

Row-based replication.  JSON partial updates are not logged as such by default, but instead are logged as complete documents. To enable logging of partial updates, set binlog_row_value_options=PARTIAL_JSON. If a replication source has this variable set, partial updates received from that source are handled and applied by a replica regardless of the replica's own setting for the variable.

For this reason, when replicating to an old server (prior to MySQL 8.0) that does not recognize the log events used for JSON partial updates, binlog_row_value_options must be disabled on the source by setting this variable to '' (empty string). See the description of this variable for more information.