DocumentaçãoCommerceManual de implementação

Pré-requisitos de atualização para o MariaDB

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

Criado para:

  • Experienced
  • Developer

Antes de atualizar o Adobe Commerce na infraestrutura em nuvem, talvez você também precise atualizar seu software de banco de dados se estiver usando o MariaDB. Por exemplo:

  • Adobe Commerce 2.4.6 com MariaDB versão 10.5.1 ou superior
  • Adobe Commerce 2.3.5 com MariaDB versão 10.3 ou anterior

Adobe Commerce 2.4.6

A partir do MariaDB 10.5.1, as colunas com formatos temporais antigos são marcadas com um /* mariadb-5.3 */ comentário na saída do SHOW CREATE TABLE, SHOW COLUMNS, DESCRIBE declarações, bem como na COLUMN_TYPE coluna da INFORMATION_SCHEMA.COLUMNS tabela. Consulte a documentação do MariaDB.

O Adobe Commerce não pode mapear as colunas de data para um tipo de dados adequado devido ao comentário MariaDB, o que pode causar um comportamento inesperado no código personalizado.

Para evitar um comportamento inesperado ao atualizar o MariaDB de versões anteriores para a versão 10.6, o Adobe recomenda migrar as colunas para o novo formato interno.

Configuração padrão

No MariaDB 10.1.2, um novo formato temporal foi introduzido a partir do MySQL 5.6. A variável mysql56_temporal_format A variável de sistema permite que o banco de dados converta automaticamente o formato de data antigo para o novo quando uma tabela alterada é executada ou o banco de dados é importado. A configuração padrão para mysql56_temporal_format O está sempre ativado no Adobe Commerce na infraestrutura em nuvem.

Migrar colunas de data

A consulta a seguir mostra a tabela e as colunas afetadas que devem ser migradas após a atualização do MariaDB para 10.5.1 ou posterior:

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

A migração das colunas para o novo formato de data interno requer a reimportação do banco de dados ou a execução de alter na coluna identificada com a mesma definição de coluna. A consulta a seguir gera as consultas alter necessárias:

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
É importante migrar as colunas para o novo formato de data interno antes implantar o novo código para evitar um comportamento inesperado.

Adobe Commerce 2.3.5

Atualização do serviço MariaDB na infraestrutura em nuvem da versão 10.0 ou 10.2 para a versão 10.3, 10.4 ou 10.5. A versão 10.3 e posterior da MariaDB exige que o banco de dados use o formato de linha de tabela dinâmica, e a Adobe Commerce exige o uso do mecanismo de armazenamento InnoDB para tabelas. Este artigo explica como atualizar seu banco de dados para cumprir esses requisitos do MariaDB.

Depois de preparar o banco de dados, envie um tíquete de suporte do Adobe Commerce para atualizar a versão do serviço MariaDB na infraestrutura de nuvem antes de prosseguir com o processo de atualização do Adobe Commerce.

Preparar seu banco de dados para a atualização

Antes que a equipe de Suporte da Adobe Commerce inicie o processo de atualização, prepare o banco de dados convertendo as tabelas do banco de dados:

  • Converter o formato de linha de COMPACT para DYNAMIC
  • Altere o mecanismo de armazenamento de MyISAM para InnoDB

Lembre-se das seguintes considerações ao planejar e agendar a conversão:

  • Conversão de COMPACT para DYNAMIC as tabelas podem levar várias horas com um banco de dados grande.

  • Para evitar a corrupção de dados, não conclua o trabalho de conversão em um site ativo.

  • Conclua o trabalho de conversão durante um período de tráfego baixo no site.

  • Mudar seu site para modo de manutenção antes de executar os comandos para converter tabelas de banco de dados.

Converter formato de linha da tabela do banco de dados

Você pode converter tabelas em um nó no cluster. As alterações são replicadas automaticamente para os outros nós de serviço.

  1. No ambiente de infraestrutura em nuvem do Adobe Commerce, use o SSH para se conectar ao nó 1.

  2. Faça logon no MariaDB.

  3. Identifique as tabelas a serem convertidas do formato compacto para o dinâmico.

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

  4. Determine os tamanhos da tabela para poder agendar o trabalho de conversão.

    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;

    Tabelas maiores demoram mais para serem convertidas. Revise as tabelas e coloque o trabalho de conversão em lote por prioridade e tamanho da tabela para ajudar a planejar as janelas de manutenção necessárias.

  5. Converter todas as tabelas em formato dinâmico, uma de cada vez.

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

Converter formato de armazenamento de tabela de banco de dados

Você pode converter tabelas em um nó no cluster. As alterações são replicadas automaticamente para os outros nós de serviço.

O processo para converter o formato de armazenamento é diferente para projetos do Adobe Commerce Starter e do Adobe Commerce Pro.

  • Para arquitetura de Início, use o MySQL ALTER para converter o formato.
  • Na arquitetura Pro, use o MySQL CREATE e SELECT comandos para criar uma tabela de banco de dados com InnoDB armazenar e copiar os dados da tabela existente na nova tabela. Esse método garante que as alterações sejam replicadas em todos os nós do cluster.

Converter formato de armazenamento de tabela para projetos do Adobe Commerce Pro

  1. Identificar tabelas que usam MyISAM armazenamento.

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

  2. Converter todas as tabelas em InnoDB formato de armazenamento, um de cada vez.

    • Renomeie a tabela existente para evitar conflitos de nome.

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

    • Criar uma tabela que use InnoDB armazenamento usando os dados da tabela existente.

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

    • Verifique se a nova tabela tem todos os dados necessários.

    • Exclua a tabela original que você renomeou.

Converter formato de armazenamento de tabela para projetos do Adobe Commerce Starter

  1. Identificar tabelas que usam MyISAM armazenamento.

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

  2. Converter tabelas que usam MyISAM armazenamento para InnoDB armazenamento.

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

Verifique a conversão do banco de dados

No dia anterior à atualização programada para o MariaDB versão 10.3, 10.4 ou 10.6, verifique se todas as tabelas têm o formato de linha e o mecanismo de armazenamento corretos. A verificação é necessária porque as implantações de código feitas após a conclusão da conversão podem fazer com que algumas tabelas sejam revertidas para a configuração original.

  1. Faça logon no banco de dados.

  2. Verifique se há tabelas que ainda tenham o COMPACT formato da linha.

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

  3. Verifique se há tabelas que ainda usam o MyISAM formato de armazenamento

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

  4. Se alguma tabela tiver sido revertida, repita as etapas para alterar o formato da linha da tabela e o mecanismo de armazenamento.

Alterar o mecanismo de armazenamento

Consulte Converter tabelas MyISAM em InnoDB.

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