ドキュメントCommerce実装プレイブック

MariaDB のアップグレードの前提条件

Last update: Thu May 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Experienced
  • Developer

MariaDB を使用している場合は、クラウドインフラストラクチャー上のAdobe Commerceをアップグレードする前に、データベースソフトウェアをアップグレードする必要がある場合もあります。 例：

  • Adobe Commerce 2.4.6 （MariaDB バージョン 10.5.1 以降）
  • Adobe Commerce 2.3.5 と MariaDB バージョン 10.3 以前

Adobe Commerce 2.4.6

MariaDB 10.5.1 以降、古い時間形式の列はでマークされます /* mariadb-5.3 */ の出力にコメントがあります SHOW CREATE TABLE, SHOW COLUMNS, DESCRIBE ステートメント、および COLUMN_TYPE の列 INFORMATION_SCHEMA.COLUMNS テーブル。 MariaDB のドキュメントを参照してください.

MariaDB コメントが原因で、Adobe Commerceが日付列を適切なデータタイプにマッピングできず、カスタムコードで予期しない動作が起こる可能性があります。

MariaDB を旧バージョンからバージョン 10.6 にアップグレードする際の予期しない動作を避けるために、Adobeでは列を新しい内部フォーマットに移行することをお勧めします。

デフォルトの設定

MariaDB 10.1.2 では、MySQL 5.6 から新しい時間形式が導入されました。この mysql56_temporal_format システム変数を使用すると、alter table の実行時またはデータベースのインポート時に、データベースで古い日付形式を新しい日付形式に自動的に変換できます。 のデフォルト設定 mysql56_temporal_format は、クラウドインフラストラクチャー上のAdobe Commerceで常に有効になっています。

日付列を移行

次のクエリは、MariaDB を 10.5.1 以降にアップグレードした後に移行する必要がある、影響を受けるテーブルと列を示しています。

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

列を新しい内部日付形式に移行するには、データベースを再インポートするか、同じ列定義で識別された列で alter を実行する必要があります。 次のクエリは、必要な変更クエリを生成します。

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
列を新しい内部日付形式に移行することが重要です 次の前 予期しない動作を避けるために、新しいコードをデプロイする。

Adobe Commerce 2.3.5

クラウドインフラストラクチャー上の MariaDB サービスをバージョン 10.0 または 10.2 からバージョン 10.3、10.4 または 10.5 にアップグレードします。MariaDB バージョン 10.3 以降では、動的テーブル行形式を使用するようにデータベースを必要とし、Adobe Commerceでは、テーブル用に InnoDB ストレージエンジンを使用する必要があります。 この記事では、これらの MariaDB 要件に準拠するようにデータベースを更新する方法について説明します。

データベースを準備したら、Adobe Commerceのアップグレードプロセスに進む前に、Adobe Commerce サポートチケットを送信して、クラウドインフラストラクチャ上の MariaDB サービスバージョンを更新します。

アップグレード用にデータベースを準備

Adobe Commerce サポートチームがアップグレードプロセスを開始する前に、データベーステーブルを変換してデータベースを準備します。

  • 行形式を次のように変換します COMPACT 対象： DYNAMIC
  • ストレージエンジンの変更元 MyISAM 対象： InnoDB

コンバージョンを計画およびスケジュールする際は、次の点に注意してください。

  • 変換元 COMPACT 対象： DYNAMIC 大規模なデータベースでは、テーブルに数時間かかる場合があります。

  • データの破損を防ぐには、ライブサイトでコンバージョン作業を完了しないようにします。

  • サイトのトラフィックが少ない時間帯にコンバージョン作業を完了します。

  • サイトの切り替え先 メンテナンスモード データベース テーブルを変換するコマンドを実行する前に。

データベース テーブル行の形式を変換する

クラスター内の 1 つのノードでテーブルを変換できます。 変更内容は、他のサービスノードに自動的にレプリケートされます。

  1. クラウドインフラストラクチャー上のAdobe Commerceから、SSH を使用して Node 1 に接続します。

  2. MariaDB にログインします。

  3. コンパクト形式から動的形式に変換するテーブルを特定します。

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

  4. 変換作業をスケジュールできるように、テーブルサイズを決定します。

    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;

    テーブルが大きいと、変換に時間がかかります。 テーブルをレビューし、優先度別およびテーブルサイズ別に変換作業をバッチ化して、必要なメンテナンスウィンドウを計画するのに役立ちます。

  5. すべてのテーブルを 1 つずつ動的形式に変換します。

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

データベーステーブルのストレージ形式の変換

クラスター内の 1 つのノードでテーブルを変換できます。 変更内容は、他のサービスノードに自動的にレプリケートされます。

ストレージ形式を変換するプロセスは、Adobe Commerce Starter とAdobe Commerce Pro プロジェクトで異なります。

  • スターターアーキテクチャの場合は、MySQL を使用します ALTER 形式を変換するコマンド。
  • Pro アーキテクチャでは、MySQL を使用します。 CREATE および SELECT を使用してデータベーステーブルを作成するコマンド InnoDB 既存のテーブルから新しいテーブルにデータを保存してコピーします。 この方法では、変更がクラスター内のすべてのノードに確実にレプリケートされます。

Adobe Commerce Pro プロジェクトのテーブルストレージフォーマットの変換

  1. を使用するテーブルの特定 MyISAM ストレージ。

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

  2. すべてのテーブルを次に変換 InnoDB ストレージフォーマットは一度に 1 つずつ。

    • 名前の競合を防ぐために、既存のテーブルの名前を変更します。

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

    • を使用するテーブルの作成 InnoDB 既存のテーブルのデータを使用したストレージ。

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

    • 新しいテーブルに必要なデータがすべて含まれていることを確認します。

    • 名前を変更した元のテーブルを削除します。

Adobe Commerce スタータープロジェクトのテーブルストレージ形式の変換

  1. を使用するテーブルの特定 MyISAM ストレージ。

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

  2. を使用するテーブルを変換する MyISAM ストレージ先 InnoDB ストレージ。

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

データベース変換の検証

MariaDB バージョン 10.3、10.4、または 10.6 への予定アップグレードの前日に、すべてのテーブルのロー形式とストレージ・エンジンが正しいことを確認します。 検証が必要なのは、変換が完了した後にコードのデプロイメントを行うと、一部のテーブルが元の設定に戻る場合があるためです。

  1. データベースにログインします。

  2. テーブルに次の情報が残っているかどうかを確認します COMPACT 行の形式。

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

  3. テーブルで引き続き「」を使用しているかどうかを確認します。 MyISAM ストレージ形式

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

  4. テーブルが元に戻された場合は、手順を繰り返してテーブル行の形式とストレージエンジンを変更します。

ストレージエンジンの変更

参照： MyISAM テーブルを InnoDB に変換する.

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