Webentwicklung

CHECK-Constraints in MariaDB — Die Datenbank soll unmögliche Zeilen ablehnen

CHECK-Constraints in MariaDB — Die Datenbank soll unmögliche Zeilen ablehnen

CHECK-Constraints in MariaDB — Die Datenbank soll unmögliche Zeilen ablehnen

Ein Webformular kann einen negativen Preis ablehnen. Ein PHP-Handler kann prüfen, ob ein Enddatum nach einem Startdatum liegt. Aber was passiert, wenn dieselbe Tabelle von einem Importscript, einem Administrator, einem Hintergrundjob oder einer zweiten Anwendung beschrieben wird?

Hier hilft ein Datenbank-Constraint. Statt von jedem Writer zu verlangen, dieselbe Zeilenregel zu kennen, kann ein dauerhafter Teil dieser Regel direkt bei den Daten liegen. In MariaDB wertet ein CHECK-Constraint eine Bedingung aus, wenn eine Zeile eingefügt oder aktualisiert wird. Ist die Bedingung false, wird der Schreibvorgang abgelehnt.

Dadurch wird die Anwendungsvalidierung nicht überflüssig. Der Constraint gibt der Datenbank einen Schutz für Regeln, die unabhängig vom Codepfad, der den Schreibvorgang ausführt, immer gelten müssen.

Wofür ist ein CHECK-Constraint gedacht?

MariaDB dokumentiert vier häufige Gruppen von Tabellen-Constraints: PRIMARY KEY, FOREIGN KEY, UNIQUE und CHECK. Sie schützen unterschiedliche Eigenschaften:

  • PRIMARY KEY identifiziert eine Zeile und ist eindeutig sowie nicht null.
  • UNIQUE verhindert doppelte Werte in einem Schlüssel.
  • FOREIGN KEY verbindet einen Wert mit einer Zeile in einer anderen Tabelle.
  • CHECK prüft, ob Werte in der Zeile eine Bedingung erfüllen.

Ein Check passt daher zu einer Zeileninvariante: einer Aussage, die für jede gespeicherte Zeile wahr sein soll. Ein Produktpreis darf nicht negativ sein. Ein Lagerbestand darf nicht unter null liegen. Die Endzeit eines Ereignisses darf nicht vor seiner Startzeit liegen.

Das ist enger als “alle Eingaben validieren”. Die OWASP-Anleitung zur Eingabevalidierung trennt die syntaktische und semantische Validierung von anderen Kontrollen wie parametrisierten SQL-Abfragen, Output-Encoding und Autorisierung. Ein Constraint trägt zur Datenintegrität bei; er entscheidet nicht, ob ein Benutzer eine Zeile bearbeiten darf oder ob eine HTML-Antwort sicher ist.

Regeln auf Spalten- und Tabellenebene

MariaDB unterstützt eine kurze Form auf Spaltenebene und eine benannte Form auf Tabellenebene. Die erste ist praktisch, wenn eine Regel nur eine Spalte betrifft:

CREATE TABLE inventory_item (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(120) NOT NULL,
    price DECIMAL(10, 2) NOT NULL CHECK (price >= 0),
    stock INT NOT NULL CHECK (stock >= 0)
);

Die Bedingungen beschreiben Eigenschaften einzelner Werte. Ein negativer Preis oder Lagerbestand gehört nicht in diese Tabelle, also kann die Datenbank ihn ablehnen, selbst wenn ein neuer Writer die Regel nicht wiederholt.

Ein Constraint auf Tabellenebene ist ausdrucksstärker, wenn mehrere Spalten gemeinsam betrachtet werden müssen. Ein Name macht auch Wartung und Fehlersuche übersichtlicher:

CREATE TABLE booking (
    id INT PRIMARY KEY AUTO_INCREMENT,
    starts_at DATETIME NOT NULL,
    ends_at DATETIME NOT NULL,
    CONSTRAINT booking_dates_ordered
        CHECK (ends_at > starts_at)
);

