As part of this issue I raised #3665 I discovered this functionality within sqlmesh isn't covered in the documentation.