Running Triggers on the Replica for Row-based Events
The terms master and slave have historically been used in replication, but the terms terms primary and replica are now preferred. The old terms are used still used in parts of the documentation, and in MariaDB commands, although MariaDB 10.5 has begun the process of renaming. The documentation process is ongoing. See MDEV-18777 to follow progress on this effort.
MariaDB can force the replica thread to run triggers for row-based binlog events.
The setting is controlled by the slave_run_triggers_for_rbr global variable. It can be also specified as a command-line option or in my.cnf.
Possible values are:
|NO (Default)||Don't invoke triggers for row-based events|
|YES||Invoke triggers for row-based events, don't log their effect into the binary log|
|LOGGING||Invoke triggers for row-based events, and log their effect into the binary log|
|ENFORCE||From MariaDB 10.5.2 only. Triggers will always be run on the replica, even if there are triggers on the master. ENFORCE implies LOGGING.|
Note that if you just want to use triggers together with replication, you most likely don't need this option. Read below for details.
When to Use slave_run_triggers_for_rbr
Normally, MariaDB's replication system can replicate trigger actions automatically.
- When one uses statement-based replication, the binary log contains SQL statements. Replica server(s) execute the SQL statements. Triggers are run on the master and on each replica, independently.
- When one uses row-based replication, the binary log contains row changes. It will have both the changes made by the statement itself, and the changes made by the triggers that were invoked by the statement. Replica server(s) do not need to run triggers for row changes they are applying.
One may want to have a setup where a replica has triggers that are not present on the master (Suppose the replica needs to update summary tables or perform some other ETL-like process).
If one uses statement-based replication, they can just create the required triggers on the replica. The replica will run the statements from the binary log, which will cause the triggers to be invoked.
However, there are cases where you have to use row-based replication. It could be because the master runs non-deterministic statements, or the master could be a node in a Galera cluster. In that case, you would want row-based events to invoke triggers on the replica. This is what the
slave_run_triggers_for_rbr option is for. Setting the option to
YES will cause the SQL replica thread to invoke triggers for row-based events; setting it to
LOGGING will also cause the changes made by the triggers to be written into the binary log.
The following triggers are invoked:
- Update_row_event runs an UPDATE trigger
- Delete_row_event runs a DELETE trigger
- Write_row_event runs an INSERT trigger. Additionally it runs a DELETE trigger if there was a conflicting row that had to be deleted.
Preventing Multiple Trigger Invocations
There is a basic protection against triggers being invoked both on the master and replica. If the master modifies a table that has triggers, it will produce row-based binlog events with the "triggers were invoked for this event" flag. The replica will not invoke any triggers for flagged events.
- Task in Jira, MDEV-5095.