mysql-async-Ressourcen sicher zu oxmysql migrieren

Verschiebe eine Ressource von mysql-async zu oxmysql, indem du die Treiberkonfiguration änderst und die Parameter, Rückgabewerte und Fehlerbehandlung jeder Abfrage überprüfst. Eine Treiber-Migration erfordert keine Neuschreibung deines Datenbankschemas und garantiert keine schnellere Spielleistung.

Bereite einen wiederherstellbaren Test vor

Sichere die Datenbank und die entsprechenden Ressourcen und arbeite dann an einer isolierten Kopie. Inventarisiere jede Ressource, die mysql-async verwendet, und prüfe, ob dein Framework bereits oxmysql benötigt. Notiere die installierte Treiberversion. Überprüfe die oxmysql-Quelle und Installationsanweisungen für diese Version, bevor du die Treiber wechselst.

Lade die Verbindung vor dem Treiber

In the active server.cfg, keep the existing private mysql_connection_string setting above ensure oxmysql. Start dependent resources afterwards. Do not publish connection credentials in support logs. Remove the old driver startup only after every dependent resource has been accounted for.

Lade in jeder Lua-Ressource, die das globale Objekt MySQL verwendet, die Bibliothek vor ihren Server-Skripten:

server_scripts {
    '@oxmysql/lib/MySQL.lua',
    'server/*.lua'
}
dependency 'oxmysql'

Wähle das Ergebnis, das du benötigst

Verwende MySQL.query.await für eine Reihe von Zeilen, MySQL.single.await für eine Zeile, MySQL.scalar.await für einen Wert, MySQL.insert.await für eine Einfüge-ID und MySQL.update.await für betroffene Zeilen. Überprüfe die dokumentierte Rückgabe für deine Abfrage; ein leeres Ergebnis unterscheidet sich von einem Fehler.

Dieses serverseitige Beispiel testet eine parametrisierte Roundtrip-Verbindung, ohne eine Gameplay-Tabelle zu berühren. Führe es von einer Ressource aus, nachdem oxmysql gestartet wurde:

CreateThread(function()
    local ok, value = pcall(function()
        return MySQL.scalar.await('SELECT ?', { 'connection-ok' })
    end)
    if ok and value == 'connection-ok' then
        print('Database parameter check passed.')
    else
        print('Database parameter check failed; inspect the server log privately.')
    end
end)

Überprüfe jeden konvertierten Aufruf

Ersetze interpolierte Benutzerwerte durch positionale ? -Platzhalter und eine geordnete Parametertabelle. Tabellen- und Spaltenbezeichner erfordern eine feste Zulassungsliste; Wertplatzhalter können keine beliebigen SQL-Bezeichner auswählen.

Await ändert den Kontrollfluss: Verwende das Ergebnis, nachdem der Await zurückkehrt, behandle fehlende Zeilen und Ausnahmen und überprüfe, ob der Spieler noch verbunden ist, bevor du handelst. Ein erfolgreicher SQL-Schreibvorgang aktualisiert nicht automatisch den In-Memory-Spielerstatus eines Frameworks.

Transaktionen auf einer Verbindung halten

Verwende die dokumentierte Transaktions-API des Treibers für gruppierte SQL-Arbeiten. Separate START TRANSACTION, Abfrage und COMMIT Aufrufe über einen Verbindungspool garantieren nicht, dass alle Anweisungen dieselbe Verbindung verwenden.

Eine erfolgreiche Transaktion bedeutet, dass ihre SQL-Anweisungen nicht fehlgeschlagen sind. Ein UPDATE , das keine Zeile verändert, kann trotzdem gültiges SQL sein. Zahlungs- und Inventarlogik müssen die fachlichen Bedingungen ausdrücklich prüfen; kopiere kein allgemeines Beispiel für Guthabenübertragungen in eine Live-Spielwirtschaft.

Korrektheit vor Geschwindigkeit überprüfen

1. Suche nach verbleibenden mysql-async-Importen, -Exporten und Callback-Mustern. Überprüfe, ob jeder Aufrufer die erwartete Form erhält.
2. Teste Login, Charaktererstellung, Speichern, Wiederverbindung, Inventar, Garagen und relevante Job-Aktionen mit bekannten Datensätzen. Teste nicht verfügbare Datenbanken und abgelehnte Eingaben.
3. Vergleiche erwartete Zeilenänderungen und persistierte Salden. Halte Schema-/Indexänderungen von dieser Treiber-Migration getrennt.
4. Für die Leistung messe dieselbe Gameplay-Aktion und Arbeitslast vor und nach der Änderung. Untersuche langsame Abfragen mit ihren Ausführungsplänen; füge Indizes erst nach Überprüfung des tatsächlichen Schemas und der Abfrage hinzu.

Veröffentlichung und Rollback

Plane ein Wartungsfenster ein, stelle den passenden Treiber/Ressourcen-Satz bereit und führe dieselben Prüfungen durch. Halte den alten Satz für ein Rollback privat. Stelle ein Datenbank-Backup nur wieder her, wenn es für geänderte Daten oder Schemata erforderlich ist, und berücksichtige alle Schreibvorgänge seit diesem Backup. Das Zurückkonvertieren von Text in einen kleineren Zeichensatz ist kein sicheres generisches Rollback.

Referenzdokumentation

Quelle: overextended/oxmysql