Der Name ist nicht nur Dekoration. MariaDB kann ihn in einer Fehlermeldung verwenden, und ein benannter Constraint bietet ein stabiles Ziel für eine Migration, falls die Regel später entfernt oder ersetzt werden muss.

CHECK ist nicht dasselbe wie NOT NULL

Ein leicht zu übersehender Fehler besteht darin, eine Bedingung zu verwenden und die Spalte trotzdem nullable zu lassen. Betrachte diese Definition:

CREATE TABLE article_stat (
    id INT PRIMARY KEY AUTO_INCREMENT,
    view_count INT CHECK (view_count >= 0)
);

Die Regel beschreibt nicht-negative Zähler, sagt aber nicht eindeutig, ob ein fehlender Zähler erlaubt ist. Wenn das Fehlen ungültig ist, sollte es ausdrücklich angegeben werden:

CREATE TABLE article_stat (
    id INT PRIMARY KEY AUTO_INCREMENT,
    view_count INT NOT NULL CHECK (view_count >= 0)
);

Dieser Unterschied ist wichtig, weil SQL einen Wertmarker namens NULL besitzt. Er ist nicht dasselbe wie null, eine leere Zeichenkette oder ein fehlendes HTTP-Feld. Eine Bedingung mit nullable Werten folgt nicht immer der einfachen True-or-False-Intuition gewöhnlicher Programmiersprachen. Wenn “unknown” abgelehnt werden soll, muss diese Regel mit NOT NULL oder einer Bedingung, die NULL bewusst behandelt, ausdrücklich formuliert werden.

Für optionale Datumswerte könnte die gewünschte Regel lauten: “Beide Datumswerte fehlen, oder beide sind vorhanden und geordnet”:

CONSTRAINT optional_booking_dates_valid
    CHECK (
        (starts_at IS NULL AND ends_at IS NULL)
        OR (starts_at IS NOT NULL AND ends_at IS NOT NULL
            AND ends_at > starts_at)
    )

Ob das die richtige Regel ist, bleibt eine Entscheidung der Fachdomäne. Wichtig ist, nullable Spalten nicht stillschweigend über diese Policy entscheiden zu lassen.

Was passiert bei INSERT und UPDATE?

Checks gelten für Schreibvorgänge und nicht nur für die ursprüngliche Tabellendefinition. Eine gestern gültige Zeile sollte nicht allein deshalb ungültig werden, weil ein Update einen ihrer Werte verändert.

Mit der Regel booking_dates_ordered müssen zum Beispiel beide Vorgänge die Bedingung erfüllen:

INSERT INTO booking (starts_at, ends_at)
VALUES ('2026-11-16 09:00:00', '2026-11-16 10:00:00');

UPDATE booking
SET ends_at = '2026-11-16 11:00:00'
WHERE id = 1;

Wenn ein Insert oder Update den Ausdruck false werden lässt, lehnt MariaDB den Vorgang ab. Die Anwendung sollte diese Ablehnung als Fehler der Datenintegrität behandeln und eine passende Antwort senden. Sie darf nicht annehmen, dass eine Prüfung im Client oder eine frühere PHP-Prüfung die Annahme durch die Datenbank garantiert.

Eine Regel zu einer bestehenden Tabelle hinzufügen

Constraints können Teil von CREATE TABLE sein, aber auch mit ALTER TABLE hinzugefügt werden:

ALTER TABLE inventory_item
ADD CONSTRAINT inventory_item_stock_nonnegative
CHECK (stock >= 0);

Diese Migration sollte geplant und nicht einfach in die Produktion kopiert werden. Vorhandene Zeilen können die neue Regel bereits verletzen, und der Code, der in die Tabelle schreibt, ist möglicherweise noch nicht auf den neuen Fehler vorbereitet. Zuerst sollten die Daten geprüft und bereinigt werden. Danach können Anwendungsverhalten und Constraint als eine bewusste Änderung ausgerollt werden.

Die resultierende Definition lässt sich mit der Schemaausgabe der Datenbank prüfen:

SHOW CREATE TABLE inventory_item;

