ドキュメントCommerceインストールガイド

一般的な MySQL ガイドライン

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 経験者
  • 管理者
  • 開発者

サポートされている MySQL のバージョンについては、 システム要件を参照してください。

Adobe 強く では、データベースを設定する際に、次の標準に従うことをお勧めします。

  • Adobe Commerceでは、MySQL データベーストリガー を使用して、インデックス再作成中のデータベースアクセスを改善します。 これらは、インデクサーモードが「 スケジュール」に設定されている場合に作成されます。 カスタムトリガーは将来のAdobe Commerceとの互換性を失う可能性があるため、データベース内のカスタムトリガーはサポートされません。
  • 続行する前に MySQL のトリガーに関する潜在的な制限について確認してください。
  • データベースのセキュリティ体制を強化するには、STRICT_ALL_TABLES SQL モードを有効にして、不要なデータベース操作を引き起こす可能性のある無効なデータ値の保存を防ぎます。
  • Adobe Commerceでは、MySQL 文ベースのレプリケーションはサポート れていません。 必ず only 行ベースのレプリケーションを使用してください。
WARNING
Adobe Commerceは現在、トランザクション内で CREATE TEMPORARY TABLE ステートメントを使用しています。これは データベース実装と互換性がない、Google Cloud SQL 第 2 世代インスタンスなどの GTID ベースのレプリケーションを使用します。 Cloud SQL 8.0 用の MySQL を代替案として検討してください。
NOTE
Web サーバーとデータベースサーバーが異なるホスト上にある場合は、データベースサーバーホスト上でこのトピックで説明されているタスクを実行してから、 リモート MySQL データベース接続の設定を参照してください。

Ubuntu への MySQL のインストール

Adobe Commerce 2.4 には、MySQL 8.0 のクリーンインストールが必要です。以下のリンクに従って、お使いのマシンに MySQL をインストールする手順を確認してください。

多数の製品を読み込む場合は、デフォルトの 16 MB よりも大きい max_allowed_packet の値を増やすことができます。

NOTE
デフォルト値は、クラウドインフラストラクチャー上のAdobe Commerce およびオンプレミスのプロジェクト 適用されます。 Adobe Commerce on cloud infrastructure Pro をご利用のお客様は、max_allowed_packet の価値を高めるために、サポートチケットを開く必要があります。 Adobe Commerce on cloud infrastructure スターターを使用すると、/etc/mysql/mysql.cnf ファイルの設定を更新することで価値を高めることができます。

値を増やすには、/etc/mysql/mysql.cnf ファイルをテキストエディターで開き、max_allowed_packet の値を探します。 mysql.cnf ファイルへの変更を保存し、テキストエディターを閉じて、MySQL （service mysql restart）を再起動します。

オプションで設定した値を確認するには、mysql> のプロンプトで次のコマンドを入力します。

SHOW VARIABLES LIKE 'max_allowed_packet';

次に、 データベースインスタンスを設定します。

MySQL 8 の変更

Adobe Commerce 2.4 では、MySQL 8 がサポートされるようになりました。
この節では、開発者が認識しておくべき、MySQL 8 の主な変更点について説明します。

整数タイプ （パディング）の幅を削除

整数データ型（TINYINT、SMALLINT、MEDIUMINT、INT、BIGINT）の表示幅の仕様は、MySQL 8.0.17 で非推奨（廃止予定）となりました。出力にデータ型の定義を含むステートメントは、TINYINT （1）を除き、整数型の表示幅を表示しなくなりました。 MySQL コネクタは、TINYINT （1）列が BOOLEAN 列として生成されることを前提としています。 この例外により、ユーザーは引き続きその前提を立てることができます。

例

mysql 8.19 での admin_user について説明します。

