From 56d09773841f2aca415aaa82891aead3907b7cb8 Mon Sep 17 00:00:00 2001 From: Christoph Wurst Date: Thu, 13 Mar 2025 08:11:11 +0100 Subject: [PATCH] feat(devmanual): Clarify behavior of missing replacement indexes Signed-off-by: Christoph Wurst --- developer_manual/basics/storage/migrations.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/developer_manual/basics/storage/migrations.rst b/developer_manual/basics/storage/migrations.rst index 8dce3deac..21f10f9eb 100644 --- a/developer_manual/basics/storage/migrations.rst +++ b/developer_manual/basics/storage/migrations.rst @@ -198,6 +198,8 @@ Replacing indices Similar to adding an index to an existing table, it could be necessary to replace one or more indices with a new one. To avoid a gap between dropping the old indices in a migration and adding the new one through ``AddMissingIndicesEvent``, it is possible to do both at once in ``AddMissingIndicesEvent``. +If none of the previous indices are found, e.g. because they were optional and not created yet, the replacement index will be treated as *missing index*. + .. note:: Make sure to not use the same index name for the new index as for old indices. .. code-block:: php