NAME

インストゥルメント名。 セクション27.6「パフォーマンススキーマインストゥルメント命名規則」に説明するように、インストゥルメント名には複数の部分があり、階層を形成することがあります。 インストゥルメントの実行から生成されるイベントには、インストゥルメント NAME 値から取得される EVENT_NAME 値があります。 (イベントには実際には「名前」がありませんが、これによって、イベントをインストゥルメントに関連付ける方法を提供します。)

ENABLED

インストゥルメントが有効にされているかどうか。 値は YES または NO です。 無効にされたインストゥルメントはイベントを生成しません。 このカラムは変更できますが、ENABLED の設定は、すでに作成されているインストゥルメントには影響しません。

TIMED

インストゥルメントの時間が測定されるかどうか。 値は、YES、NO または NULL です。 このカラムは変更できますが、TIMED の設定は、すでに作成されているインストゥルメントには影響しません。

TIMED 値 NULL は、インストゥルメントがタイミングをサポートしていないことを示します。 たとえば、メモリー操作は時間指定されていないため、その TIMED カラムは NULL です。

タイミングをサポートするインストゥルメントに対して TIMED を NULL に設定しても、タイミングをサポートしないインストゥルメントに対して TIMED を NULL 以外に設定しても効果はありません。

有効にされたインストゥルメントの時間が測定されない場合、インストゥルメントコードは有効ですが、タイマーは有効ではありません。 インストゥルメントによって生成されたイベントの TIMER_START、TIMER_END、および TIMER_WAIT タイマー値が NULL になります。 これによって、サマリーテーブルの合計、最小、最大、および平均の時間値の計算時に、それらの値が無視されます。

PROPERTIES

インストゥルメントプロパティ。 このカラムは SET データ型を使用するため、インストゥルメントごとに次のリストの複数のフラグを設定できます:

VOLATILITY

インストゥルメントのボラティリティ。 ボラティリティ値の範囲は、低から高です。 値は、mysql/psi/psi_base.h ヘッダーファイルで定義されている PSI_VOLATILITY_xxx 定数に対応します:

#define PSI_VOLATILITY_UNKNOWN 0
#define PSI_VOLATILITY_PERMANENT 1
#define PSI_VOLATILITY_PROVISIONING 2
#define PSI_VOLATILITY_DDL 3
#define PSI_VOLATILITY_CACHE 4
#define PSI_VOLATILITY_SESSION 5
#define PSI_VOLATILITY_TRANSACTION 6
#define PSI_VOLATILITY_QUERY 7
#define PSI_VOLATILITY_INTRA_QUERY 8

VOLATILITY カラムは、ユーザー (およびパフォーマンススキーマコード) にインストゥルメントの実行時動作に関するヒントを提供するための単なる情報です。

低揮発性インデックス (PERMANENT = 1) を持つインストゥルメントは、サーバーの起動時に一度作成され、通常のサーバー操作中に破棄または再作成されることはありません。 これらは、サーバーの停止中にのみ破棄されます。

たとえば、wait/synch/mutex/pfs/LOCK_pfs_share_list mutex は揮発性 1 で定義されており、これは一度作成されることを意味します。 インストゥルメンテーション自体から発生する可能性のあるオーバーヘッド (相互排他ロック初期化) は、このインストゥルメントには影響しません。 実行時オーバーヘッドは、mutex をロックまたはロック解除する場合にのみ発生します。

ボラティリティインデックスが高いインストゥルメント (SESSION = 5 など) は、ユーザーセッションごとに作成および破棄されます。 たとえば、wait/synch/mutex/sql/THD::LOCK_query_plan mutex は、セッションが接続されるたびに作成され、セッションが切断されると破棄されます。

この mutex は、パフォーマンススキーマのオーバーヘッドにより機密性が高くなります。これは、オーバーヘッドがロックおよびロック解除インストゥルメンテーションだけでなく、より頻繁に実行される相互排他ロック作成および破棄インストゥルメンテーションからも発生するためです。

ボラティリティの別の側面は、ENABLED カラムの更新が実際になんらかの影響を与えるかどうかと、そのタイミングに関するものです:

たとえば、次のステートメントは既存のセッションの LOCK_query_plan mutex には影響しませんが、更新後に作成された新しいセッションには影響します:

UPDATE performance_schema.setup_instruments
SET ENABLED=value
WHERE NAME = 'wait/synch/mutex/sql/THD::LOCK_query_plan';

このステートメントは、実際には何の効果もありません:

UPDATE performance_schema.setup_instruments
SET ENABLED=value
WHERE NAME = 'wait/synch/mutex/pfs/LOCK_pfs_share_list';

この mutex は永続的であり、更新の実行前にすでに作成されています。 mutex が再度作成されることはないため、setup_instruments の ENABLED 値は使用されません。 この mutex を有効または無効にするには、かわりに mutex_instances テーブルを使用します。

DOCUMENTATION

インストゥルメントの目的を説明する文字列。 説明がない場合、値は NULL です。

主キー (NAME)