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


27.12.2.1 setup_actors テーブル

setup_actors テーブルには、新しいフォアグラウンドサーバースレッド (クライアント接続に関連付けられたスレッド) の監視および履歴イベントロギングを有効にするかどうかを決定する情報が含まれます。 このテーブルはデフォルトで 100 行の最大サイズになります。 テーブルサイズを変更するには、サーバー起動時に performance_schema_setup_actors_size システム変数を変更します。

新しいフォアグラウンドスレッドごとに、パフォーマンススキーマはスレッドのユーザーとホストを、setup_actors テーブルの行に対して照合します。 そのテーブルの行が一致する場合、その ENABLED カラムと HISTORY カラムの値を使用して、スレッドの threads テーブルの行の INSTRUMENTED カラムと HISTORY カラムがそれぞれ設定されます。 これにより、インストゥルメントおよび履歴イベントロギングをホスト、ユーザーまたはアカウント (ユーザーとホストの組合せ) ごとに選択的に適用できます。 一致するものがない場合、スレッドの INSTRUMENTED カラムと HISTORY カラムは NO に設定されます。

バックグラウンドスレッドの場合、関連付けられたユーザーはありません。 INSTRUMENTED および HISTORY はデフォルトで YES であり、setup_actors は参照されません。

setup_actors テーブルの初期コンテンツは任意のユーザーとホストの組合せに一致するため、監視および履歴イベント収集はすべてのフォアグラウンドスレッドに対してデフォルトで有効になっています:

mysql> SELECT * FROM performance_schema.setup_actors;
+------+------+------+---------+---------+
| HOST | USER | ROLE | ENABLED | HISTORY |
+------+------+------+---------+---------+
| %    | %    | %    | YES     | YES     |
+------+------+------+---------+---------+

setup_actors テーブルを使用してイベント監視に影響を与える方法の詳細は、セクション27.4.6「スレッドによる事前フィルタリング」 を参照してください。

setup_actors テーブルの変更は、変更後に作成されたフォアグラウンドスレッドにのみ影響し、既存のスレッドには影響しません。 既存のスレッドに影響を与えるには、threads テーブルの行の INSTRUMENTED および HISTORY カラムを変更します。

setup_actors テーブルにはこれらのカラムがあります。

  • HOST

    ホスト名。 これらはリテラル名または任意のホストを意味する '%' であるべきです。

  • USER

    ユーザー名。 これはリテラル名または任意のユーザーを意味する '%' であるべきです。

  • ROLE

    使用されません。

  • ENABLED

    行に一致するフォアグラウンドスレッドのインストゥルメンテーションを有効にするかどうか。 値は YES または NO です。

  • HISTORY

    行に一致するフォアグラウンドスレッドの履歴イベントをログに記録するかどうか。 値は YES または NO です。

setup_actors テーブルには次のインデックスがあります:

  • 主キー (HOST, USER, ROLE)

TRUNCATE TABLEsetup_actors テーブルに対して許可されています。 行が削除されます。


関連キーワード:  テーブル, パフォーマンス, スキーマ, setup, actors, events, replication, イベント, history, 変数