Wenn eine benannte Regel tatsächlich nicht mehr benötigt wird, dokumentiert MariaDB ihre Entfernung mit ALTER TABLE ... DROP CONSTRAINT. Einen Constraint zu entfernen sollte wie das Entfernen eines Tests behandelt werden: Der Grund sollte festgehalten werden, statt einen fehlschlagenden Import zu verstecken.

Was CHECK nicht schützt

Ein Check-Constraint ist bewusst begrenzt. Er ersetzt nicht die übrigen Prüfungen an der Anwendungsgrenze:

  • Request parsen und seine Struktur prüfen, bevor die Business-Logik ihn verwendet.
  • Autorisierung prüfen. Eine gültige article_id beweist nicht, dass der Aufrufer den Artikel bearbeiten darf.
  • Parametrisierte Queries verwenden. Ein Constraint macht aus SQL, das aus Strings zusammengesetzt wird, kein sicheres SQL.
  • Ausgaben für ihr Ziel encodieren oder sanitizen. Ein gültiger Datenbankwert kann in einem HTML-, JavaScript-, URL- oder Log-Kontext trotzdem gefährlich sein.
  • Dem Benutzer eine verständliche Validierungsmeldung geben. Eine rohe Datenbankfehlermeldung ist meist zu technisch und kann interne Namen preisgeben.

Anwendung und Datenbank haben daher unterschiedliche Aufgaben. PHP kann vor dem Schreibvorgang erklären, dass die Endzeit nach der Startzeit liegen muss. MariaDB kann dieselbe Invariante durchsetzen, wenn ein anderer Pfad die Tabelle erreicht. Eine Regel in beiden Schichten zu wiederholen ist nicht automatisch Verschwendung: Die eine Schicht verbessert das Feedback, die andere schützt den gespeicherten Zustand.

Die Regel klein und deterministisch halten

Ein Constraint ist am leichtesten zu verstehen, wenn er eine stabile Eigenschaft der Zeile beschreibt. Gute Kandidaten sind Vergleiche, Wertebereiche, erforderliche Beziehungen zwischen Spalten und die Zugehörigkeit zu einer kleinen erlaubten Menge.

Vorsicht ist bei Regeln angebracht, die von sich änderndem externem Zustand, versteckten Annahmen oder nichtdeterministischem Verhalten abhängen. Die MariaDB-Dokumentation behandelt deterministische Ausdrücke und weist darauf hin, dass Constraint-Verhalten in Replikationsumgebungen besondere Aufmerksamkeit braucht. Die Datenbankversion, der SQL-Modus, die Storage Engine und die Deployment-Topologie gehören zum tatsächlichen Kontext der Regel.

MariaDB dokumentiert außerdem die Systemvariable check_constraint_checks, mit der sich Ausdrucksprüfungen beispielsweise während eines kontrollierten Datenimports deaktivieren lassen. Das ist ein operativer Ausweg und keine normale Anwendungseinstellung. Wenn Checks deaktiviert sind, können ungültige Daten in die Tabelle gelangen; dann muss der Importprozess sie finden und reparieren.

Fazit

CHECK-Constraints sind nützlich, wenn eine Datenbank eine Zeile ablehnen soll, die eine einfache und dauerhafte Regel verletzt. Besonders wertvoll sind sie, wenn mehrere Writer auf eine Tabelle zugreifen, weil die Regel dann nicht nur in einem Form-Handler oder einer PHP-Funktion liegt.

Sie ersetzen keine Request-Validierung, Autorisierung, parametrisierten Queries oder Ausgabesicherheit. Ein praktischer Entwurf kann beides verwenden: früh validieren, um dem Benutzer klares Feedback zu geben, und MariaDB anschließend die Invariante am letzten verantwortlichen Punkt durchsetzen lassen. Die entscheidende Frage lautet nicht nur “Kann diese Regel als SQL geschrieben werden?”, sondern “Ist dies eine Tatsache, die jede gespeicherte Zeile erfüllen muss?”

References

  1. CONSTRAINT — MariaDB Documentation
  2. CREATE TABLE — MariaDB Documentation
  3. Input Validation Cheat Sheet — OWASP Cheat Sheet Series