DokumentationCommerceImplementierungs-Playbook

Upgrade-Voraussetzungen für MariaDB

Last update: Wed Feb 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Experienced
  • Developer

Vor der Aktualisierung von Adobe Commerce auf Cloud-Infrastruktur müssen Sie möglicherweise auch Ihre Datenbanksoftware aktualisieren, wenn Sie MariaDB verwenden. Beispiel:

  • Adobe Commerce 2.4.6 mit MariaDB-Version 10.5.1 oder höher
  • Adobe Commerce 2.3.5 mit MariaDB-Version 10.3 oder früher

Adobe Commerce 2.4.6

Ab MariaDB 10.5.1 werden Spalten mit alten temporalen Formaten mit einem /* mariadb-5.3 */ Kommentar in der Ausgabe der SHOW CREATE TABLE, SHOW COLUMNS, DESCRIBE sowie in der COLUMN_TYPE Spalte INFORMATION_SCHEMA.COLUMNS Tabelle. Siehe MariaDB-Dokumentation.

Adobe Commerce kann die Datumsspalten aufgrund des MariaDB-Kommentars nicht einem geeigneten Datentyp zuordnen, was zu unerwartetem Verhalten im benutzerspezifischen Code führen kann.

Um unerwartetes Verhalten bei der Aktualisierung von MariaDB von älteren Versionen auf Version 10.6 zu vermeiden, empfiehlt Adobe, die Spalten in das neue interne Format zu migrieren.

Standardkonfiguration

In MariaDB 10.1.2 wurde ein neues temporales Format von MySQL 5.6 eingeführt. Die mysql56_temporal_format Mit der Systemvariable kann die Datenbank das alte Datumsformat automatisch in das neue konvertieren, wenn eine geänderte Tabelle ausgeführt oder die Datenbank importiert wird. Die Standardkonfiguration für mysql56_temporal_format in Adobe Commerce in der Cloud-Infrastruktur immer aktiviert ist.

Datumsspalten migrieren

Die folgende Abfrage zeigt die betroffene Tabelle und die Spalten, die nach der Aktualisierung von MariaDB auf 10.5.1 oder höher migriert werden müssen:

SELECT * FROM INFORMATION_SCHEMA.`COLUMNS` WHERE TABLE_SCHEMA = DATABASE() AND COLUMN_TYPE LIKE '%mariadb%';

Für die Migration der Spalten in das neue interne Datumsformat ist es erforderlich, die Datenbank erneut zu importieren oder Änderungen an der identifizierten Spalte mit derselben Spaltendefinition auszuführen. Die folgende Abfrage erzeugt die erforderlichen Abfrageänderungen:

SELECT CONCAT( 'ALTER TABLE `', COALESCE(TABLE_NAME), '`', ' MODIFY ', '`', COALESCE(COLUMN_NAME), '`', ' ', COALESCE(DATA_TYPE), ' ', IF(COALESCE(IS_NULLABLE)='YES','NULL', 'NOT NULL'), IF(COLUMN_DEFAULT IS NOT NULL,CONCAT(' DEFAULT ',COLUMN_DEFAULT),' '), ' ', COALESCE(EXTRA), ' COMMENT \'', COALESCE(COLUMN_COMMENT), '\';' ) as sql_query FROM INFORMATION_SCHEMA.`COLUMNS` WHERE TABLE_SCHEMA = DATABASE() AND COLUMN_TYPE LIKE '%mariadb%';
NOTE
Es ist wichtig, die Spalten in das neue interne Datumsformat zu migrieren before Bereitstellung des neuen Codes, um unerwartetes Verhalten zu vermeiden.

Adobe Commerce 2.3.5

Die Aktualisierung des MariaDB-Diensts auf der Cloud-Infrastruktur von Version 10.0 oder 10.2 auf Version 10.3, 10.4 oder 10.5. MariaDB-Version 10.3 und höher erfordert, dass die Datenbank das dynamische Tabellenzeilenformat verwendet, und Adobe Commerce erfordert die Verwendung der InnoDB-Speicher-Engine für Tabellen. In diesem Artikel wird beschrieben, wie Sie Ihre Datenbank aktualisieren, um diese MariaDB-Anforderungen zu erfüllen.

Nachdem Sie die Datenbank vorbereitet haben, senden Sie ein Adobe Commerce-Supportticket, um die MariaDB-Dienstversion in Ihrer Cloud-Infrastruktur zu aktualisieren, bevor Sie mit dem Adobe Commerce-Upgrade-Prozess fortfahren.

Vorbereiten Ihrer Datenbank auf die Aktualisierung

Bevor das Adobe Commerce-Supportteam mit dem Upgrade-Prozess beginnt, bereiten Sie Ihre Datenbank vor, indem Sie Ihre Datenbanktabellen konvertieren:

  • Konvertieren des Zeilenformats aus COMPACT nach DYNAMIC
  • Ändern Sie die Speicher-Engine von MyISAM nach InnoDB

Beachten Sie beim Planen und Planen der Konvertierung die folgenden Überlegungen:

  • Konvertieren aus COMPACT nach DYNAMIC -Tabellen können bei einer großen Datenbank mehrere Stunden dauern.

  • Führen Sie zur Vermeidung von Datenbeschädigung keine Konversionsarbeiten auf einer Live-Site durch.

  • Schließen Sie die Konversionsarbeit während eines niedrigen Traffic-Zeitraums auf Ihrer Site ab.

  • Wechseln Sie zu Wartungsmodus bevor Sie die Befehle zum Konvertieren von Datenbanktabellen ausführen.

Tabellenzeilenformat der Datenbank konvertieren

Sie können Tabellen auf einem Knoten im Cluster konvertieren. Die Änderungen werden automatisch auf den anderen Dienstknoten repliziert.

  1. Verwenden Sie in Ihrer Adobe Commerce-Umgebung für Cloud-Infrastruktur SSH, um eine Verbindung zu Knoten 1 herzustellen.

  2. Melden Sie sich bei MariaDB an.

  3. Identifizieren Sie Tabellen, die vom kompakten in das dynamische Format konvertiert werden sollen.

    code language-mysql 
    SELECT table_name, row_format FROM information_schema.tables WHERE table_schema=DATABASE() and row_format = 'Compact';

  4. Legen Sie die Tabellengrößen fest, damit Sie die Konvertierungsarbeit planen können.

    code language-mysql 
    SELECT table_schema as 'Database', table_name AS 'Table', round(((data_length + index_length) / 1024 / 1024), 2) 'Size in MB' FROM information_schema.TABLES ORDER BY (data_length + index_length) DESC;

    Die Konvertierung größerer Tabellen dauert länger. Überprüfen Sie die Tabellen und erstellen Sie einen Batch der Konvertierungsarbeit nach Priorität und Tabellengröße, um die erforderlichen Wartungsfenster zu planen.

  5. Konvertieren Sie alle Tabellen einzeln in das dynamische Format.

    code language-mysql 
    ALTER TABLE [ table name here ] ROW_FORMAT=DYNAMIC;

Dateispeicherformat der Datenbank konvertieren

Sie können Tabellen auf einem Knoten im Cluster konvertieren. Die Änderungen werden automatisch auf den anderen Dienstknoten repliziert.

Die Konvertierung des Speicherformats unterscheidet sich bei Adobe Commerce Starter- und Adobe Commerce Pro-Projekten.

  • Verwenden Sie für die Starter-Architektur MySQL ALTER zum Konvertieren des Formats.
  • Verwenden Sie auf Pro-Architektur MySQL CREATE und SELECT Befehle zum Erstellen einer Datenbanktabelle mit InnoDB speichern und kopieren Sie die Daten aus der vorhandenen Tabelle in die neue Tabelle. Diese Methode stellt sicher, dass die Änderungen auf allen Knoten im Cluster repliziert werden.

Konvertieren des Tabellenspeicherformats für Adobe Commerce Pro-Projekte

  1. Identifizieren von Tabellen, die MyISAM Speicher.

    code language-mysql 
    SELECT table_name FROM INFORMATION_SCHEMA.TABLES WHERE engine = 'MyISAM';

  2. Alle Tabellen in InnoDB Speicherformat einzeln.

    • Benennen Sie die vorhandene Tabelle um, um Namenskonflikte zu vermeiden.

      code language-mysql 
      RENAME TABLE <existing_table> <table_old>;

    • Erstellen Sie eine Tabelle, die InnoDB Speicher mithilfe der Daten aus der vorhandenen Tabelle.

      code language-mysql 
      CREATE TABLE <existing_table> ENGINE=InnoDB SELECT * from <table_old>;

    • Stellen Sie sicher, dass die neue Tabelle alle erforderlichen Daten enthält.

    • Löschen Sie die ursprüngliche Tabelle, die Sie umbenannt haben.

Konvertieren des Tabellenspeicherformats für Adobe Commerce Starter-Projekte

  1. Identifizieren von Tabellen, die MyISAM Speicher.

    code language-mysql 
    SELECT table_name FROM INFORMATION_SCHEMA.TABLES WHERE engine = 'MyISAM';

  2. Konvertieren von Tabellen, die MyISAM Speicher in InnoDB Speicher.

    code language-mysql 
    ALTER TABLE [ table name here ] ENGINE=InnoDB;

Überprüfen der Datenbankkonvertierung

Überprüfen Sie am Tag vor der geplanten Aktualisierung auf die MariaDB-Version 10.3, 10.4 oder 10.6, ob alle Tabellen über das richtige Zeilenformat und die richtige Speichermodul verfügen. Eine Verifizierung ist erforderlich, da Code-Bereitstellungen nach Abschluss der Konvertierung dazu führen können, dass einige Tabellen wieder in ihre ursprüngliche Konfiguration zurückgesetzt werden.

  1. Melden Sie sich bei Ihrer Datenbank an.

  2. Suchen Sie nach Tabellen, für die noch die Variable COMPACT Zeilenformat.

    code language-mysql 
    SELECT table_name, row_format FROM information_schema.tables WHERE table_schema=DATABASE() and row_format = 'Compact';

  3. Suchen Sie nach Tabellen, die weiterhin die MyISAM Speicherformat

    code language-mysql 
    SELECT table_name FROM INFORMATION_SCHEMA.TABLES WHERE engine = 'MyISAM';

  4. Wenn Tabellen zurückgesetzt wurden, wiederholen Sie die Schritte zum Ändern des Tabellenzeilenformats und der Speicher-Engine.

Speicher-Engine ändern

Siehe Konvertieren von MyISAM-Tabellen in InnoDB.

recommendation-more-help
754cbbf3-3a3c-4af3-b6ce-9d34390f3a60