tarantool / tarantool / 11256382700

87%

Build Type

push

github

Committed by locker

Commit Message

schema: broadcast persistent schema version in box.status

in order to simplify the upgrade process. However, some DDL will
remain forbidden until box.schema.upgrade is called, e.g. creating
persistent triggers when upgrading to 3.0.0.

In order to make writing upgrade triggers easier this commit adds
new field to the box.status system event: dd_version. This should
not be confused with schema.version value, as the latter shows, whether
the database schema (e.g. creating space) was updated.
box.status.dd_version on the other side is the value of the
persistent schema from box.space._schema['version'].

Without box.status.dd_version user has to set on_replace trigger for
box.space._schema, which will check version and rw state, after which
trigger will send it further. The problem with this approach is the fact,
that it requires synchronization of two changing states: dd schema
version and rw state, which is difficult to achieve.

With box.status.dd_version user has to just set watcher, which
checks !status.is_ro and status.dd_version >= needed one.

Closes #10546

@TarantoolBot document
Title: New field in box.status system event, dd_version
Since: Tarantool 3.3.0
Root: https://www.tarantool.io/en/doc/latest/reference/reference_lua/box_events/system_events/#system-events

dd_version: string, shows the version of schema database from
box.space.schema['version']. Not to be confused with box.schema.version.

Run Details

69151 of 122879 branches covered (56.28%)

4 of 4 new or added lines in 2 files covered. (100.0%)

18 existing lines in 12 files now uncovered.

101958 of 116768 relevant lines covered (87.32%)

2593663.23 hits per line