DBMS_PROFILER
包收集并存儲在性能剖析會話中執行的關于PL/pgSQL
和SPL
語句的性能信息。
您可以使用下列表中列出的函數和存儲過程來控制剖析工具。
函數/存儲過程 | 類型 | 返回類型 | 描述 |
---|---|---|---|
FLUSH_DATA | 函數、存儲過程 | Status code、exception | 刷新當前會話中收集的性能數據。 |
GET_VERSION(major OUT, minor OUT) | 存儲過程 | N/A | 返回DBMS_PROFILER 版本信息。
|
INTERNAL_VERSION_ CHECK | 函數 | Status code | 確認DBMS_PROFILER 的當前版本是否能與當前數據庫兼容。
|
PAUSE_PROFILER | 函數、存儲過程 | Status code、exception | 暫停分析會話。 |
RESUME_PROFILER | 函數、存儲過程 | Status code、exception | 繼續分析會話。 |
START_PROFILER(run comment, run commentl [, run number OUT ]) | 函數、存儲過程 | Status code、exception | 開始數據收集會話。 |
STOP_PROFILER | 函數、存儲過程 | Status code、exception | 停止分析會話及刷新性能信息到DBMS_PROFILER 表和視圖中。
|
DBMS_PROFILER
包中的函數返回的是一個表示成功或失敗的狀態碼。只有在DBMS_PROFILER
存儲過程執行失敗時,才會產生異常。下表中列出了函數返回的狀態碼和消息,以及存儲過程產生的異常信息。
狀態碼 | 狀態碼說明 | 異常信息 | 描述 |
---|---|---|---|
-1 | error version | version_mismatch | 分析器版本與數據庫不兼容。 |
0 | success | N/A | 操作成功。 |
1 | error_param | profiler_error | 參數錯誤。 |
2 | error_io | profiler_error | 數據刷新失敗。 |
FLUSH_DATA
在不終結分析器會話的情況下,
FLUSH_DATA
函數/存儲過程會刷新從當前會話中收集的數據。數據將被刷新到PolarDB性能特性指南描述的表中。語法如下:status INTEGER FLUSH_DATA
FLUSH_DATA
參數參數名稱 | 描述 |
---|---|
status | 返回的狀態碼。 |
GET_VERSION
GET_VERSION
存儲過程返回DBMS_PROFILER
版本信息。語法如下:GET_VERSION(major OUT INTEGER, minor OUT INTEGER)
參數參數名稱 | 描述 |
---|---|
major | DBMS_PROFILER 主版本的數量。
|
minor | DBMS_PROFILER 次版本的數量。
|
INTERNAL_VERSION_CHECK
INTERNAL_VERSION_CHECK
函數用于確認DBMS_PROFILER
的當前版本是否能與當前數據庫兼容。語法如下:status INTEGER INTERNAL_VERSION_CHECK
參數參數名稱 | 描述 |
---|---|
status | 返回的狀態碼。 |
PAUSE_PROFILER
PAUSE_PROFILER
函數/存儲過程用于暫停分析會話。語法如下:status INTEGER PAUSE_PROFILER
PAUSE_PROFILER
參數參數名稱 | 描述 |
---|---|
status | 返回的狀態碼。 |
RESUME_PROFILER
RESUME_PROFILER
函數/存儲過程用于繼續分析會話。語法如下:status INTEGER RESUME_PROFILER
RESUME_PROFILER
參數參數名稱 | 描述 |
---|---|
status | 返回的狀態碼。 |
START_PROFILER
START_PROFILER
函數/存儲過程用于開始數據收集會話。語法如下:status INTEGER START_PROFILER(run_comment TEXT := SYSDATE,
run_comment1 TEXT := '' [, run_number OUT INTEGER ])
START_PROFILER(run_comment TEXT := SYSDATE,
run_comment1 TEXT := '' [, run_number OUT INTEGER ])
參數參數名稱 | 描述 |
---|---|
run comment | 給分析器會話的用戶定義的注釋。默認值為SYSDATE。 |
run commentl | 給分析器會話的額外用戶定義的注釋。默認值為TT。 |
run number | 分析器會話的數量。 |
status | 返回的狀態碼。 |
STOP_PROFILER
STOP_PROFILER
函數/存儲過程用于停止分析會話及刷新性能信息到DBMS_PROFILER
表和視圖中。語法如下:status INTEGER STOP_PROFILER
STOP_PROFILER
參數參數名稱 | 描述 |
---|---|
status | 返回的狀態碼。 |