フィールド
タイプ
ヌル
キー
デフォルト
追加
user_id
int unsigned
不可
PRI
NULL
auto_increment
firstname
varchar(32)
はい
NULL
lastname
varchar(32）
はい
NULL
email
varchar(128)
はい
NULL
username
varchar(40)
はい
UNI
NULL
password
varchar(255)
不可
NULL
created
timestamp
不可
CURRENT_TIMESTAMP
DEFAULT_GENERATED
modified
timestamp
不可
CURRENT_TIMESTAMP
DEFAULT_GENERATED on update CURRENT_TIMESTAMP
logdate
timestamp
はい
NULL
lognum
smallint unsigned
不可
0

TINYINT （1） を除き、すべての整数パディング （TINYINT > 1, SMALLINT, MEDIUMINT, INT, BIGINT）は db_schema.xml ファイルから削除する必要があります。

詳しくは、https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-19.html#mysqld-8-0-19-feature を参照してください。

デフォルトの並べ替え順

8.0 より前のエントリは、外部キーで並べ替えられていました。 デフォルトの並べ替え順は、使用するエンジンによって異なります。
コードが特定の並べ替えに依存している場合は、常に並べ替え順を指定します。

GROUP BY の非推奨の ASC 修飾子と DESC 修飾子

MySQL 8.0.13 以降、廃止された ASC 句または GROUP BY 句の DESC 修飾子は削除されました。 以前に GROUP BY の並べ替えに依存していたクエリが、以前の MySQL バージョンとは異なる結果になる場合があります。 指定した並べ替え順を生成するには、ORDER BY 句を指定します。

Commerceと MySQL 8

MySQL 8 を適切にサポートするために、Adobe Commerceにいくつかの変更が加えられました。

クエリと挿入の動作

Adobe Commerceは、/lib/internal/Magento/Framework/DB/Adapter/Pdo/Mysql.php:424. で SET SQL_MODE="を設定して、通常の検証動作を無効にしました。 検証が無効の場合、MySQL がデータを切り捨てる可能性があります。 MySQL では、クエリの動作が変更されました。Select * on my_table where IP='127.0.0.1' では、IP アドレスが整数ではなく文字列として正しく認識されるようになり、結果を返さなくなりました。

Mysql 5.7 から MySQL 8 へのアップグレード

MySQL をバージョン 5.7 からバージョン 8 に適切にアップデートするには、次の手順に従う必要があります。

  1. Adobe Commerceを 2.4.0 にアップグレードします。
    すべてをテストし、システムが期待どおりに動作することを確認します。

  2. メンテナンスモードを有効にする：

    code language-bash 
    bin/magento maintenance:enable

  3. データベースのバックアップを作成します。

    code language-bash 
    bin/magento setup:backup --db

  4. MySQL をバージョン 8 にアップデートします。

  5. バックアップしたデータを MySQL に読み込みます。

  6. キャッシュのクリーンアップ：

    code language-bash 
    bin/magento cache:clean

  7. メンテナンスモードを無効にする：

    code language-bash 
    bin/magento maintenance:disable

データベースインスタンスの設定

この節では、Adobe Commerceのデータベースインスタンスを作成する方法について説明します。 新しいデータベースインスタンスを使用することをお勧めしますが、既存のデータベースインスタンスを使用してAdobe Commerceをインストールすることもできます。

MySQL データベースインスタンスを設定するには、次の手順に従います。

  1. 任意のユーザーとしてデータベースサーバーにログインします。

  2. MySQL コマンドプロンプトに移動します。

    code language-bash 
    mysql -u root -p

  3. プロンプトが表示されたら、MySQL root ユーザーのパスワードを入力します。

  4. 次のコマンドを表示されている順序で入力して、magento という名前のデータベース・インスタンスをユーザー名 magento で作成します。

    code language-sql 
    create database magento;
    code language-sql 
    create user 'magento'@'localhost' IDENTIFIED BY 'magento';
    code language-sql 
    GRANT ALL ON magento.* TO 'magento'@'localhost';
    code language-sql 
    flush privileges;

  5. コマンドプロンプトを終了するには、exit と入力します。

  6. データベースを確認します。

    code language-bash 
    mysql -u magento -p

    MySQL モニターが表示された場合は、データベースが正しく作成されています。 エラーが表示された場合は、上記のコマンドを繰り返します。

  7. Web サーバーとデータベースサーバーが異なるホスト上にある場合は、データベースサーバーホスト上でこのトピックで説明されているタスクを実行してから、 リモート MySQL データベース接続の設定を参照してください。

    ビジネスに適したデータベースインスタンスを設定することをお勧めします。 データベースを設定する際は、次の点に注意してください。

    • インデクサーには、より高い tmp_table_size と max_heap_table_size の値（例：64 M）が必要です。 batch_size パラメーターを設定すると、インデクサーのパフォーマンスを向上させるために、テーブルサイズの設定と共にその値を調整できます。 詳しくは、『 最適化ガイドを参照してください。

    • 最適なパフォーマンスを得るには、すべての MySQL およびAdobe Commerce インデックステーブルをメモリに保持できるようにします（例：innodb_buffer_pool_size を設定）。

    • MariaDB 10.4 でのインデックス再作成は、他の MariaDB または MySQL バージョンに比べて時間がかかります。 設定のベストプラクティスを参照してください。

  8. MySQL TIMESTAMP フィールドがアプリケーションの宣言型スキーマアーキテクチャが想定する環境設定および構成に従うようにするには、システム変数 explicit_defaults_for_timestamp を on に設定する必要があります。

    参照：

    この設定が有効になっていない場合、bin/magento setup:db:status は常に Declarative Schema is not up to date を報告します。

NOTE
explicit_defaults_for_timestamp 設定は非推奨（廃止予定）です。 この設定は、今後の MySQL リリースで削除される非推奨の TIMESTAMP 動作を制御します。 これらの動作を削除すると、explicit_defaults_for_timestamp 設定も削除されます。
WARNING
クラウドインフラストラクチャプロジェクト上のAdobe Commerceの場合、MySQL （MariaDB）の explicit_defaults_for_timestamp 設定はデフォルトで オフ になっています。

MariaDB 10.4 および 10.6 でのインデックス再作成は、以前のバージョンの MariaDB または MySQL と比較して時間がかかります。 インデックス再作成を高速化するには、次の MariaDB 設定パラメーターを設定することをお勧めします。

MariaDB 10.6 にアップグレードした後、インデックス作成に関係なくパフォーマンスが低下する場合は、--query-cache-type 設定を有効にすることを検討してください。 例：--query-cache-type=ON。

クラウドインフラストラクチャプロジェクトでAdobe Commerceをアップグレードする前に、MariaDB をアップグレードする必要がある場合もあります（MariaDB のアップグレードのベストプラクティスを参照）。

例：

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

これらの推奨事項に加えて、次のパラメータの設定についてはデータベース管理者に問い合わせてください。

NOTE
これらの設定は、オンプレミスのデプロイメントでのみ使用できます。 クラウドインフラストラクチャー上のAdobe Commerceのユーザーは、これらの設定にアクセスできません。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995