protocol_compression_algorithms システム変数は、サーバーが受信接続に対して許可する圧縮アルゴリズムを構成します。

--compression-algorithms および --zstd-compression-level のコマンドラインオプションは、これらのクライアントプログラムに許可される圧縮アルゴリズムおよび zstd 圧縮レベルを構成: mysql, mysqladmin, mysqlbinlog, mysqlcheck, mysqldump, mysqlimport, mysqlpump, mysqlshow, mysqlslap、mysqltest、および mysql_upgrade。MySQL Shell には、8.0.20 リリースの次のコマンドラインオプションも用意されています。

mysql_options() 関数の MYSQL_OPT_COMPRESSION_ALGORITHMS および MYSQL_OPT_ZSTD_COMPRESSION_LEVEL オプションでは、MySQL C API を使用するクライアントプログラムの許可された圧縮アルゴリズムおよび zstd 圧縮レベルを構成します。

CHANGE MASTER TO ステートメントの MASTER_COMPRESSION_ALGORITHMS および MASTER_ZSTD_COMPRESSION_LEVEL オプションでは、ソース/レプリカレプリケーションに参加するレプリカサーバーの許可された圧縮アルゴリズムおよび zstd 圧縮レベルを構成します。 MySQL 8.0.23 から、かわりにステートメント CHANGE REPLICATION SOURCE TO およびオプション SOURCE_COMPRESSION_ALGORITHMS と SOURCE_ZSTD_COMPRESSION_LEVEL を使用します。

group_replication_recovery_compression_algorithm および group_replication_recovery_zstd_compression_level システム変数は、新しいメンバーがグループに参加してドナーに接続したときに、グループレプリケーションリカバリ接続に対して許可される圧縮アルゴリズムおよび zstd 圧縮レベルを構成します。

zlib: zlib 圧縮アルゴリズムを使用する接続を許可します。

zstd: zstd 圧縮アルゴリズム (zstd 1.3) を使用する接続を許可します。

uncompressed: 圧縮解除された接続を許可します。

サーバーが受信接続に対して許可する圧縮アルゴリズムを構成するには、protocol_compression_algorithms システム変数を設定します。 デフォルトでは、サーバーは使用可能なすべてのアルゴリズムを許可します。 起動時にこの設定を明示的に構成するには、サーバー my.cnf ファイルで次の行を使用します:

[mysqld]
protocol_compression_algorithms=zlib,zstd,uncompressed

実行時に protocol_compression_algorithms システム変数を設定してその値に永続化するには、次のステートメントを使用します:

SET PERSIST protocol_compression_algorithms='zlib,zstd,uncompressed';

SET PERSIST は、実行中の MySQL インスタンスの値を設定します。 また、値が保存され、その後のサーバーの再起動に引き継がれます。 後続の再起動に引き継ぐことなく、実行中の MySQL インスタンスの値を変更するには、PERSIST ではなく GLOBAL キーワードを使用します。 セクション13.7.6.1「変数代入の SET 構文」を参照してください。

zstd 圧縮を使用する着信接続のみを許可するには、起動時に次のようにサーバーを構成します:

[mysqld]
protocol_compression_algorithms=zstd

または、実行時に変更を行うには:

SET PERSIST protocol_compression_algorithms='zstd';

mysql クライアントが zlib または uncompressed 接続を開始できるようにするには、次のように呼び出します:

mysql --compression-algorithms=zlib,uncompressed

zlib または zstd 接続を使用して、zstd 接続用に圧縮レベル 7 でソースに接続するようにレプリカを構成するには、CHANGE REPLICATION SOURCE TO ステートメント (MySQL 8.0.23 から) または CHANGE MASTER TO ステートメント (MySQL 8.0.23 より前) を使用します:

CHANGE REPLICATION SOURCE TO
  SOURCE_COMPRESSION_ALGORITHMS = 'zlib,zstd',
  SOURCE_ZSTD_COMPRESSION_LEVEL = 7;

これは、レガシー接続圧縮の構成 で説明されている理由で、slave_compressed_protocol システム変数が無効になっていることを前提としています。

クライアントプログラムでは、サーバーへの接続に圧縮の使用を指定する --compress コマンドラインオプションがサポートされています。

MySQL C API を使用するプログラムの場合、mysql_options() 関数の MYSQL_OPT_COMPRESS オプションを有効にすると、サーバーへの接続に圧縮を使用するように指定されます。

ソース/レプリカレプリケーションの場合、slave_compressed_protocol システム変数を有効にすると、ソースへのレプリカ接続に圧縮の使用が指定されます。

レガシー --compress オプションの意味は、--compression-algorithms が指定されているかどうかによって異なります:

レガシー MYSQL_OPT_COMPRESS オプションと mysql_options() C API 関数の MYSQL_OPT_COMPRESSION_ALGORITHMS オプションの間では、同じタイプの相互作用が発生します。

slave_compressed_protocol システム変数が有効になっている場合、MASTER_COMPRESSION_ALGORITHMS よりも優先され、ソースとレプリカの両方でそのアルゴリズムが許可されている場合は、ソースへの接続で zlib 圧縮が使用されます。 slave_compressed_protocol が無効な場合は、MASTER_COMPRESSION_ALGORITHMS の値が適用されます。

クライアント接続に使用されている圧縮を監視するには、Compression_algorithm および Compression_level のステータス変数を使用します。 現在の接続の場合、その値はそれぞれ圧縮アルゴリズムと圧縮レベルを示します。

サーバーが着信接続を許可するように構成されている圧縮アルゴリズムを判別するには、protocol_compression_algorithms システム変数を確認します。

ソース/レプリカレプリケーション接続の場合、構成済の圧縮アルゴリズムおよび圧縮レベルは複数のソースから使用できます: