MySQL Shell 8.0  /  ...  /  組込み MySQL Shell レポート: Thread

このページは機械翻訳したものです。

7.1.6.3 組込み MySQL Shell レポート: Thread

組込み MySQL Shell レポート thread は、MySQL Shell 8.0.18 から使用できます。 接続された MySQL サーバー内の特定のスレッドに関する詳細情報を提供します。 このレポートは、サポートされているすべての MySQL 5.7 および MySQL 8.0 バージョンを実行しているサーバーで機能します。 ターゲットサーバーの MySQL Server バージョンで使用できない情報項目がある場合、レポートはその情報を残します。

thread レポートには、MySQL パフォーマンススキーマを含む様々なソースから導出された、選択したスレッドとそのアクティビティの情報が表示されます。 デフォルトでは、レポートには現在の接続で使用されているスレッドに関する情報が表示されます。または、スレッドをその ID または接続 ID で識別できます。 1 つ以上のカテゴリの情報を選択するか、スレッドに関する使用可能なすべての情報を表示できます。 レポート固有のオプションおよびレポートに含めることができる情報の詳細は、次の MySQL Shell コマンドのいずれかを発行してレポートのヘルプを表示します:

\help thread
\show thread --help

セクション7.1.5「MySQL Shell レポートの実行」 で説明されているように、thread レポートでは、レポート固有のオプションに加えて、\show および\watch コマンドのほとんどの標準オプションを使用できます。 例外は、\show コマンドの --vertical (または -E) オプションであり、受け入れられません。 thread レポートには、異なるセクションに表示される垂直リストおよびテーブルを含むカスタム出力形式があり、この出力形式は変更できません。

threads レポートでは、MySQL Server format_statement() 関数が使用されます (format_statement() 関数 を参照)。 レポートに表示される切り捨てられたステートメントは、MySQL Server sys_config テーブルの statement_truncate_len オプションの設定 (デフォルトは 64 文字) に従って切り捨てられます。

次のリストは、threads レポートのレポート固有のオプションで提供される機能をまとめたものです。 オプションの詳細および短い形式は、レポートのヘルプを参照してください:

--tid, --cid

レポートするスレッド ID または接続 ID を指定します。

--general

スレッドに関する基本情報を表示します。 この情報は、次のいずれのオプションも使用しない場合、デフォルトで返されます。

--brief

スレッドの簡単な説明を 1 行に表示します。

--client

クライアント接続およびクライアントセッションに関する情報を表示します。

--innodb

スレッドを使用している現在の InnoDB トランザクションに関する情報を表示します (存在する場合)。

--locks

スレッドによってブロックおよびブロックされたロックに関する情報を表示します。

--prep-stmts

スレッドに割り当てられたプリペアドステートメントに関する情報を表示します。

--status

スレッドのセッションステータス変数に関する情報を表示します。 照合する接頭辞のリストを指定できます。この場合、一致する変数のみが表示されます。

--vars

スレッドのセッションシステム変数に関する情報を表示します。 照合する接頭辞のリストを指定できます。この場合、一致する変数のみが表示されます。

--user-vars

スレッドのユーザー定義変数に関する情報を表示します。 照合する接頭辞のリストを指定できます。この場合、一致する変数のみが表示されます。

--all

簡単な説明を除いて、前述のすべての情報を表示します。

たとえば、次のコマンドはスレッド ID 53 のスレッドに対して thread レポートを実行し、スレッドに関する一般情報、クライアント接続の詳細、およびスレッドがブロックしているロックまたはブロックしているロックに関する情報を返します:

mysql-py>  \show thread --tid 53 --general --client --locks