拡張イベント
実装済みExtended Events セッションを、実行状態とセッションごとの詳細とともに一覧表示します。開始と停止はスクリプトファーストです。
2 つのグリッドを左右に並べて表示します。左側にはセッションの一覧が表示され、それぞれの起動状態と現在実行中かどうかが分かります。1 つを選択すると、 イベントとターゲットを表示
そのセッションのイベントとターゲットで右側のグリッドを埋めます。セッションの開始と停止は スクリプト優先: 開始のスクリプトを作成 そして 停止のスクリプトを作成
正確に次の ALTER EVENT SESSION … STATE = START|STOP ステートメントを、ダイアログから実行するのではなく、レビュー用にタブで開きます。フッターにもその旨の記載があります。
sys.database_event_sessions)。コマンドパレットから開くと、そのインスタンスのサーバースコープのセッションが一覧表示されます。データベーススコープのセッションしかない Azure SQL Database では、自動的にそちらにフォールバックします。
開き方
- 1 つのデータベースの場合: エクスプローラーでデータベースを右クリックし、次を選択します ツール › 拡張イベント...。SQLly はまずそのデータベースをアクティブにします。ダイアログのタイトルは次で終わります (データベーススコープ).
- インスタンス全体の場合: 実行 拡張イベント… 次から コマンドパレット。タイトルは次で終わります (サーバースコープ)。Azure SQL Database のようにサーバースコープのカタログを読み取れない場合、ペインはデータベーススコープで再試行し、タイトルにその旨が表示されます。
セッションの確認と停止
同僚がトレースセッションを起動したままにしていて、停止する前に何をキャプチャしているか確認したいとします。
- 拡張イベントを開きます。左のグリッドには各セッションが名前とともに一覧表示され、
startup_state(サーバーと一緒に起動するかどうか)およびis_running(1現時点でアクティブな場合)。 - セッションの行を選択して、 イベントとターゲットを表示。右側のグリッド(見出しは イベントとターゲット - <session>、次を一覧表示します
event_nameそしてtarget_name次のようなペアsql_batch_completed次に書き込まれたevent_fileターゲット。 - 押す 停止のスクリプトを作成。ダイアログが閉じ、ステートメントを含むクエリタブが開きます。内容を確認して、ご自身で実行してください:
ALTER EVENT SESSION [long_running_queries] ON SERVER STATE = STOP;
ステートメントが指定するデータベースから ON DATABASE 代わりに。
開始のスクリプトを作成 次を付けた同じステートメントを生成します STATE = START。セッション名は角括弧で囲まれ、 ] は二重化されるため、変わった名前でも安全です。
ボタン
| ボタン | 何ができるか |
|---|---|
| 更新 | セッションリストを再読み込みし、詳細グリッドをクリアします。 |
| イベントとターゲットを表示 | 選択したセッションのイベントとターゲットを右側のグリッドに読み込みます。 |
| 開始のスクリプトを作成 / 停止のスクリプトを作成 | 開く ALTER EVENT SESSION ステートメントを、選択したセッション向けに新しいクエリタブで開きます。ダイアログからは何も実行されません。 |
行が選択されていない場合、アクションは勝手に推測するのではなく、まずセッションを選択するよう促します。
権限と制限
- Extended Events のメタデータを読み取るには、次が必要です
VIEW SERVER STATE、またはVIEW DATABASE STATEAzure SQL 上で。リストが読み取れない場合は、そのリマインダーでサーバーのエラーが表示されます。 - ペインはセッションと構成をリストします。セッションを作成したり、イベントデータを読み込みたりすることはありません。書き込み
CREATE EVENT SESSIONクエリタブで、次のような通常の関数でターゲットを読み取りますsys.fn_xe_file_target_read_file.
SQL Server ファミリーでは、Extended Events は SQL Server の機能です。他のエンジンではメニュー項目にその旨が表示され、ClickHouse では次のテーブルを案内します system.query_log そして system.trace_log、これは クエリインサイト すでに読み取ります。