説明
このビューは、V4.2.0バージョンから導入されました。
機能の概要
ビュー oceanbase.DBA_OB_TENANT_EVENT_HISTORY は、このテナントの履歴操作記録を表示するために使用されます。
フィールドの説明
| フィールド | タイプ | NULLか | 説明 |
|---|---|---|---|
| TIMESTAMP | timestamp(6) | NO | 実行時間、単位はマイクロ秒 |
| MODULE | varchar(256) | NO | モジュール名 |
| EVENT | varchar(256) | NO | イベント名 |
| NAME1 | varchar(256) | YES | 最初のプロパティ名 |
| VALUE1 | longtext | YES | 最初のプロパティ値 |
| NAME2 | varchar(256) | YES | 2 番目のプロパティ名 |
| VALUE2 | longtext | YES | 2 番目のプロパティ値 |
| NAME3 | varchar(256) | YES | 3 番目のプロパティ名 |
| VALUE3 | longtext | YES | 3 番目のプロパティ値 |
| NAME4 | varchar(256) | YES | 4 番目のプロパティ名 |
| VALUE4 | longtext | YES | 4 番目のプロパティ値 |
| NAME5 | varchar(256) | YES | 5 番目のプロパティ名 |
| VALUE5 | longtext | YES | 5 番目のプロパティ値 |
| NAME6 | varchar(256) | YES | 6 番目のプロパティ名 |
| VALUE6 | longtext | YES | 6 番目のプロパティ値 |
| EXTRA_INFO | longtext | YES | 追加情報 |
| SVR_IP | varchar(46) | YES | 実行アクションが実行されるOBServerノードのIP |
| SVR_PORT | bigint(20) | YES | 実行アクションが実行されるOBServerノードのポート番号 |
| TRACE_ID | varchar(64) | YES | 実行アクションのTrace ID |
| COST_TIME | bigint(20) | YES | 実行アクションに消費された時間 |
| RET_CODE | bigint(20) | YES | 実行アクションのエラーコード。0 の場合、実行は成功したことを示します |
| ERROR_MSG | varchar(512) | YES | 実行アクションが失敗した後のエラーメッセージ |
タイプのテナントイベント例
典型的なテナントイベントモジュールには、TENANT ROLE CHANGE（プライマリ/スタンバイテナント切り替え）と SERVICE NAME（サービス名）が含まれます。
ユーザーが異なるモジュール操作を実行する場合、対応するイベントの NAME および VALUE 値はそれぞれ異なります。
テナントロール変更
TENANT ROLE CHANGE モジュールには、FAILOVER TO PRIMARY、SWITCHOVER TO PRIMARY、SWITCHOVER TO STANDBY の3種類の操作があります。
FAILOVER TO PRIMARY操作
ユーザーが
FAILOVER TO PRIMARY操作を開始すると、テナントイベントレコードテーブルに以下の重要なイベントが記録されます。FAILOVER TO PRIMARY START
このイベントは、
ALTER SYSTEM ACTIVATE STANDBYコマンドの具体的な時刻と関連するテナント情報を記録します。プロパティ プロパティ値 NAME1：STMT_STR VALUE1：ユーザーが入力したコマンドテキスト NAME2：TENANT_INFO VALUE2：コマンド開始時のテナントの状態または情報 FAILOVER TO PRIMARY END
このイベントは、
ALTER SYSTEM ACTIVATE STANDBYコマンドの完了時刻を正確に記録し、その操作を実行したテナントの関連情報、ログストリームの最終状態、および主要ステップの所要時間の詳細を含みます。プロパティ プロパティ値 NAME1：STMT_STR VALUE1：ユーザーが入力したコマンドテキスト NAME2：TENANT_INFO VALUE2：コマンド終了時のテナントの状態または情報 NAME3：FAILOVER_SCN VALUE3：テナントのFAILOVER後の同期ポイント NAME4：COST_DETAIL VALUE4：コマンド実行中の段階ごとの時間消費統計、単位はマイクロ秒 NAME5：ALL_LS VALUE5：テナントがACCESS MODEを変更した際のすべてのログストリームの状態
SWITCHOVER TO PRIMARY操作
ユーザーが
SWITCHOVER TO PRIMARY操作を開始すると、テナントイベントレコードテーブルに以下の重要なイベントが記録されます。SWITCHOVER TO PRIMARY START
このイベントは、
ALTER SYSTEM SWITCHOVER TO PRIMARYコマンドの具体的な時刻と関連するテナント情報を記録します。プロパティ プロパティ値 NAME1：STMT_STR VALUE1：ユーザーが入力したコマンドテキスト NAME2：TENANT_INFO VALUE2：コマンド開始時のテナントの状態または情報 WAIT LOG SYNC
このイベントは、テナントログ同期に関する情報を記録します。ユーザーが
ALTER SYSTEM SWITCHOVER TO PRIMARYコマンドを実行する際、対象となるテナントは現在のプライマリテナントから最新のすべてのログレコードまで同期する必要があり、データの一貫性と完全性を確保します。プロパティ プロパティ値 NAME1：IS_SYS_LS_SYNCED VALUE1：テナントのシステムログストリームが同期されているかどうか NAME2：IS_ALL_LS_SYNCED VALUE2：テナントのすべてのログストリームが同期されているかどうか NAME3：NON_SYNC_INFO VALUE3：同期されていないログストリームが存在する場合、システムは同期されていないログストリームの数を表示し、同期速度が最も遅い上位5つのログストリームに関する情報を提供します。 SWITCHOVER_TO_PRIMARY_END
このイベントは、
ALTER SYSTEM SWITCHOVER TO PRIMARYコマンドの完了時刻を正確に記録し、その操作を実行したテナントの関連情報、ログストリームの最終状態、および主要ステップの所要時間の詳細を含みます。プロパティ プロパティ値 NAME1：STMT_STR VALUE1：ユーザーが入力したコマンドテキスト NAME2：TENANT_INFO VALUE2：コマンド終了時のテナントの状態または情報 NAME3：SWITCHOVER_SCN VALUE3：テナントSWITCHOVER後の同期ポイント NAME4：COST_DETAIL VALUE4：コマンド実行中の段階ごとの時間消費統計、単位はマイクロ秒 NAME5：ALL_LS VALUE5：テナントがACCESS MODEを変更した際のすべてのログストリームの状態
SWITCHOVER TO STANDBY操作
ユーザーが
SWITCHOVER TO STANDBY操作を開始すると、テナントイベントレコードテーブルに以下の重要なイベントが記録されます。SWITCHOVER TO STANDBY START
このイベントは、
ALTER SYSTEM SWITCHOVER TO STANDBYコマンドの具体的な時刻と関連するテナント情報を記録します。プロパティ プロパティ値 NAME1：STMT_STR VALUE1：ユーザーが入力したコマンドテキスト NAME2：TENANT_INFO VALUE2：コマンド開始時のテナントの状態または情報 SWITCHOVER TO STANDBY END
このイベントは、
ALTER SYSTEM SWITCHOVER TO STANDBYコマンドの完了時刻を正確に記録し、その操作を実行したテナントの関連情報、ログストリームの最終状態、および主要ステップの所要時間の詳細を含みます。プロパティ プロパティ値 NAME1：STMT_STR VALUE1：ユーザーが入力したコマンドテキスト NAME2：TENANT_INFO VALUE2：コマンド終了時のテナントの状態または情報 NAME3：SWITCHOVER_SCN VALUE3：テナントSWITCHOVER後の同期ポイント NAME4：COST_DETAIL VALUE4：コマンド実行中の段階ごとの時間消費統計、単位はマイクロ秒 NAME5：ALL_LS VALUE5：テナントがACCESS MODEを変更した際のすべてのログストリームの状態
サービス名
SERVICE NAME モジュールには、CREATE SERVICE、DELETE SERVICE、START SERVICE、STOP SERVICE の4種類の操作が含まれます。
これら4種類の操作は、TRACE_ID を使用して検索できます。例えば、サービス作成イベントを特定することで、そのイベントの TRACE_ID から、サービス作成時にブロードキャストもトレースできます。
CREATE SERVICE
特定のユーザーテナントでサービス作成が開始されると、以下のイベントが記録されます。
BROADCAST SERVICE NAME
このイベントでは、ブロードキャストの内容、ターゲットとなるOBServerマシンのリスト、および最終的にブロードキャストを正常に受信したOBServerマシンのリストが詳細に記録されます。ユーザーが
ALTER SYSTEM CREATE SERVICEコマンドを実行すると、そのコマンドを開始したOBServerは、該当テナントに属するすべてのUnitが存在するOBServerに対して、そのテナントの現在のサービス名情報をブロードキャストします。プロパティ プロパティ値 NAME1：EPOCH VALUE1：今回のブロードキャストで配信されるテナントの現在のすべてのサービス名に関する情報バージョン NAME2：TARGET_SERVICE_NAME_ID VALUE2：今回のブロードキャストイベントをトリガーした service_name_idNAME3：SERVICE_NAME_LIST VALUE3：テナントの現在のすべてのサービス名に関する情報 NAME4：SERVICE_NAME_COMMAND_TYPE VALUE4：今回のブロードキャストイベントをトリガーした操作タイプ NAME5：TARGET_SERVERS_LIST VALUE5：ターゲットとなるブロードキャストマシン、テナント内ユニットが存在するすべての非永続的オフラインマシン NAME6：SUCCESS_SERVERS_LIST VALUE6：ブロードキャストに成功したマシン CREATE SERVICE
このイベントでは、作成するサービス名と、サービス作成完了後の関連詳細情報が記録されます。ユーザーが
ALTER SYSTEM CREATE SERVICEコマンドを実行し終了すると、このイベントが生成されます。プロパティ プロパティ値 NAME1：SERVICE_NAME_STRING VALUE1：ユーザーが作成したい新しいサービス名 NAME2：CREATED_SERVICE_NAME VALUE2：作成されたサービス名に関する情報
DELETE SERVICE
特定のユーザーテナントでサービス削除が開始されると、以下のイベントが記録されます。
DELETE SERVICE
このイベントでは、コマンド開始時の関連情報が記録されます。ユーザーが
ALTER SYSTEM DELETE SERVICEコマンドを実行し終了すると、このイベントが生成されます。プロパティ プロパティ値 NAME1：DELETED_SERVICE_NAME VALUE1：削除対象のサービス名に関する情報
START SERVICE
特定のユーザーテナントでサービス起動が開始されると、以下のイベントが記録されます。
BROADCAST SERVICE NAME
このイベントでは、ブロードキャストの内容、ターゲットとなるOBServerマシンのリスト、および最終的にブロードキャストを正常に受信したOBServerマシンのリストが詳細に記録されます。ユーザーが
ALTER SYSTEM SERVICE NAMEコマンドを実行すると、そのコマンドを開始したOBServerは、該当テナントに属するすべてのUnitが存在するOBServerに対して、そのテナントの現在のサービス名情報をブロードキャストします。プロパティ プロパティ値 NAME1：EPOCH VALUE1：今回のブロードキャストに関するテナントの現在のすべてのサービス名に関する情報バージョン NAME2：TARGET_SERVICE_NAME_ID VALUE2：今回のブロードキャストイベントをトリガーした service_name_idNAME3：SERVICE_NAME_LIST VALUE3：テナントの現在のすべての service_nameNAME4：SERVICE_NAME_COMMAND_TYPE VALUE4：今回のブロードキャストイベントをトリガーした操作タイプ NAME5：TARGET_SERVERS_LIST VALUE5：ターゲットとなるブロードキャストマシン、テナント内ユニットが存在するすべての非永続的オフラインマシン NAME6：SUCCESS_SERVERS_LIST VALUE6：ブロードキャストに成功したマシン START SERVICE
このイベントでは、コマンド開始時および終了時の関連情報が記録されます。ユーザーが
ALTER SYSTEM START SERVICEコマンドを実行し終了すると、このイベントが生成されます。プロパティ プロパティ値 NAME1：SERVICE_NAME_BEFORE VALUE1：サービス起動前のサービス名関連情報 NAME2：SERVICE_NAME_AFTER VALUE2：サービス起動後のサービス名関連情報
STOP SERVICE
特定のユーザーテナントでサービス停止が開始されると、以下のイベントが記録されます。
KILL CONNECTIONS OF SERVICE NAME
各OBServerは、停止されたサービス名によって確立された接続をすべて終了し、その後テナントイベントビューにレコードが生成されます。もし特定のOBServer上で停止されたサービス名によって確立された接続がない場合、そのイベントはテーブルに記録されません。
プロパティ プロパティ値 NAME1：SERVICE_NAME VALUE1：停止されたサービス名に関する情報 NAME2：KILLED_CONNECTIONS_COUNT VALUE2：切断された接続数 NAME3：KILLED_CONNECTIONS_LIST VALUE3：切断された接続に対応するID BROADCAST SERVICE NAME
このイベントでは、ブロードキャストの内容、ターゲットとなるOBServerマシンのリスト、および最終的にブロードキャストを正常に受信したOBServerマシンのリストが詳細に記録されます。ユーザーが
ALTER SYSTEM STOP SERVICEコマンドを実行すると、そのコマンドを開始したOBServerは、該当テナントに属するすべてのUnitが存在するOBServerに対して、そのテナントの現在のサービス名情報をブロードキャストします。プロパティ プロパティ値 NAME1：EPOCH VALUE1：今回のブロードキャストに関するテナントの現在のすべてのサービス名に関する情報バージョン NAME2：TARGET_SERVICE_NAME _ID VALUE2：今回のブロードキャストイベントをトリガーした service _name _idNAME3：SERVICE_NAME_LIST VALUE3：テナントの現在のすべての service_nameNAME4：SERVICE_NAME_COMMAND_TYPE VALUE4：今回のブロードキャストイベントをトリガーした操作タイプ NAME5：TARGET_SERVERS_LIST VALUE5：ターゲットブロードキャストのマシン、テナント内ユニットが存在するすべての非永続的オフラインマシン NAME6：SUCCESS_SERVERS_LIST VALUE6：ブロードキャストに成功したマシン STOP SERVICE
このイベントでは、コマンド開始時および終了時の関連情報が記録されます。ユーザーが
ALTER SYSTEM STOP SERVICEコマンドを実行し終了すると、このイベントが生成されます。プロパティ プロパティ値 NAME1：SERVICE_NAME_BEFORE VALUE1：サービス停止前のサービス名関連情報 NAME2：SERVICE_NAME_AFTER VALUE2：サービス停止後のサービス名関連情報
クエリ例
このテナントの履歴操作レコードを照会し、最初のレコードを表示します。
obclient [oceanbase]> SELECT * FROM oceanbase.DBA_OB_TENANT_EVENT_HISTORY LIMIT 1\G
クエリ結果は次のとおりです：
*************************** 1. row ***************************
TIMESTAMP: 2023-12-14 14:33:20.321725
MODULE: TENANT ROLE CHANGE
EVENT: SWITCHOVER TO STANDBY END
NAME1: STMT_STR
VALUE1: ALTER SYSTEM SWITCHOVER TO STANDBY TENANT backup_mysql_tenant
NAME2: TENANT_INFO
VALUE2: {tenant_id:1002, tenant_role:"STANDBY", switchover_status:"NORMAL", switchover_epoch:1702535600271677, sync_scn:1702535620070597000, replayable_scn:1702535620070597000, readable_scn:1702535620070597000, recovery_until_scn:4611686018427387903, log_mode:"ARCHIVELOG", max_ls_id:1003}
NAME3: SWITCHOVER_SCN
VALUE3: 1702535620070597000
NAME4: COST_DETAIL
VALUE4: WAIT_LOG_END: 100190, CHANGE_ACCESS_MODE: 47261, OTHERS: 136839
NAME5: ALL_LS
VALUE5: NORMAL: 1, 1001, 1002, 1003
NAME6: NULL
VALUE6:
EXTRA_INFO: NULL
SVR_IP: 100.xx.xx.xx
SVR_PORT: 13324
TRACE_ID: Y340C64586BD4-00060C724AEB962B-0-0
COST_TIME: 284290
RET_CODE: 0
ERROR_MSG: NULL
1 row in set