SQL-Syntax - akzeptiert von der Prüffunktion von "zac4web"

Die Prüffunktion "sql_update_befehle_testen()" akzeptiert die Befehle nur, wenn ...

• ... in dem Befehl alle Tabellennamen, Spaltennamen, Indexnamen und Constraint-Namen kein anderes Zeichen als die nachfolgend gelisteten Zeichen enthalten:
  ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_

• ... in dem Befehl Tabellennamen, Spaltennamen, Indexnamen und Constraint-Namen jeweils von ` (Backticks) eingeschlossen sind.
• ... die Zeichenfolge ":=" nicht enthalten ist,
  damit die Funktion nicht aufwändig prüfen muss, ob es sich um einen Zuweisungsoperator in einer WHERE-Anweisung oder eine "harmlose" Zeichenfolge innerhalb einer Zeichenkette wie einem Kommentar handelt.
• ... jeder Befehl mit dem Semikolon ; beendet wird und zwischen einem Semikolon und dem Beginn des nächsten SQL-Befehls höchstens Whitespace-Zeichen (Leerzeichen, Zeilenumbrüche oder Tabulatorzeichen) vorhanden sind.
• ... die einzelnen Bestandteile (Bezeichner, Schlüsselwörter) innerhalb eines SQL-Befehls jeweils durch Whitespace-Zeichen getrennt sind.
  Ausnahmen:
  - Vor dem Semikolon am Ende des Befehls braucht kein Leerzeichen zu stehen.
  - Vor dem Komma, welches für Aufzählungen in einem SQL-Befehl verwendet wird, braucht kein Whitespace-Zeichen zu stehen.
  Unmittelbar vor und nach den Operatoren bei Wertzuweisungen brauchen keine Whitespace-Zeichen vorhanden zu sein.

• coldefinition
  • für Zeichenfolgen wie
    • int UNSIGNED NOT NULL
      - wenn nur positive ganze Zahlen oder die Zahl 0 in der Spalte notiert werden dürfen.
    • tinyint NOT NULL DEFAULT '0'
      - wenn in der Spalte nur boolesche Werte erfasst werden sollen, und der NULL-Wert nicht erlaubt und der Standardwert die Zahl 0 sein soll. Dabei steht die Zahl '0' für den booleschen Wert false und alle anderen Zahlen, die in die Spalte eingetragen werden können (meist wird die Zahl '1' verwendet) für den booleschen Wert true.
    • varchar(3) DEFAULT 'w'
      - wenn in der Spalte nur textuelle Werte mit einer maximalen Anzahl von 3 Zeichen erfasst werden sollen und beim INSERT-Befehl als Standardwert 'w' eingetragen werden soll, sofern diese Spalte im INSERT-Befehl in der Klammer vor "VALUES" nicht gelistet wird.
    • varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_german2_ci DEFAULT NULL
      - wenn in der Spalte nur textuelle Werte mit einer maximalen Anzahl von 50 Zeichen erfasst werden sollen, abweichend zum Standardzeichensatz für die Datenbanktabelle für die Werte in der Spalte der Zeichensatz "utf8mb4" mit der Sortierreihenfolge "utf8mb4_german2_ci" gelten soll und der NULL-Wert eingetragen werden soll, falls diese Spalte im INSERT-Befehl in der Klammer vor "VALUES" nicht gelistet wird.
• zwischen zwei Backticks `
  • `tn`, `tn_1`, `tn_2`, `tn_3`, `tn_new`, `tn_old` - für einen Tabellennamen
  • `cn`, `cn_x`, `cn_1`, `cn_2`, `cn_q1`, `cn_z1`, `cn_new`, `cn_old` - für einen Spaltennamen
  • `ik` - für einen Indexnamen
  • `fk` - für den Namen einer Fremdschlüsselbeziehung
  • `ck` - für den Namen einer Prüfbedingung
• zwischen zwei einfachen Hochkommata (= Apostroph)'
  • 'w_x', 'w_x_1', 'w_x_2' - für einen Wert
• zwischen zwei eckigen Klammern []
  • [...] - für Zeichenfolgen, die optional sind oder zusätzlich hinzugefügt werden können
