MySQL 8.0 リファレンスマニュアル


MySQL 8.0 リファレンスマニュアル  /  MySQL パフォーマンススキーマ  /  パフォーマンススキーマシステム変数

27.15 パフォーマンススキーマシステム変数

パフォーマンススキーマは、構成情報を提供するいくつかのシステム変数を実装しています。

mysql> SHOW VARIABLES LIKE 'perf%';
+----------------------------------------------------------+-------+
| Variable_name                                            | Value |
+----------------------------------------------------------+-------+
| performance_schema                                       | ON    |
| performance_schema_accounts_size                         | -1    |
| performance_schema_digests_size                          | 10000 |
| performance_schema_events_stages_history_long_size       | 10000 |
| performance_schema_events_stages_history_size            | 10    |
| performance_schema_events_statements_history_long_size   | 10000 |
| performance_schema_events_statements_history_size        | 10    |
| performance_schema_events_transactions_history_long_size | 10000 |
| performance_schema_events_transactions_history_size      | 10    |
| performance_schema_events_waits_history_long_size        | 10000 |
| performance_schema_events_waits_history_size             | 10    |
| performance_schema_hosts_size                            | -1    |
| performance_schema_max_cond_classes                      | 80    |
| performance_schema_max_cond_instances                    | -1    |
| performance_schema_max_digest_length                     | 1024  |
| performance_schema_max_file_classes                      | 50    |
| performance_schema_max_file_handles                      | 32768 |
| performance_schema_max_file_instances                    | -1    |
| performance_schema_max_index_stat                        | -1    |
| performance_schema_max_memory_classes                    | 320   |
| performance_schema_max_metadata_locks                    | -1    |
| performance_schema_max_mutex_classes                     | 220   |
| performance_schema_max_mutex_instances                   | -1    |
| performance_schema_max_prepared_statements_instances     | -1    |
| performance_schema_max_program_instances                 | -1    |
| performance_schema_max_rwlock_classes                    | 40    |
| performance_schema_max_rwlock_instances                  | -1    |
| performance_schema_max_socket_classes                    | 10    |
| performance_schema_max_socket_instances                  | -1    |
| performance_schema_max_sql_text_length                   | 1024  |
| performance_schema_max_stage_classes                     | 150   |
| performance_schema_max_statement_classes                 | 192   |
| performance_schema_max_statement_stack                   | 10    |
| performance_schema_max_table_handles                     | -1    |
| performance_schema_max_table_instances                   | -1    |
| performance_schema_max_table_lock_stat                   | -1    |
| performance_schema_max_thread_classes                    | 50    |
| performance_schema_max_thread_instances                  | -1    |
| performance_schema_session_connect_attrs_size            | 512   |
| performance_schema_setup_actors_size                     | -1    |
| performance_schema_setup_objects_size                    | -1    |
| performance_schema_users_size                            | -1    |
+----------------------------------------------------------+-------+

パフォーマンススキーマシステム変数は、コマンド行またはオプションファイルでサーバーの起動時に設定でき、多くは実行時に設定できます。 セクション27.13「パフォーマンススキーマオプションおよび変数リファレンス」を参照してください。

パフォーマンススキーマは、明示的に設定されていない場合、サーバーの起動時にいくつかのパラメータの値のサイズを自動的に設定します。 詳細については、セクション27.3「パフォーマンススキーマ起動構成」を参照してください。

