DocumentatieCommerceAfspeelmap voor implementatie

Voorwaarden voor upgrades voor MariaDB

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ervaren
  • Ontwikkelaar

Voordat u Adobe Commerce op de cloudinfrastructuur kunt upgraden, moet u mogelijk ook uw databasesoftware bijwerken als u MariaDB gebruikt. Bijvoorbeeld:

  • Adobe Commerce 2.4.6 met MariaDB versie 10.5.1 of hoger
  • Adobe Commerce 2.3.5 met MariaDB versie 10.3 of lager

Adobe Commerce 2.4.6

Vanaf MariaDB 10.5.1 worden kolommen met oude tijdelijke indelingen gemarkeerd met een /* mariadb-5.3 */ -commentaar in de uitvoer van de instructies SHOW CREATE TABLE , SHOW COLUMNS , DESCRIBE en in de kolom COLUMN_TYPE van de tabel INFORMATION_SCHEMA.COLUMNS . zie documentatie MariaDB.

Adobe Commerce kan de datumkolommen niet toewijzen aan een juist gegevenstype vanwege de MariaDB-opmerking. Dit kan leiden tot onverwacht gedrag in aangepaste code.

Om onverwacht gedrag te voorkomen wanneer het bevorderen van MariaDB van oudere versies aan versie 10.6, adviseert de Adobe migrerend de kolommen aan het nieuwe interne formaat.

Standaardconfiguratie

In MariaDB 10.1.2, werd een nieuw tijdelijk formaat geïntroduceerd van MySQL 5.6. Met de systeemvariabele mysql56_temporal_format kan de database de oude datumnotatie automatisch omzetten naar de nieuwe als een tabel wordt gewijzigd of een database wordt geïmporteerd. De standaardconfiguratie voor mysql56_temporal_format is altijd ingeschakeld in Adobe Commerce op de cloudinfrastructuur.

Datumkolommen migreren

De volgende vraag toont de beïnvloede lijst en de kolommen die moeten worden gemigreerd na bevordering MariaDB aan 10.5.1 of later:

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

Voor het migreren van de kolommen naar de nieuwe interne datumnotatie moet de database opnieuw worden geïmporteerd of moet de opgegeven kolom met dezelfde kolomdefinitie worden gewijzigd. De volgende vraag produceert de noodzakelijke veranderlijke vragen:

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
Het is belangrijk om de kolommen aan het nieuwe interne datumformaat te migreren alvorens het opstellen van de nieuwe code om onverwacht gedrag te vermijden.

Adobe Commerce 2.3.5

De MariaDB-service in de cloudinfrastructuur wordt bijgewerkt van versie 10.0 of 10.2 naar versie 10.3, 10.4 of 10.5. Voor MariaDB-versie 10.3 en hoger moet de database de dynamische indeling voor tabelrijen gebruiken en voor Adobe Commerce is het gebruik van de InnoDB-opslagengine voor tabellen vereist. In dit artikel wordt uitgelegd hoe u uw database kunt bijwerken om aan deze MariaDB-vereisten te voldoen.

Nadat u de database hebt voorbereid, dient u een Adobe Commerce-ondersteuningsticket in om de versie van de MariaDB-service op uw cloudinfrastructuur bij te werken voordat u verdergaat met het Adobe Commerce-upgradeproces.

Uw database voorbereiden voor de upgrade

Voordat het Adobe Commerce-ondersteuningsteam met het upgradeproces begint, moet u uw database voorbereiden door uw databasetabellen te converteren:

  • De rijnotatie omzetten van COMPACT in DYNAMIC
  • De opslagengine wijzigen van MyISAM in InnoDB

Houd rekening met het volgende wanneer u de conversie plant en plant:

  • Het converteren van COMPACT naar DYNAMIC -tabellen kan enkele uren duren met een grote database.

  • Als u gegevensbeschadiging wilt voorkomen, voltooit u de conversiewerkzaamheden op een livesite niet.

  • Voltooi het omzettingswerk tijdens een lage verkeersperiode op uw plaats.

  • Schakelaar uw plaats aan onderhoudswijzealvorens de bevelen in werking te stellen om gegevensbestandlijsten om te zetten.

Opmaak databasetabelrij converteren

U kunt tabellen op één knooppunt in uw cluster omzetten. De wijzigingen worden automatisch overgenomen in de andere serviceknoppen.

  1. Gebruik vanuit uw Adobe Commerce op de cloud-infrastructuur SSH voor verbinding met knooppunt 1.

  2. Log in bij MariaDB.

  3. Tabellen identificeren die van compacte naar dynamische indeling moeten worden omgezet.

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

  4. Bepaal de tabelgrootte zodat u de conversiewerkzaamheden kunt plannen.

    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;

    Grotere tabellen duurt langer om te converteren. Controleer de tabellen en batchgeer het conversiewerk op prioriteit en op tabelgrootte om de vereiste onderhoudsvensters te plannen.

  5. Zet alle tabellen een voor een om in een dynamische indeling.

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

Opmaak databasetabelopslag converteren

U kunt tabellen op één knooppunt in uw cluster omzetten. De wijzigingen worden automatisch overgenomen in de andere serviceknoppen.

Het converteren van de opslagindeling is anders voor Adobe Commerce Starter- en Adobe Commerce Pro-projecten.

  • Voor Starter-architectuur gebruikt u de opdracht MySQL ALTER om de indeling om te zetten.
  • Op Pro-architectuur gebruikt u de opdrachten MySQL CREATE en SELECT om een databasetabel te maken met InnoDB -opslag en kopieert u de gegevens van de bestaande tabel naar de nieuwe tabel. Deze methode zorgt ervoor dat de wijzigingen worden gerepliceerd naar alle knooppunten in uw cluster.

zet lijstopslagformaat voor de projecten van Adobe Commerce Pro om

  1. Identificeer tabellen die MyISAM -opslag gebruiken.

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

  2. Zet alle tabellen één voor één om in de InnoDB -opslagindeling.

    • Wijzig de naam van de bestaande tabel om naamconflicten te voorkomen.

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

    • Maak een tabel die InnoDB -opslag gebruikt met de gegevens uit de bestaande tabel.

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

    • Controleer of de nieuwe tabel alle vereiste gegevens bevat.

    • Verwijder de oorspronkelijke tabel waarvan u de naam hebt gewijzigd.

zet lijstopslagformaat voor de projecten van de Aanzet van Adobe Commerce om

  1. Identificeer tabellen die MyISAM -opslag gebruiken.

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

  2. Tabellen die gebruikmaken van MyISAM -opslag converteren naar InnoDB -opslag.

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

De databaseconversie controleren

De dag vóór de geplande upgrade naar MariaDB-versie 10.3, 10.4 of 10.6 controleert u of alle tabellen de juiste rijindeling en opslagengine hebben. De controle wordt vereist omdat de code plaatsingen die nadat u de omzetting wordt gemaakt sommige lijsten zouden kunnen veroorzaken om aan hun originele configuratie worden teruggezet.

  1. Meld u aan bij uw database.

  2. Controleer of er tabellen zijn met de indeling COMPACT rij.

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

  3. Controleren op tabellen die nog steeds de opslagindeling MyISAM gebruiken

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

  4. Herhaal de stappen om de indeling van de tabelrij en de opslagengine te wijzigen als er tabellen zijn teruggezet.

De opslagengine wijzigen

Zie lijsten MyISAM in InnoDBomzetten.

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