• zwischen zwei geschweiften Klammern {}
  • {... | ... } - für alternative Zeichenfolgen, von denen genau eine gewählt werden muss
• check-condition
  • für Zeichenfolgen wie
    • `cn_1` > 'w_x'
      - damit kann für die Datensätze in der Tabelle `tn_1` der zulässige Wertebereich innerhalb der Spalte `cn_1` eingeschränkt werden.
    • `cn_1` <> `cn_2`
      - damit kann erzwungen werden, dass für jeden Datensatz innerhalb der Tabelle die Werte in den Spalten `cn_1` und `cn_2` nicht identisch sind.
      Wenn die Datentypen der beiden Spalten übereinstimmen, ist das Ergebnis der Bedingung immer eindeutig. Wurden aber den Spalten `cn_1` und `cn_2` unterschiedliche Datentypen zugewiesen, kann der Vergleich zu nicht erwarteten Ergebnissen führen, weil der Datenbank-Server unter Umständen für den Vergleich den Datentyp für den Wert der einen Spalte in den Datentyp der anderen Spalte umwandelt.
  Die Bedingung ist nach dem Wort "CHECK" immer in runden Klammern zu notieren.
  Mit den Skripten der Original-Version von "zac4web" können CHECK-Constraints nur im Rahmen des Befehls "ALTER TABLE `tn` ADD CONSTRAINT ..." erzeugt werden. Dabei muss jeder Spaltenname `cn_x` in der Bedingung mit dem Namen einer Spalte der Tabelle `tn` übereinstimmen.
  Als Vergleichsoperatoren akzeptieren die Skripte nur die Zeichenfolgen aus der nachfolgenden runden Klammer (!=, <>, >=, <=, <, > LIKE, NOT LIKE, !LIKE).
  
• where-condition
  Beginnt immer mit dem Schlüsselwort WHERE.
  Darauf folgt dann eine Bedingung oder mehrere durch logische Operatoren (AND, OR, XOR) miteinander verknüpfte und mit runden Klammern geklammerte Bedingungen. Die gesamte where-condition wird vom Datenbank-Server für jeden Datensatz der Tabelle ausgewertet. Der zugehörige Befehl wird für die Datensätze ausgeführt, für welche die gesamte where-condition den booleschen Wert true ergibt.
  Für die Prüffunktion sql_update_befehle_testen() muss jede Bedingung wie folgt aufgebaut sein:
  • Jede Bedingung muss mit einem in Backticks notierten Spaltennamen `cn_x` aus der Tabelle `tn` beginnen.
  • Auf den Spaltennamen in Backticks muss ein Vergleichsoperator oder die beiden beiden Aussagen "IS NULL", "IS NOT NULL" folgen. Als Vergleichsoperatoren können die Zeichenfolgen aus der nachfolgenden runden Klammer (LIKE, =, <=>, NOT LIKE, !LIKE, !=, <>, >=, <=, <, >) eingesetzt werden.
  • Wird ein Vergleichsoperator eingesetzt, darf darauf nur eine Zeichenfolge oder eine Zahl als Vergleichswert folgen.
  Damit lässt die Prüffunktion sql_update_befehle_testen() Aussagen wie "WHERE 1" oder "WHERE `cn_1`=`cn_1`" oder "WHERE ... OR 1 ...", die immer den booleschen Wert true ergeben, nicht zu.
  Auch sind damit bei der Nutzung der Prüffunktion sql_update_befehle_testen() keine SELECT-Abfragen innerhalb der where-condition erlaubt.
• value
  • für eine positive Integerzahl

Im Gegensatz zu den Backticks und den Hochkommata, die in den SQL-Befehlen für das Update-Skript zusammen mit dem Namen bzw. Wert notiert werden müssen, werden die eckigen Klammern (und die geschweiften Klammern), welche in den Befehlen in der Tabelle optionale Zeichenfolgen (bzw. obligatorische alternative Zeichenfolgen) andeuten, niemals geschrieben.

• für "datentyp" werden folgende Angaben akzeptiert: INT, INTEGER, TINYINT, SMALLINT, MEDIUMINT, BIGINT.
• Als Vorgabewert x in der optionalen DEFAULT-Anweisung sind neben dem Wert NULL nur positive und negative Ganzzahlen zulässig.
• Pro Tabelle darf maximal eine Spalte als AUTO_INCREMENT-Spalte festgelegt werden.
  Bei den von sql_update_befehle_testen() erlaubten Befehlen muss die Spalte bereits vorhanden sein und als Primär-Index-Spalte festgelegt sein, wenn in der Spaltendefinition eine AUTO-INCREMENT-Anweisung enthalten ist. Die AUTO-INCREMENT-Anweisung ist bei den von sql_update_befehle_testen() akzeptierten Befehlen daher nur in den beiden Befehlen "ALTER TABLE `tn` MODIFY COLUMN `cn` ..." und "ALTER TABLE `tn` CHANGE COLUMN `cn` ..." sinnvoll.
  Falls bereits Datensätze in der Tabelle enthalten sind, ist die erweiterte AUTO_INCREMENT-Anweisung, bei der ein Integerwert zugeordnet wird, anzuwenden, wobei der Wert von ganzzahl dann mindestens um 1 höher sein muss, als der bereits zugeordnete höchste Wert in dieser Spalte.
  Die Einhaltung der Bedingungen rund um das AUTO-INCREMENT-Attribut überwacht der MySQL-Server.

Die Angabe einer Ganzzahl in runden Klammern nach "datentyp" und das Attribut ZEROFILL wird von sql_update_befehle_testen() nicht akzeptiert, weil beides in der MySQL-Dokumentation als veraltet gekennzeichnet ist.

• für "datentyp" werden folgende Angaben akzeptiert: FLOAT, DOUBLE, DOUBLE PRECISION, REAL.
• Als Vorgabewert x in der optionalen DEFAULT-Anweisung sind neben dem Wert NULL nur positive und negative Zahlen zulässig.

MySQL erlaubt zwar für Fließkommazahlen in der Spaltendefinition die Angabe der Präzision durch Angabe der Ziffern insgesamt und der Anzahl der Dezimalstellen. Dies wird aber von der Funktion sql_update_befehle_testen() nicht unterstützt, weil diese Präzision auch durch die Wahl des Datentyps DECIMAL (oder eines Synonyms dafür) erzielt werden kann.

Die Angabe der beiden Attribute UNSIGNED und ZEROFILL werden von sql_update_befehle_testen() für diese Datentypen nicht akzeptiert, weil beides in der MySQL-Dokumentation als veraltet gekennzeichnet ist.

• für "datentyp" werden folgende Angaben akzeptiert: DECIMAL, DEC, FIXED, NUMERIC.
• Mit dem optionalen "(M [,D])" kann der zulässige Zahlenbereich vorgegeben werden. Durch die Ganzzahl M (0 < M < 66) wird dabei gesteuert, wie viele Ziffern für die Zahl maximal gespeichert werden (Stellen vor und nach dem Dezimaltrennzeichen). Mit der Ganzzahl D (D < M) kann festgelegt werden, wie viele Dezimalstellen eine Zahl genau enthalten wird, dabei wird später bei der Eingabe und Aktualisierung von Datensätzen für jede fehlende Dezimalstelle die Ziffer 0 angehängt. Fehlt die optionale Angabe "(M [,D])" vollständig oder nur die Angabe zu D, gelten die Vorgaben des MySQL-Servers für diesen Datentyp hinsichtlich der Anzahl der Dezimalstellen (D) und der maximalen Anzahl an Ziffern (M).
  Wenn die optionale Anweisung "(M [,D])" vorhanden ist, prüft die Funktion sql_update_befehle_testen() legiglich, ob M und D nur aus Ziffern bestehen. Die anderen Bedingungen bezüglich der Werte M und D überwacht der MySQL-Server.
• Als Vorgabewert x in der optionalen DEFAULT-Anweisung sind neben dem Wert NULL nur positive und negative Zahlen zulässig.

Die Angabe der beiden Attribute UNSIGNED und ZEROFILL werden von sql_update_befehle_testen() für diese Datentypen nicht akzeptiert, weil beides in der MySQL-Dokumentation als veraltet gekennzeichnet ist.