Skip to content

Migration Version1Date20260915050000 fails on MariaDB: column name row_number is a reserved word #4909

Closed

Description

@WilcoLouwerse

📋 Plan: openregister-4909

Wat gebeurt er

occ app:update openregister (1.1.1 → 2.1.41-beta.20261020102916) stopt op MariaDB 11.3 in migratie Version1Date20260915050000:

Error: Database error when running migration 1Date20260915050000 for app openregister
An exception occurred while executing a query: SQLSTATE[42000]: Syntax error or access violation: 1064 You have an error in your SQL syntax; ... near 'row_number ...

Oorzaak

lib/Migration/Version1Date20260915050000.php maakt openregister_import_preview_rows met een kolom row_number (regel 109) en een unique index op (preview_id, row_number). ROW_NUMBER is een gereserveerd woord in MariaDB ≥ 10.7 (in de uitgebrachte versies; de nieuwste upstream-broncode van 10.11 en 11.4 reserveert het niet meer) en in MySQL ≥ 8.0.2. Doctrine quote een kolomnaam alleen als het woord in zijn eigen keyword-lijst voor dat platform staat: op MySQL staat het erin, op MariaDB niet, dus alleen op MariaDB is de CREATE TABLE ongeldig. Op PostgreSQL is het geen gereserveerd woord, daarom valt dit op PostgreSQL-installaties (Nextcloud-base-tenants, de WOO-590-test) niet op.

Gevolg: elke MariaDB-installatie die het woord reserveert en naar 2.1.x gaat (update of verse install) loopt hierop vast; de app blijft op de oude versie staan en installed_version wordt niet bijgewerkt.

Workaround die we hebben gebruikt (directory.opencatalogi.nl, 2026-10-26)

Beide tabellen vooraf aangemaakt in MariaDB met gequote kolomnaam en hetzelfde schema als de migratie; hasTable() laat de migratie ze dan overslaan. Zie het plan bij ConductionNL/opencatalogi#1993 (Stap 8b).

Voorstel

  1. Nieuwe migratie die de kolom hernoemt naar een niet-gereserveerde naam (bijvoorbeeld row_no) en de unique index opnieuw opbouwt, plus de mapper/entity aanpassen.
  2. De bestaande migratie laten staan maar de kolomnaam quoten ('row_number') zodat verse MariaDB-installs niet meer breken vóór de rename-migratie draait, of de tabel in de nieuwe migratie aanmaken als hij ontbreekt.
  3. Vóór het mergen: occ app:install en occ app:update vanaf 1.1.1 testen op een MariaDB-instance (nextcloud-docker-dev).

Gevonden tijdens ConductionNL/opencatalogi#1993 (bijwerken OpenCatalogi-omgevingen op con-prod).

🤖 Generated with Claude Code

Gecorrigeerd 2026-11-12: het onderzoek liet zien dat alleen MariaDB vastloopt, niet MySQL (daar zet Doctrine de naam tussen quotes).

Activity

  1. github-actions commented on Oct 26, 2026

    @github-actions
    Contributor

    Thank you for opening this issue! It has been assigned to @rubenvdlinde for review.

    What happens next:

    1. A maintainer will review this issue and determine the appropriate action
    2. If accepted, it may be converted into an OpenSpec change for structured development
    3. You will be notified of any status changes

    Triage labels:

    • triage:accept-feature — accepted as a new feature
    • triage:accept-bugfix — accepted as a bug fix
    • triage:needs-info — more information needed
    • triage:wontfix — will not be addressed
    • triage:duplicate — duplicate of another issue
  2. WilcoLouwerse commented on Nov 6, 2026

    @WilcoLouwerse
    ContributorAuthor

    Status 2026-11-06 — Stap 1 t/m 5 en 6a afgerond

    • Gereproduceerd op NC 35.0.2 + MariaDB 11.3 met openregister 2.1.42-beta.20261102161558: verse install én (nagebootst) update-pad geven dezelfde 1064 bij row_number als op de directory. Oorzaak los van de app bevestigd: Doctrine DBAL 3.10.4 zet row_number op MariaDB niet tussen quotes, op MySQL 8 wel.
    • MySQL 8: row_number is daar geen probleem (DBAL quote het; tabel en rename getest). Een verse install op MySQL 8 faalt wel eerder, op [BUG] Unable to enable OpenRegister 2.1.0 on nextcloud with MySQL DB 8.4.11 #4311 (JSON-kolom met default). De titel van dit issue klopt dus alleen voor MariaDB.
    • Fix (branch hotfix/beta-4909-mariadb-row-number, nog niet gepusht): de migratie maakt row_no; een nieuwe migratie hernoemt een bestaande row_number met één gequote RENAME COLUMN, zodat rijen en unieke index blijven. Het JSON-veld row blijft gelijk. Getest op MariaDB (verse install, na een mislukte install, update, workaround-tabellen met rijen) en PostgreSQL (rijen behouden), plus import-preview + commit.
    • Vangnet: een unit test die elke kolom uit de migraties toetst aan de gereserveerde woorden die ik op MariaDB 11.3 en MySQL 8.0 heb gemeten.

    Volgende stap: handmatige test, daarna PR naar beta.

    Volledige plan: openregister-4909

  3. changed the title [-]Migration Version1Date20260915050000 fails on MariaDB/MySQL: column name row_number is a reserved word[/-] [+]Migration Version1Date20260915050000 fails on MariaDB: column name row_number is a reserved word[/+] on Nov 6, 2026
  4. WilcoLouwerse commented on Nov 12, 2026

    @WilcoLouwerse
    ContributorAuthor

    Status 2026-11-12: done, online test follows.

    Where the fix is

    Manual test, 2026-11-12 (NC 35.0.2, MariaDB 11.3 and PostgreSQL 16, fix on top of the latest beta, OpenCatalogi beta alongside), all passed:

    1. MariaDB, after the update: no upgrade or maintenance message; Open Register enabled on the fix build.
    2. MariaDB: preview rows created before the update (in the old row_number column) are still there after the rename, in source order.
    3. MariaDB: a new import preview gets rows 2 and 3 and commits (applied 2, failed 0).
    4. PostgreSQL: the rename kept the existing rows, in source order.

    Testplan: https://github.com/ConductionNL/readonly-mirror-wilco-claude-plans/blob/dev-mirror/issues/github/openregister/openregister-4909/openregister-4909-testplan.txt

    Still open, not blocking: the check on live.commonground.nu runs in the combined test of the WOO autumn release (WOO-487 test plan, section 18). Normally an issue closes after the online test. For this release all changes are tested together and then rolled out at once, so this issue closes now. The outcome comes as a comment here; a finding reopens it or becomes a new issue.

    Full plan: openregister-4909-plan-12-11.txt

  5. added 3 commits that reference this issue on Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions