The ASH_REPORT procedure displays the Active Session History (ASH) report in text.
Applicability
This topic applies only to OceanBase Database Enterprise Edition. OceanBase Database Community Edition provides only the MySQL mode.
Syntax
PROCEDURE ASH_REPORT(BTIME IN DATE,
ETIME IN DATE,
SQL_ID IN VARCHAR2 DEFAULT NULL,
TRACE_ID IN VARCHAR2 DEFAULT NULL,
WAIT_CLASS IN VARCHAR2 DEFAULT NULL,
REPORT_TYPE IN VARCHAR2 DEFAULT 'text'
);
Parameters
| Parameter | Description |
|---|---|
| BTIME | The sampling start time. |
| ETIME | The sampling end time. |
| SQL_ID | The SQL ID of the SQL statement to be sampled. If you do not specify this parameter or set the value to NULL, the SQL ID of the statement to be sampled is not limited. |
| TRACE_ID | The trace ID of the SQL statement to be sampled. If you do not specify this parameter or set the value to NULL, the trace ID of the SQL statement to be sampled is not limited. |
| WAIT_CLASS | The type of the wait event to be sampled. The valid values of WAIT_CLASS are the same as those of the GV$ACTIVE_SESSION_HISTORY.WAIT_CLASS field. If you do not specify this parameter or set the value to NULL, the type of wait events is not limited. |
| REPORT_TYPE | The type of the report. At present, only the TEXT type is supported. This parameter is optional. |
Considerations
You can query the oceanbase.GV$ACTIVE_SESSION_HISTORY view for related ASH information.
Examples
Call the ASH_REPORT procedure and specify the start time and end time for diagnostics. The ASH report information is displayed.
obclient> CALL DBMS_WORKLOAD_REPOSITORY.ASH_REPORT(
TO_DATE('2023-02-22 19:26:47', 'YYYY-MM-DD HH24:MI:SS'),
TO_DATE('2023-02-22 19:27:07', 'YYYY-MM-DD HH24:MI:SS') );
Query OK, 0 rows affected
# ASH Report
----
Sample Begin: 2023-02-22 19:26:47
Sample End: 2023-02-22 19:27:07
----------
Analysis Begin Time:
Analysis End Time:
Elapsed Time:
Num of Sample: 0
Num of Events:
Average Active Sessions: