SQL von Erweiterungen für jede Engine prüfen #

Diese Seite richtet sich an Datenbankadministratoren, die eine Erweiterung freigeben müssen, bevor sie auf einer Website mit PostgreSQL, SQLite, Oracle oder MongoDB installiert wird. Das eigene SQL von Exponential läuft auf jeder unterstützten Engine; Erweiterungscode und handgeschriebenes SQL oft nicht, weil die meisten Erweiterungen gegen MySQL geschrieben wurden. Diese Seite listet, worauf Sie achten und wo. Quelle: 9.8 Hinweise über Engines hinweg.

Inhalt #

1. Wo das SQL einer Erweiterung liegt
2. Wonach Sie suchen
3. Treiberhelfer
4. Abweichende Semantik
5. MongoDB
6. Testen
7. Checkliste

Wo das SQL einer Erweiterung liegt #

• share/db_schema.dba und share/db_data.dba: das engine-neutrale Schema, der beste Fall; die Upgrade-Prüfung liest es.
• sql/<engine>/*.sql: DDL je Engine. Eine Erweiterung mit nur sql/mysql/ hat noch keine Tabellen für andere Engines.
• PHP: Definitionen von eZPersistentObject (portabel) und handgeschriebene Anweisungen in Aufrufen von query() und arrayQuery() (die zu lesenden).
• Update-Dateien der eigenen Releases der Erweiterung.

Wonach Sie suchen #

grep -rn '`' extension/<name> --include=*.php | grep -i 'select\|insert\|update\|delete'     # backticks
grep -rniE 'FROM [a-z_]+ AS [a-z_]+' extension/<name> --include=*.php                        # AS before a table alias
grep -rniE 'SET (NAMES|FOREIGN_KEY_CHECKS|SQL_MODE|AUTOCOMMIT)' extension/<name>               # MySQL session statements
grep -rniE 'LIMIT [0-9]+ *, *[0-9]+|IFNULL|GROUP_CONCAT|ON DUPLICATE KEY|REPLACE INTO' extension/<name>   # MySQL dialect

Treiberhelfer #

Die Treiber implementieren, was sich zwischen Engines unterscheidet; Code sollte sie aufrufen, statt das SQL zu schreiben:

Abweichende Semantik #

• Leere Zeichenketten: Oracle gibt für '' NULL zurück, sofern nicht OracleEmptyStringForNull=enabled.
• Groß-/Kleinschreibung: Die Standard-Sortierfolgen von MySQL ignorieren sie; PostgreSQL und Oracle vergleichen mit Beachtung; SQLite vergleicht = mit Beachtung und ignoriert ASCII-Schreibweise in LIKE. Vergleichen Sie lower(...) auf beiden Seiten, wo die Schreibweise keine Rolle spielen darf (Zeichensätze und Sortierfolgen).
• Scheitern gegenüber leerem Ergebnis: Eine gescheiterte Anweisung und ein leeres Ergebnis werden nicht auf jeder Engine gleich gemeldet. Um zu fragen, ob eine Tabelle existiert, fragen Sie den Katalog (eZTableList() des Treibers), nicht ein SELECT, das scheitern kann.
• Indexnamen gelten auf SQLite und PostgreSQL datenbankweit; die Schema-Handler legen einen kollidierenden Namen als <table>__<name> an. Halten Sie Namen innerhalb der Lint-Grenzen (Das .dba-Schemaformat).
• Ganzzahlen: Die Spaltenbereiche unterscheiden sich ($db::MAX_INT); $db->clampInteger() hält einen Wert im Bereich.
• Fehlercodes unterscheiden sich (Fehlercodes und Meldungen der Datenbank).

MongoDB #

Der Adapter führt nie SQL aus; er übersetzt, was er kann, und liefert für den Rest ein leeres Ergebnis, wobei er MONGO TODO protokolliert. Eine Erweiterung mit handgeschriebenem SQL braucht entweder SQL, das der Adapter versteht, oder einen eigenen MongoDB-Weg. Klicken Sie jede Funktion der Erweiterung auf einer MongoDB-Staging-Kopie durch und durchsuchen Sie die Logs (MongoDB: Grenzen und Betrieb).

Testen #

1. Installieren Sie die Erweiterung auf einer Staging-Kopie der Ziel-Engine.
2. Führen Sie ihr Schema über ezsqlinsertschema.php oder ihren Installer aus; führen Sie die Upgrade-Prüfung aus.
3. Verwenden Sie jede Funktion; beobachten Sie var/log/error.log und die Debug-Ausgabe mit SQLOutput=enabled für Ihre Adresse.
4. Führen Sie die eigenen Tests der Erweiterung aus, falls sie welche hat.

Checkliste #

• To do: Die Erweiterung hat share/db_schema.dba oder SQL-Dateien für die Ziel-Engine.
• To do: Keine Backticks, kein AS vor Tabellenaliasen, keine reinen MySQL-Session-Anweisungen.
• To do: Treiberhelfer für Zeichenketten, Hashes, Bits, Blättern und IDs verwendet.
• To do: Suchen ohne Beachtung der Groß-/Kleinschreibung verwenden lower(...).
• To do: Auf Staging auf der Ziel-Engine ohne neue Fehler getestet.

Verwandte Seiten #

• Erweiterungsentwicklung
• Eine Engine wählen
• Datenbankunterstützung
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.