パフォーマンススキーマシステム変数には次の意味があります。

  • performance_schema

    コマンド行形式 --performance-schema[={OFF|ON}]
    システム変数 performance_schema
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Boolean
    デフォルト値 ON

    この変数の値は ON または OFF で、パフォーマンススキーマが有効にされているかどうかを示します。 デフォルト値は ON です。 サーバーの起動時に、この変数を値なし、またはそれを有効にする ON または 1 の値、またはそれを無効にする OFF または 0 の値で指定できます。

    パフォーマンススキーマが無効になっていても、引き続き global_variables, session_variables, global_status および session_status テーブルにデータが移入されます。 これは、必要に応じて、SHOW VARIABLES および SHOW STATUS ステートメントの結果をこれらのテーブルから取得できるようにするために発生します。 また、パフォーマンススキーマは、一部のレプリケーションテーブルが無効になっている場合はそれらのテーブルにデータを移入します。

  • performance_schema_accounts_size

    コマンド行形式 --performance-schema-accounts-size=#
    システム変数 performance_schema_accounts_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)
    最小値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)
    最大値 1048576

    accounts テーブルの行数。 この変数が 0 の場合、パフォーマンススキーマは accounts テーブル内の接続統計情報または status_by_account テーブル内のステータス変数情報を保持しません。

  • performance_schema_digests_size

    コマンド行形式 --performance-schema-digests-size=#
    システム変数 performance_schema_digests_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)
    最小値 -1
    最大値 1048576

    events_statements_summary_by_digest テーブル内の最大行数。 この最大を超えたため、ダイジェストをインストゥルメントできない場合、パフォーマンススキーマは Performance_schema_digest_lost ステータス変数を増分します。

    ステートメントダイジェストの詳細については、セクション27.10「パフォーマンススキーマのステートメントダイジェストとサンプリング」を参照してください。

  • performance_schema_error_size

    コマンド行形式 --performance-schema-error-size=#
    システム変数 performance_schema_error_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 number of server error codes
    最小値 0
    最大値 1048576

    インストゥルメントされたサーバーエラーコードの数。 デフォルト値は、サーバーエラーコードの実際の数です。 値は 0 から最大までの任意の場所に設定できますが、使用目的はデフォルト (すべてのエラーを計測する) または 0 (エラーを計測しない) に設定することです。

    エラー情報はサマリーテーブルに集約されます。セクション27.12.18.11「エラー要約テーブル」 を参照してください。 インストゥルメントされていないエラーが発生した場合、発生した情報は各サマリーテーブルの NULL 行、つまり ERROR_NUMBER=0ERROR_NAME=NULL および SQLSTATE=NULL のある行に集計されます。

  • performance_schema_events_stages_history_long_size

    コマンド行形式 --performance-schema-events-stages-history-long-size=#
    システム変数 performance_schema_events_stages_history_long_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_stages_history_long テーブルの行数。

  • performance_schema_events_stages_history_size

    コマンド行形式 --performance-schema-events-stages-history-size=#
    システム変数 performance_schema_events_stages_history_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_stages_history テーブルのスレッドあたりの行数。

  • performance_schema_events_statements_history_long_size

    コマンド行形式 --performance-schema-events-statements-history-long-size=#
    システム変数 performance_schema_events_statements_history_long_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_statements_history_long テーブル内の行数。

  • performance_schema_events_statements_history_size

    コマンド行形式 --performance-schema-events-statements-history-size=#
    システム変数 performance_schema_events_statements_history_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_statements_history テーブル内のスレッドあたりの行数。

  • performance_schema_events_transactions_history_long_size

    コマンド行形式 --performance-schema-events-transactions-history-long-size=#
    システム変数 performance_schema_events_transactions_history_long_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_transactions_history_long テーブルの行数。

  • performance_schema_events_transactions_history_size

    コマンド行形式 --performance-schema-events-transactions-history-size=#
    システム変数 performance_schema_events_transactions_history_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_transactions_history テーブルのスレッド当たりの行数。

  • performance_schema_events_waits_history_long_size

    コマンド行形式 --performance-schema-events-waits-history-long-size=#
    システム変数 performance_schema_events_waits_history_long_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_waits_history_long テーブル内の行数。

  • performance_schema_events_waits_history_size

    コマンド行形式 --performance-schema-events-waits-history-size=#
    システム変数 performance_schema_events_waits_history_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    events_waits_history テーブル内のスレッドあたりの行数。

  • performance_schema_hosts_size

    コマンド行形式 --performance-schema-hosts-size=#
    システム変数 performance_schema_hosts_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)
    最小値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)
    最大値 1048576

    hosts テーブル内の行数。 この変数が 0 の場合、パフォーマンススキーマは hosts テーブル内の接続統計情報または status_by_host テーブル内のステータス変数情報を保持しません。

  • performance_schema_max_cond_classes

    コマンド行形式 --performance-schema-max-cond-classes=#
    システム変数 performance_schema_max_cond_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 (≥ 8.0.13) 100
    デフォルト値 (≤ 8.0.12) 80
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    条件インストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_cond_instances

    コマンド行形式 --performance-schema-max-cond-instances=#
    システム変数 performance_schema_max_cond_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされた条件オブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_digest_length

    コマンド行形式 --performance-schema-max-digest-length=#
    システム変数 performance_schema_max_digest_length
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 1024
    最小値 0
    最大値 1048576

    パフォーマンススキーマ内の正規化されたステートメントダイジェスト値を計算するためにステートメントごとに予約されるメモリーの最大バイト数。 この変数は max_digest_length に関連しています。セクション5.1.8「サーバーシステム変数」 でその変数の説明を参照してください。

    メモリー使用に関する考慮事項など、ステートメントダイジェストの詳細は、セクション27.10「パフォーマンススキーマのステートメントダイジェストとサンプリング」 を参照してください。

  • performance_schema_max_digest_sample_age

    コマンド行形式 --performance-schema-max-digest-sample-age=#
    システム変数 performance_schema_max_digest_sample_age
    スコープ グローバル
    動的 はい
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 60
    最小値 0
    最大値 1048576

    この変数は、events_statements_summary_by_digest テーブルのステートメントサンプリングに影響します。 新しいテーブル行が挿入されると、行ダイジェスト値を生成したステートメントは、ダイジェストに関連付けられた現在のサンプルステートメントとして格納されます。 その後、同じダイジェスト値を持つほかのステートメントがサーバーに表示されるときに、新しいステートメントを使用して現在のサンプルステートメントを置き換えるかどうか (つまり、再サンプリングするかどうか) を決定します。 リサンプリングポリシーは、現在のサンプルステートメントと新しいステートメントの比較待機時間、およびオプションで現在のサンプルステートメントの経過時間に基づきます:

    • 待機時間に基づくリサンプリング: 新しいステートメントの待機時間が現在のサンプルステートメントの待機時間よりも長い場合は、現在のサンプルステートメントになります。

    • 年齢に基づくリサンプリング: performance_schema_max_digest_sample_age システム変数の値がゼロより大きく、現在のサンプルステートメントが何秒以上経過している場合、現在のステートメントは「古すぎます」とみなされ、新しいステートメントで置き換えられます。 これは、新しいステートメントの待機時間が現在のサンプルステートメントの待機時間より短い場合でも発生します。

    ステートメントサンプリングの詳細は、セクション27.10「パフォーマンススキーマのステートメントダイジェストとサンプリング」 を参照してください。

  • performance_schema_max_file_classes

    コマンド行形式 --performance-schema-max-file-classes=#
    システム変数 performance_schema_max_file_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 80
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    ファイルインストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_file_handles

    コマンド行形式 --performance-schema-max-file-handles=#
    システム変数 performance_schema_max_file_handles
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 32768

    オープンしているファイルオブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

    performance_schema_max_file_handles の値は、open_files_limit の値より大きくしてください。open_files_limit は、サーバーがサポート可能なオープンファイルハンドルの最大数に影響し、performance_schema_max_file_handles はこれらのファイルハンドルのうちインストゥルメント可能な数に影響します。

  • performance_schema_max_file_instances

    コマンド行形式 --performance-schema-max-file-instances=#
    システム変数 performance_schema_max_file_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされるファイルオブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_index_stat

    コマンド行形式 --performance-schema-max-index-stat=#
    システム変数 performance_schema_max_index_stat
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    パフォーマンススキーマが統計情報を保持するインデックスの最大数。 インデックス統計が失われるようにこの最大値を超えると、パフォーマンススキーマは Performance_schema_index_stat_lost ステータス変数を増分します。 デフォルト値は、performance_schema_max_table_instances の値を使用して自動サイズ設定されます。

  • performance_schema_max_memory_classes

    コマンド行形式 --performance-schema-max-memory-classes=#
    システム変数 performance_schema_max_memory_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 450

    メモリーインストゥルメントの最大数 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_metadata_locks

    コマンド行形式 --performance-schema-max-metadata-locks=#
    システム変数 performance_schema_max_metadata_locks
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    メタデータロックインストゥルメントの最大数。 この値は、metadata_locks テーブルのサイズを制御します。 メタデータロックを計測できないようにこの最大値を超えると、パフォーマンススキーマは Performance_schema_metadata_lock_lost ステータス変数を増分します。

  • performance_schema_max_mutex_classes

    コマンド行形式 --performance-schema-max-mutex-classes=#
    システム変数 performance_schema_max_mutex_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 (≥ 8.0.12) 300
    デフォルト値 (8.0.11) 250
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    相互排他ロックインストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_mutex_instances

    コマンド行形式 --performance-schema-max-mutex-instances=#
    システム変数 performance_schema_max_mutex_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされる相互排他ロックオブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_prepared_statements_instances

    コマンド行形式 --performance-schema-max-prepared-statements-instances=#
    システム変数 performance_schema_max_prepared_statements_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    prepared_statements_instances テーブルの最大行数。 プリペアドステートメントを計測できないようにこの最大値を超えると、パフォーマンススキーマは Performance_schema_prepared_statements_lost ステータス変数を増分します。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

    この変数のデフォルト値は、max_prepared_stmt_count システム変数の値に基づいて自動サイズ設定されます。

  • performance_schema_max_rwlock_classes

    コマンド行形式 --performance-schema-max-rwlock-classes=#
    システム変数 performance_schema_max_rwlock_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 60
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    rwlock インストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_program_instances

    コマンド行形式 --performance-schema-max-program-instances=#
    システム変数 performance_schema_max_program_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    パフォーマンススキーマが統計情報を保持するストアドプログラムの最大数。 この最大値を超えると、パフォーマンススキーマは Performance_schema_program_lost ステータス変数を増分します。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_rwlock_instances

    コマンド行形式 --performance-schema-max-rwlock-instances=#
    システム変数 performance_schema_max_rwlock_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされる rwlock オブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_socket_classes

    コマンド行形式 --performance-schema-max-socket-classes=#
    システム変数 performance_schema_max_socket_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 10
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    ソケットインストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_socket_instances

    コマンド行形式 --performance-schema-max-socket-instances=#
    システム変数 performance_schema_max_socket_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされるソケットオブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_sql_text_length

    コマンド行形式 --performance-schema-max-sql-text-length=#
    システム変数 performance_schema_max_sql_text_length
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 1024
    最小値 0
    最大値 1048576

    SQL ステートメントの格納に使用される最大バイト数。 この値は、次のカラムに必要な記憶域に適用されます:

    • events_statements_currentevents_statements_history および events_statements_history_long ステートメントイベントテーブルの SQL_TEXT カラム。

    • events_statements_summary_by_digest サマリーテーブルの QUERY_SAMPLE_TEXT カラム。

    performance_schema_max_sql_text_length を超えるバイトは破棄され、カラムには表示されません。 カラム内の初期バイト数が多くなった後にのみ異なるステートメントは区別できません。

    performance_schema_max_sql_text_length 値を減らすとメモリー使用量は減少しますが、末尾のみが異なる場合は、より多くのステートメントが区別できなくなります。 値を大きくするとメモリー使用量が増加しますが、長いステートメントを区別できます。

  • performance_schema_max_stage_classes

    コマンド行形式 --performance-schema-max-stage-classes=#
    システム変数 performance_schema_max_stage_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 (≥ 8.0.13) 175
    デフォルト値 (≤ 8.0.12) 150
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    ステージインストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_statement_classes

    コマンド行形式 --performance-schema-max-statement-classes=#
    システム変数 performance_schema_max_statement_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    ステートメントインストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

    デフォルト値は、サーバー構築時に、クライアント/サーバープロトコルのコマンド数とサーバーでサポートされる SQL ステートメントの種類の数に基づいて計算されます。

    この変数は、それを 0 に設定して、すべてのステートメントインストゥルメンテーションを無効にし、それに関連付けられているすべてのメモリーを節約しないかぎり、変更するべきではありません。 変数をデフォルトでない 0 以外の値に設定してもメリットはありません。特にデフォルトより大きい値は、必要以上のメモリーが割り当てられます。

  • performance_schema_max_statement_stack

    コマンド行形式 --performance-schema-max-statement-stack=#
    システム変数 performance_schema_max_statement_stack
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 10

    パフォーマンススキーマが統計を保持するネストされたストアドプログラムコールの最大深度。 この最大値を超えると、パフォーマンススキーマはストアドプログラムステートメントが実行されるたびに Performance_schema_nested_statement_lost ステータス変数を増分します。

  • performance_schema_max_table_handles

    コマンド行形式 --performance-schema-max-table-handles=#
    システム変数 performance_schema_max_table_handles
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    オープンしているテーブルオブジェクトの最大数。 この値は、table_handles テーブルのサイズを制御します。 テーブルハンドルを計測できないようにこの最大値を超えると、パフォーマンススキーマは Performance_schema_table_handles_lost ステータス変数を増分します。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_table_instances

    コマンド行形式 --performance-schema-max-table-instances=#
    システム変数 performance_schema_max_table_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされるテーブルオブジェクトの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_table_lock_stat

    コマンド行形式 --performance-schema-max-table-lock-stat=#
    システム変数 performance_schema_max_table_lock_stat
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)

    パフォーマンススキーマがロック統計を保持するテーブルの最大数。 テーブルロック統計が失われるようにこの最大値を超えると、パフォーマンススキーマは Performance_schema_table_lock_stat_lost ステータス変数を増分します。

  • performance_schema_max_thread_classes

    コマンド行形式 --performance-schema-max-thread-classes=#
    システム変数 performance_schema_max_thread_classes
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 100
    最小値 0
    最大値 (≥ 8.0.12) 1024
    最大値 (8.0.11) 256

    スレッドインストゥルメントの最大数。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

  • performance_schema_max_thread_instances

    コマンド行形式 --performance-schema-max-thread-instances=#
    システム変数 performance_schema_max_thread_instances
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    インストゥルメントされるスレッドオブジェクトの最大数。 この値は threads テーブルのサイズを制御します。 この最大を超えたため、スレッドをインストゥルメントできない場合、パフォーマンススキーマは Performance_schema_thread_instances_lost ステータス変数を増分します。 この変数の設定方法および使用方法の詳細は、セクション27.7「パフォーマンススキーマステータスモニタリング」 を参照してください。

    max_connections システム変数は、サーバーで実行できるスレッドの数に影響します。performance_schema_max_thread_instances は、これらの実行中のスレッドのうちインストゥルメントできる数に影響します。

    variables_by_thread テーブルおよび status_by_thread テーブルには、フォアグラウンドスレッドに関するシステム変数およびステータス変数の情報のみが含まれます。 すべてのスレッドがパフォーマンススキーマによって計測されるわけではない場合、このテーブルにはいくつかの行がありません。 この場合、Performance_schema_thread_instances_lost ステータス変数はゼロより大きくなります。

  • performance_schema_session_connect_attrs_size

    コマンド行形式 --performance-schema-session-connect-attrs-size=#
    システム変数 performance_schema_session_connect_attrs_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動サイズ設定を示します。このリテラル値を割り当てないでください)
    最小値 -1
    最大値 1048576

    接続属性のキーと値のペアを保持するために予約されているスレッド当たりの事前割当て済メモリーの量。 クライアントによって送信される接続属性データの集約サイズがこの量より大きい場合、パフォーマンススキーマは属性データを切り捨て、Performance_schema_session_connect_attrs_lost ステータス変数を増分して、log_error_verbosity システム変数が 1 より大きい場合に切り捨てが発生したことを示すメッセージをエラーログに書き込みます。 _truncated 属性は、属性バッファに十分な領域がある場合、失われたバイト数を示す値とともにセッション属性にも追加されます。 これにより、パフォーマンススキーマは接続属性テーブルで接続ごとの切り捨て情報を公開できます。 この情報は、エラーログを確認せずに調べることができます。

    performance_schema_session_connect_attrs_size のデフォルト値は、サーバーの起動時に自動サイズ設定されます。 この値は小さい場合があるため、切捨て (Performance_schema_session_connect_attrs_lost がゼロ以外になる) が発生した場合は、performance_schema_session_connect_attrs_size を明示的に大きい値に設定することをお薦めします。

    最大許容 performance_schema_session_connect_attrs_size 値は 1MB ですが、サーバーは受け入れる接続属性データの集計サイズに 64KB の制限を課すため、有効な最大値は 64KB です。 クライアントが 64KB を超える属性データを送信しようとすると、サーバーは接続を拒否します。 詳細は、セクション27.12.9「パフォーマンススキーマ接続属性テーブル」を参照してください。

  • performance_schema_setup_actors_size

    コマンド行形式 --performance-schema-setup-actors-size=#
    システム変数 performance_schema_setup_actors_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    setup_actors テーブル内の行数。

  • performance_schema_setup_objects_size

    コマンド行形式 --performance-schema-setup-objects-size=#
    システム変数 performance_schema_setup_objects_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)

    setup_objects テーブル内の行数。

  • performance_schema_show_processlist

    コマンド行形式 --performance-schema-show-processlist[={OFF|ON}]
    導入 8.0.22
    システム変数 performance_schema_show_processlist
    スコープ グローバル
    動的 はい
    SET_VAR ヒントの適用 いいえ
    Boolean
    デフォルト値 OFF

    SHOW PROCESSLIST ステートメントは、すべてのアクティブスレッドからスレッドデータを収集することで、プロセス情報を提供します。 performance_schema_show_processlist 変数は、使用する SHOW PROCESSLIST 実装を決定します:

    • デフォルトの実装は、グローバル mutex を保持しながら、スレッドマネージャ内からアクティブスレッド間で繰り返されます。 これは、特にビジー状態のシステムではパフォーマンスに悪影響を及ぼします。

    • 代替の SHOW PROCESSLIST 実装は、パフォーマンススキーマ processlist テーブルに基づいています。 この実装は、スレッドマネージャーではなくパフォーマンススキーマからアクティブなスレッドデータをクエリーするため、mutex は必要ありません。

    代替実装を有効にするには、performance_schema_show_processlist システム変数を有効にします。 デフォルトおよび代替の実装で同じ情報が得られるようにするには、特定の構成要件を満たす必要があります。セクション27.12.19.9「processlist テーブル」 を参照してください。

  • performance_schema_users_size

    コマンド行形式 --performance-schema-users-size=#
    システム変数 performance_schema_users_size
    スコープ グローバル
    動的 いいえ
    SET_VAR ヒントの適用 いいえ
    Integer
    デフォルト値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)
    最小値 -1 (自動スケーリングを示します。このリテラル値を割り当てないでください)
    最大値 1048576

    users テーブル内の行数。 この変数が 0 の場合、パフォーマンススキーマは users テーブル内の接続統計情報または status_by_user テーブル内のステータス変数情報を保持しません。


関連キーワード:  schema, performance, テーブル, max, 変数, size, 最大, パフォーマンス, スキーマ, events