uid_sql_stmts-更新/插入/合併/刪除已執行的 SQL 陳述式 監視器元素

已執行的 UPDATE、INSERT、MERGE 及 DELETE 陳述式數目。

表 1. 表格函數監視資訊
表格函數 監視元素集合層次
MON_GET_CONNECTION 表格函數-取得連線度量 要求度量基準
MON_GET_CONNECTION_DETAILS 表格函數-取得詳細連線度量 (在 DETAILS XML 文件中報告) 要求度量基準
MON_GET_DATABASE 表格函數-取得資料庫層次資訊 要求度量基準
MON_GET_DATABASE_DETAILS 表格函數-取得資料庫資訊度量 要求度量基準
MON_GET_ROUTINE 表格函數 - 取得常式的聚集執行度量 要求度量基準
MON_GET_ROUTINE_DETAILS 表格函數 - 取得常式的聚集執行度量詳細資料 要求度量基準
MON_GET_SERVICE_SUBCLASS 表格函數 - 取得服務子類別度量 要求度量基準
MON_GET_SERVICE_SUBCLASS_DETAILS 表格函數-取得詳細服務子類別度量 要求度量基準
MON_GET_SERVICE_SUPERCLASS 表格函數-取得服務子類別度量 要求度量基準
MON_GET_SERVICE_SUPERCLASS_DETAILS 表格函數-取得詳細服務子類別度量 (在 DETAILS XML 文件中報告) 要求度量基準
MON_GET_UNIT_OF_WORK 表格函數 - 取得工作單元度量 要求度量基準
MON_GET_UNIT_OF_WORK_DETAILS 表格函數-取得詳細工作單元度量 (在 DETAILS XML 文件中報告) 要求度量基準
MON_GET_WORKLOAD 表格函數 - 取得工作量度量 要求度量基準
MON_GET_WORKLOAD_DETAILS 表格函數-取得詳細工作量度量 要求度量基準
表 2. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫 DBase 基本
應用程式 應用程式 基本
對於 Snapshot 監視，可以重設此計數器。
表 3. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
連線 event_conn 一律收集
資料庫 event_db 一律收集
統計資料 event_scmetrics 要求度量基準
統計資料 event_superclassmetrics 要求度量基準
統計資料 event_wlmmetrics 要求度量基準
工作單元 uow_metrics 要求度量基準
使用情形
您可以使用此元素來決定應用程式或資料庫層次的資料庫活動層次。
您也可以使用下列公式來判定 UPDATE、INSERT、MERGE 及 DELETE 陳述式與陳述式總數的比例:
 
   uid_sql_stmts
 / (static_sql_stmts + dynamic_sql_stmts )

此資訊有助於分析應用程式活動及傳輸量。

unread_prefetch_pages-未讀取預先提取頁面監視器元素

指出預先提取器讀取至從未使用的緩衝池的頁數。

表 4. 表格功能監視資訊
表格函數 監視元素收集指令及層次
MON_GET_BUFFERPOOL 表格函數 - 取得緩衝池度量 資料物件度量基準
MON_GET_DATABASE 表格函數-取得資料庫層次資訊 資料物件度量基準
MON_GET_DATABASE_DETAILS 表格函數-取得資料庫資訊度量 資料物件度量基準
MON_GET_TABLESPACE 表格函數 - 取得表格空間度量 資料物件度量基準
表 5. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫 DBase 緩衝池
表格空間 表格空間 緩衝池
緩衝池 緩衝池 緩衝池
應用程式 應用程式 緩衝池
對於 Snapshot 監視，可以重設此計數器。
表 6. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
資料庫 event_db 一律收集
表格空間 event_tablespace 一律收集
連線 event_conn 一律收集

使用情形

如果此數目偏高，則預先提取器會將頁面讀入將不會使用的緩衝池，以造成不必要的 I/O。

uow_comp_status-工作單元完成狀態 監視器元素

工作單元 的狀態及其停止方式。

表 8. 表格函數監視資訊
表格函數 監視元素集合層次
MON_GET_CONNECTION 表格函數-取得連線度量 一律收集
MON_GET_CONNECTION_DETAILS 表格函數-取得詳細連線度量 一律收集
MON_GET_UNIT_OF_WORK 表格函數 - 取得工作單元度量 一律收集
MON_GET_UNIT_OF_WORK_DETAILS 表格函數 - 取得詳細工作單元度量 一律收集
表 9. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
應用程式 應用程式 工作單元
dcs 應用程式 dcs_appl 基本
表 10. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
交易 event_xact 一律收集
使用情形
您可以使用此元素來判斷 工作單元 是否因死鎖或異常終止而結束。 可能是:
  • 由於 commit 陳述式而確定
  • 由於 rollback 陳述式而回復
  • 因死鎖而回復
  • 因異常終止而回復
  • 在正常應用程式終止時已確定。
  • 由於執行中工作單元的 FLUSH EVENT MONITOR 指令而不明。
附註: API 使用者應該參照包含 資料庫系統監視器 常數定義的標頭檔 (sqlmon.h)。

uow_completed_total-工作監視器元素已完成單元總數

透過確定或回復完成的工作單元總數。

表 11. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 活動度量基準
MON_GET_SERVICE_SUPERCLASS_STATS 表格函數-傳回服務超類別的統計資料 一律收集
MON_GET_WORKLOAD_STATS 表格函數 - 傳回工作量統計資料 活動度量基準
MON_SAMPLE_SERVICE_CLASS_METRICS-取得範例服務類別度量 要求度量基準
MON_SAMPLE_WORKLOAD_METRICS-取得工作量度量範例 要求度量基準
WLM_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 要求度量基準
WLM_GET_WORKLOAD_STATS 表格函數-傳回工作量統計資料 要求度量基準
表 12. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
統計資料 event_scstats (在度量值文件中報告) 一律收集
統計資料 event_superclassstats (在度量值文件中報告) 一律收集
統計資料 event_wlstats (在度量值文件中報告) 一律收集

使用情形

當 WLM_GET_SERVICE_SUBCLASS_STATS 或 WLM_GET_WORKLOAD_STATS 函數傳回時，此監視器元素代表自前次重設統計資料以來已完成的工作單元總數。

MON_SAMPLE_SERVICE_CLASS_METRICS 或 MON_SAMPLE_WORKLOAD_METRICS 函數傳回時，此監視器元素代表自執行函數以來已完成的工作單元總數。

uow_elapsed_time-最近的工作單元經歷時間 監視器元素

最近完成工作單元的執行經歷時間。

元素 ID
uow_elapsed_time
元素類型
時間
表 13. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
應用程式 應用程式 工作單元，時間戳記
dcs 應用程式 dcs_appl 工作單元，時間戳記

使用情形

使用此元素作為完成工作單元所花費時間的指示器。

此元素由兩個子元素組成，以秒和微秒 (百萬分之一秒) 來報告所花費的時間。 可以透過將 "_s" 和 "_ms" 新增至此監視器元素的名稱來衍生子元素的名稱。 若要擷取此監視器元素所花費的時間總計，必須將兩個子元素的值相加。 例如，如果 "_s" 子元素值為 3 ，且 "_ms" 子元素值為 20 ，則監視器元素所花費的時間總計為 3.00002 秒。

uow_id-工作單元 ID 監視器元素

工作單元 ID。 工作單元 ID 在應用程式控點中是唯一的。

表 14. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_ACTIVITY 表格函數-傳回活動清單 一律收集
MON_GET_ACTIVITY_DETAILS 表格函數 - 取得完整的活動詳細資料 一律收集
MON_GET_AGENT 表格函數-列出資料庫的代理程式、隔離模式處理程序及系統實體 一律收集
MON_GET_UNIT_OF_WORK 表格函數 - 取得工作單元度量 一律收集
MON_GET_UNIT_OF_WORK_DETAILS 表格函數 - 取得詳細工作單元度量 一律收集

MON_GET_WLM_ADMISSION_QUEUE 表格函數-傳回已排入佇列的活動清單

一律收集
WLM_GET_SERVICE_CLASS_AGENTS 表格函數-列出在服務類別中執行的代理程式 一律收集
WLM_GET_SERVICE_CLASS_WORKLOAD _occurrences 表格函數-列出工作量出現項目 一律收集
WLM_GET_WORKLOAD_occurrence _ACTIVATES 表格函數-傳回活動清單 一律收集
表 15. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
活動 event_activity 一律收集
活動 event_activitystmt 一律收集
活動 event_activityvals 一律收集
活動 event_activitymetrics 一律收集
變更歷程 ddlstmtexec
txncompletion		 一律收集
鎖定 lock_participant_activities
lock_activity_values		 一律收集
臨界值違規 event_thresholdviolations 一律收集
工作單元 uow
uow_metrics
uow_package_list
uow_executable_list		 一律收集

使用情形

將此元素與其他活動歷程元素一起使用，以分析活動的行為。

您也可以將此元素與 activity_id 及 appl_id monitor 元素搭配使用，以唯一識別活動。

uow_lifetime_avg-工作單元生命期限平均值監視器元素

工作單元的平均生命期限。 以毫秒為測量單位。

表 16. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 活動度量基準
MON_GET_SERVICE_SUPERCLASS_STATS 表格函數-傳回服務超類別的統計資料 一律收集
MON_GET_WORKLOAD_STATS 表格函數 - 傳回工作量統計資料 活動度量基準
MON_SAMPLE_SERVICE_CLASS_METRICS-取得範例服務類別度量 要求度量基準
MON_SAMPLE_WORKLOAD_METRICS-取得工作量度量範例 要求度量基準
WLM_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 要求度量基準
WLM_GET_WORKLOAD_STATS 表格函數-傳回工作量統計資料 要求度量基準
表 17. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
統計資料 event_scstats (在度量值文件中報告) 一律收集
統計資料 event_superclassstats (在度量值文件中報告) 一律收集
統計資料 event_wlstats (在度量值文件中報告) 一律收集

使用情形

當 WLM_GET_SERVICE_SUBCLASS_STATS 或 WLM_GET_WORKLOAD_STATS 函數傳回時，此監視器元素代表自前次重設統計資料以來的平均工作生命期限單位。

MON_SAMPLE_SERVICE_CLASS_METRICS 或 MON_SAMPLE_WORKLOAD_METRICS 函數傳回時，此監視器元素代表自執行此函數以來的平均工作生命期限單位。

uow_lock_wait_time-等待鎖定監視器元素的工作時間單位總計

這個 工作單元 等待鎖定所花費的總經歷時間量。 此值會以毫秒為單位來提供。

元素 ID
uow_lock_wait_time
元素類型
計數器 (counter)
表 18. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
應用程式 應用程式 工作單元
使用情形
此元素可協助您判定資源競用問題的嚴重性。

uow_log_space_used-已使用的工作日誌空間單元監視器元素

受監視應用程式目前 工作單元 中已使用的日誌空間量 (以位元組為單位)。

表 19. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UNIT_OF_WORK 表格函數 - 取得工作單元度量 一律收集
MON_GET_UNIT_OF_WORK_DETAILS 表格函數-取得詳細工作單元度量 (在 DETAILS XML 文件中報告) 一律收集
表 20. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
應用程式 應用程式 工作單元
表 21. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
交易 event_xact 一律收集
工作單元 - 一律收集

使用情形

您可以使用此元素來瞭解 工作單元 層次的記載需求。

uow_start_time-工作單元開始時間戳記監視器元素

工作單元 第一次需要資料庫資源的日期和時間。

表 22. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_CONNECTION 表格函數-取得連線度量 一律收集
MON_GET_CONNECTION_DETAILS 表格函數-取得詳細連線度量 一律收集
MON_GET_UNIT_OF_WORK 表格函數 - 取得工作單元度量 一律收集
MON_GET_UNIT_OF_WORK_DETAILS 表格函數-取得詳細工作單元度量 (在 DETAILS XML 文件中報告) 一律收集
表 23. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
應用程式 應用程式 工作單元，時間戳記
dcs 應用程式 dcs_appl 工作單元，時間戳記
表 24. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
工作單元 UOW 一律收集
交易 event_xact -

使用情形

此資源需求在該 工作單元的第一次 SQL 陳述式執行時發生:
  • 對於第一個 工作單元，這是 conn_complete_time之後第一個資料庫要求 (SQL 陳述式執行) 的時間。
  • 對於後續 工作單元，這是前一個 COMMIT 或 ROLLBACK 之後第一個資料庫要求 (SQL 陳述式執行) 的時間。
附註: SQL Reference 會將 工作單元 的界限定義為 COMMIT 或 ROLLBACK 點。

資料庫系統監視器 會從 工作單元的定義中排除 COMMIT/ROLLBACK 與下一個 SQL 陳述式之間所花費的時間。 此測量方法反映 資料庫管理程式 處理資料庫要求所花費的時間，與該 工作單元的第一個 SQL 陳述式之前在應用程式邏輯中所花費的時間不同。 工作單元 經歷時間包括在 工作單元內 SQL 陳述式之間執行應用程式邏輯所花費的時間。

您可以將此元素與 uow_stop_time monitor 元素搭配使用，以計算 工作單元 的總經歷時間，並與 prev_uow_stop_time monitor 元素搭配使用，以計算 工作單元之間在應用程式中所花費的時間。

您可以使用 uow_stop_time 及 prev_uow_stop_time 監視器元素，來計算 工作單元的 SQL Reference 定義的經歷時間。

uow_status-工作單元狀態 監視器元素

工作單元的狀態。

元素 ID
uow_status
元素類型
資訊
表 25. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
交易 event_xact 一律收集
使用情形
您可以使用此元素來判定 工作單元的狀態。 API 使用者應該參照 sqlmon.h 標頭檔，其中包含資料庫系統監視器常數的定義。

uow_stop_time-工作單元停止時間戳記監視器元素

最近 工作單元 完成的日期和時間，在確定或回復資料庫變更時發生。

表 26. 表格函數監視資訊
表格函數 監視元素集合層次
MON_GET_CONNECTION 表格函數-取得連線度量 一律收集
MON_GET_CONNECTION_DETAILS 表格函數-取得詳細連線度量 一律收集
MON_GET_UNIT_OF_WORK 表格函數 - 取得工作單元度量 一律收集
MON_GET_UNIT_OF_WORK_DETAILS 表格函數 - 取得詳細工作單元度量 一律收集
表 27. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
應用程式 應用程式 工作單元，時間戳記
dcs 應用程式 dcs_appl 工作單元，時間戳記
表 28. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
工作單元 UOW 一律收集

使用情形

搭配使用此元素與 prev_uow_stop_time monitor 元素，可計算 COMMIT/ROLLBACK 點之間的總經歷時間，並搭配使用 uow_start_time monitor 元素，可計算最新 工作單元的經歷時間。

時間戳記內容將設定如下:
  • 當應用程式已完成 工作單元 且尚未啟動新的工作單元 (如 uow_start_time 監視器元素中所定義) 時，此元素會報告有效的非零時間戳記。
  • 當應用程式目前正在執行 工作單元時，此元素會報告零。
  • 當應用程式第一次連接至資料庫時，此元素會設為 conn_complete_time 監視器元素的值

啟動新的 工作單元 時，此元素的內容會移至 prev_uow_stop_time 監視器元素。

uow_throughput-工作單元傳輸量監視器元素

以每秒工作單元測量的工作單元完成率。

表 29. 表格功能監視資訊
表格函數 監視元素集合層次
MON_SAMPLE_SERVICE_CLASS_METRICS-取得範例服務類別度量 要求度量基準
MON_SAMPLE_WORKLOAD_METRICS-取得工作量度量範例 要求度量基準
MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 活動度量基準
MON_GET_SERVICE_SUPERCLASS_STATS 表格函數-傳回服務超類別的統計資料 一律收集
MON_GET_WORKLOAD_STATS 表格函數 - 傳回工作量統計資料 活動度量基準
WLM_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 要求度量基準
WLM_GET_WORKLOAD_STATS 表格函數-傳回工作量統計資料 要求度量基準
表 30. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
統計資料 event_scstats (在度量值文件中報告) 一律收集
統計資料 event_superclassstats (在度量值文件中報告) 一律收集
統計資料 event_wlstats (在度量值文件中報告) 一律收集

使用情形

當 WLM_GET_SERVICE_SUBCLASS_STATS 或 WLM_GET_WORKLOAD_STATS 函數傳回時，此監視器元素代表自前次重設統計資料以來的工作單元傳輸量。

當由 MON_SAMPLE_SERVICE_CLASS_METRICS 或 MON_SAMPLE_WORKLOAD_METRICS 函數傳回時，此監視器元素代表自執行此函數以來的工作單元傳輸量。

uow_total_time_top-UOW 時間總計最上層監視器元素

工作單元生命期限的高臨界值 (毫秒)。

表 31. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 MON_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 一律收集
MON_GET_SERVICE_SUPERCLASS_STATS 表格函數-傳回服務超類別的統計資料 一律收集
MON_GET_WORKLOAD_STATS 表格函數 - 傳回工作量統計資料 一律收集
WLM_GET_SERVICE_SUBCLASS_STATS 表格函數-傳回服務子類別的統計資料 一律收集
WLM_GET_WORKLOAD_STATS 表格函數-傳回工作量統計資料 一律收集
表 32. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
統計資料 event_wlstats 一律收集
統計資料 event_scstats 一律收集
統計資料 event_superclassstats 一律收集

使用情形

此元素可用來協助判定 UOWTOTALTIME 臨界值是否有效，也可協助判定如何配置此類臨界值。

若為服務類別，當服務類別的 COLLECT AGGREGATE ACTIVITY DATA 設為 NONE 時，此監視器元素會傳回 -1。

對於工作量，如果工作量的 COLLECT AGGREGATE ACTIVITY DATA 設為 NONE ，則此監視器元素會傳回 -1。

若為服務類別，則會針對工作量指派的服務類別計算對此高臨界值所採取的測量。 工作動作集用來變更活動服務類別的任何對映都不會影響這個高臨界值。

update_sql_stmts-更新 監視器元素

這個元素包含從聯合伺服器實例啟動或前次重設資料庫監視器計數器以來，聯合伺服器代表任何應用程式向這個資料來源發出 UPDATE 陳述式的總次數。

表 33. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫 dbase_remote 基本
應用程式 appl_remote 基本
對於 Snapshot 監視，可以重設此計數器。
使用情形
請利用這個元素來決定聯合伺服器或應用程式針對這個資料來源所導向的資料庫活動層次。
您也可以利用這個元素，利用下列公式來決定聯合伺服器或應用程式針對這個資料來源的寫入活動百分比:
   write_activity =
     (INSERT statements + UPDATE statements + DELETE statements ) /
     (SELECT statements + INSERT statements + UPDATE statements +
     DELETE statements)

update_time-更新回應時間 監視器元素

此元素包含從聯合伺服器實例啟動或前次重設資料庫監視器計數器以來，此資料來源從所有應用程式或在此聯合伺服器實例上執行的單一應用程式回應 UPDATE 所花費的聚集時間量 (毫秒)。

表 34. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫 dbase_remote 時間戳記
應用程式 appl_remote 時間戳記
對於 Snapshot 監視，可以重設此計數器。

回應時間測量為聯合伺服器向資料來源提交 UPDATE 陳述式的時間與資料來源回應聯合伺服器 (指出已處理 UPDATE) 的時間之間的時間差異。

使用情形
請使用這個元素來判斷在等待處理此資料來源的 UPDATE 時，實際所花費的時間。 此資訊可用於產能規劃及調整。

usage_list_used_entries-使用清單已使用項目監視器元素

目前在使用情形清單中的項目數。 如果使用情形清單處於 非作用中 狀態，則此監視器元素代表前次作用中進行監視時此使用情形清單中的項目數。

表 41. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_USAGE_LIST_STATUS 表格函數-傳回使用情形清單上的狀態 一律收集

usage_list_wrapped-使用情形清單 wrap 指示器監視器元素

指出特定使用情形清單是否已折行的指示器。 當使用情形清單已滿時，預設行為是讓項目折行，這表示最舊的項目會取代為最新的項目。

可能的值為 Y 和 N。

表 42. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_USAGE_LIST_STATUS 表格函數-傳回使用情形清單上的狀態 一律收集

user_cpu_time-使用者 CPU 時間監視器元素

資料庫管理程式 代理程式處理程序、工作單元或陳述式所使用的 使用者 CPU 時間總計 (以秒及微秒為單位)。 對於寫入表格的事件監視器，使用 BIGINT 資料類型以微秒為單位提供此元素的值。

當未開啟陳述式監視器開關或時間戳記開關時，不會收集此元素，而是寫入 -1。

表 43. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
連線 event_conn 一律收集
交易 event_xact 一律收集
陳述式 event_stmt 一律收集
活動 event_activity 一律收集

使用情形

此元素與其他相關 CPU 時間元素可協助您瞭解應用程式內的活動層次，並可協助您識別可受益於其他調整的應用程式。

附註: 如果此資訊不適用於您的作業系統，則此元素將設為 0。
附註: 由於資料庫系統用來收集統計資料的精度差異， total_exec_time 監視器元素的值可能不等於 system_cpu_time 和 user_cpu_time 監視器元素的值總和。 在此情況下， system_cpu_time 和 user_cpu_time 監視器元素的總和會更精確地反映實際執行時間總計。

UTIL_HEAP_ALLOCATED-已配置的公用程式資料堆總計監視器元素

在啟用 WLM 許可控制的情況下執行給定活動的公用程式資料堆已配置 4K 頁面總數。 如果在提交此活動時已停用 WLM 許可控制項，則此元素將為 NULL。

表 44. 表格函數監視資訊
表格函數 監視元素集合層次
MON_GET_ACTIVITY 表格函數-傳回活動清單 一律收集
MON_GET_ACTIVITY_DETAILS 表格函數 - 將活動的相關資訊傳回為 XML 文件 一律收集
WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES 表格函數-傳回活動清單 一律收集
表 45. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
活動 event_activitymetrics 活動度量基準

utility_dbname-由公用程式 監視器元素 在上操作的資料庫

公用程式所操作的資料庫。

表 46. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本

utility_description-公用程式說明 監視器元素

公用程式正在執行之工作的簡要說明。 例如，重新平衡呼叫可能包含 "Tablespace ID: 2" ，代表此重新平衡器正在 ID 為 2 的表格空間上工作。 此欄位的格式取決於公用程式的類別，且在版次之間可能會變更。
表 47. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本

utility_detail-公用程式明細 監視器元素

此元素包含公用程式正在執行之工作的簡要說明。

表 48. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
表 49. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 UTILSTART 一律收集

使用情形

公用程式正在執行之工作的簡要說明，包括針對公用程式指定的部分選項。 例如， REORG 呼叫的記錄包括局部重新建構的指令字串，其中包括公用程式所使用的部分不同選項，例如存取模式。 此欄位的格式視公用程式類型而定，而且可能會在不同版本之間變更。

對於自動字典建立 (ADC) ，此元素包括作業的敘述性名稱。

utility_id-公用程式 ID 監視器元素

對應於公用程式呼叫的唯一 ID。

表 50. 表格功能監視資訊
表格函數 監視元素收集指令及層次
MON_GET_ACTIVITY 表格函數-傳回活動清單 一律收集
MON_GET_ACTIVITY_DETAILS 表格函數-取得完整活動詳細資料 (在 DETAILS XML 文件中報告) 一律收集
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
WLM_GET_WORKLOAD_occurrence _ACTIVATES 表格函數-傳回活動清單 一律收集
表 51. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本

使用情形

此元素代表工作 ID ，用於識別在自動字典建立 (ADC) 作業中鏈結作業的唯一工作。 這類 ADC 作業包括建置、複製及啟用。 這些作業在所有成員和階段之間共用相同的 utility_id 。 此 ID 在所有資料庫公用程式中可能不是唯一的。

utility_invocation_id-公用程式呼叫 ID monitor element

對應於公用程式呼叫的唯一 ID。

表 52. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_ACTIVITY 表格函數-傳回活動清單 一律收集
MON_GET_ACTIVITY_DETAILS 表格函數 - 取得完整的活動詳細資料 一律收集
MON_GET_AGENT 表格函數-列出資料庫的代理程式、隔離模式處理程序及系統實體 一律收集
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
WLM_GET_SERVICE_CLASS_AGENTS 表格函數-列出在服務類別中執行的代理程式 一律收集
WLM_GET_WORKLOAD_OCCURRENCE_ACTIVITIES 表格函數-傳回活動清單 一律收集
表 53. 事件監視資訊
事件類型 邏輯資料分組 監視元素集合層次
活動 event_activity 一律收集
變更歷程 changesummary
utillocation
utilphase
utilstart
utilstop		 一律收集

使用情形

utility_invocation_id 是二進位記號，可唯一識別公用程式的給定呼叫。 在公用程式執行所在的每一個成員上， utility_invocation_id 都相同。 utility_invocation_id 將在資料庫停用、重新啟動及成員關閉期間保留其唯一性，可讓您快速識別對應於公用程式給定呼叫的所有事件監視器記錄。

此元素的值可唯一識別由數個作業 (例如建置、複製及啟用) 組成的自動字典建立 (ADC) 作業。 為單一 ADC 工作建立的所有作業在所有成員和階段之間共用相同的 utility_invocation_id 。 此元素也會區分在不同成員上執行的並行 ADC 工作。

utility_invoker_type-公用程式呼叫程式類型 監視器元素

這個元素說明如何呼叫公用程式。

表 54. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
表 55. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本
表 56. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 utilstart 一律收集

使用情形

請利用這個元素來判斷如何呼叫公用程式。 例如，您可以使用它來判斷公用程式是由資料庫或使用者自動呼叫。 此元素的值如下所示，定義在 sqlmon.h 中。
API 常數 公用程式
SQLM_UTILITY_INVOKER_USER 使用者已呼叫公用程式。
SQLM_UTILITY_INVOKER_AUTO 資料庫已自動呼叫公用程式。
對於 MON_GET_UTILITY 表格函數及變更事件歷程監視器，此元素指出如何呼叫公用程式:
使用者
使用者已呼叫公用程式。
自動
資料庫已自動呼叫公用程式。

對於自動字典建立 (ADC) 作業，此元素的值為 'AUTO'。 對於 LOAD 或 REDISTRIBUTE 作業所起始的 ADC 呼叫，此元素的值是 'USER' ，代表第一筆寫入的記錄。

utility_operation_type-公用程式作業類型 monitor element

指出公用程式作業的類型。

表 57. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
表 58. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 UTILSTART 一律收集

使用情形

對於變更歷程事件監視器，此元素包含已啟動之公用程式事件 (UTILITY_TYPE) 的詳細資料。

如果 UTILITY_TYPE 是 ADC ，則此元素將為下列其中一項:
R
備妥作業
B
建置作業
C
複製和排除作業
E
啟用作業
X
取消作業
L
載入已起始自動字典建立
如果 UTILITY_TYPE 是 BACKUP ，則為下列其中一項:
D
差異
I
漸進式
F
完整
如果 UTILITY_TYPE 是 LOAD ，則為下列其中一項:
I
插入
R
取代
S
重新啟動
T
終止
如果 UTILITY_TYPE 是 MOVETABLE ，則為下列其中一項:
A
取消
C
複製
I
起始
L
清除
M
移動
R
重播
S
交換(S)
V
驗證
如果 UTILITY_TYPE 是 REDISTRIBUTE ，請執行下列其中一項:
A
中斷
C
繼續
D
預設值
T
目標對映
如果 UTILITY_TYPE 是 REORG ，則為下列其中一項:
A
重組所有表格索引
C
重新壓縮表格
I
索引重組
N
就地表格重組
R
重組表格收回範圍
T
標準表格重組
如果 UTILITY_TYPE 是 RESTORE ，則下列其中一項:
A
漸進式自動
B
漸進式中斷
F
完整
M
漸進式手動
如果 UTILITY_TYPE 是 ROLLFORWARD ，則為下列其中一項:
E
日誌結尾
P
復原點
如果 UTILITY_TYPE 是 RUNSTATS ，則為下列其中一項:
A
表格上的所有索引
I
索引
T
表格

utility_phase_detail-公用程式階段明細 監視器元素

此元素保留供未來使用。

表 59. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 UTILHHASE 一律收集

utility_phase_type-公用程式階段類型 監視器元素

識別公用程式階段類型。

表 60. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 UTILHHASE 一律收集

使用情形

對於變更歷程事件監視器，如果 utility_type 元素是 BACKUP ，則階段類型為:
BACKUPTS
備份表格空間

utility_priority-公用程式優先順序 監視器元素

公用程式優先順序指定節流控制公用程式相對於其節流控制同層級的相對重要性量。 優先順序若為 0，暗示公用程式執行時沒有節流控制。 非零優先順序必須在 1-100 的範圍內，其中 100 代表最高優先順序，1 代表最低優先順序。

表 61. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
表 62. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本
表 63. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 utilstart 一律收集

utility_start_time-公用程式開始時間 監視器元素

最初呼叫現行公用程式的日期和時間。

表 64. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
表 65. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本

utility_start_type-公用程式啟動類型 monitor 元素

這個元素指出公用程式的啟動方式。

表 66. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 UTILSTART 一律收集

使用情形

對於變更歷程事件監視器，公用程式啟動資訊是下列其中一項:
  • RESUME
  • START

對於自動字典建立 (ADC) ，備妥工作的起始記錄應該具有值 'START'。 此值指出公用程式的整體啟動，因為這是要執行的第一個作業。 對於所有其他 ADC 作業，該值為 'RESUME' ，因為工作正在建立字典時回復。

utility_state-公用程式狀態 monitor element

這個元素說明公用程式的狀態。

元素 ID
utility_state
元素類型
資訊
表 67. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本
使用情形
請利用這個元素來判斷作用中公用程式的狀態。 此欄位的值如下所示，定義在 sqlmon.h 中。
API 常數 說明
SQLM_UTILITY_STATE_EXECUTE 公用程式正在執行中
SQLM_UTILITY_STATE_WAIT 在回復進度之前，公用程式正在等待事件發生
SQLM_UTILITY_STATE_ERROR 公用程式發生錯誤
SQLM_UTILITY_STATE_SUSPENDED 公用程式已暫停

utility_stop_type-公用程式停止類型 監視器元素

這個元素指出公用程式的停止方式。

此元素是 util_stop_type的同義字。

表 68. 事件監視資訊
事件類型 邏輯資料分組 監視器開關 (monitor switch)
變更歷程 UTILSTOP 一律收集

使用情形

對於變更歷程事件監視器，公用程式已以下列其中一種方式停止:
  • 暫停
  • STOP

對於自動字典建立 (ADC) 作業，啟用作業的停止或取消記錄具有 STOP 值，因為這些記錄指出公用程式已完成。 所有其他停止記錄的值都是 PAUSE ，因為公用程式將在下一個作業開始時回復。

utility_type-公用程式類型 監視器元素

公用程式的類別。

表 69. 表格功能監視資訊
表格函數 監視元素集合層次
MON_GET_UTILITY 表格函數-取得在資料庫上執行的公用程式 一律收集
表 70. Snapshot 監視資訊
Snapshot 層次 邏輯資料分組 監視器開關 (monitor switch)
資料庫管理程式 utility_info 基本
表 71. 事件監視資訊
事件類型 邏輯資料分組 監視元素集合層次
變更歷程 changesummary
utillocation
utilphase
utilstart
utilstop		 一律收集

使用情形

此元素的值可以是 sqlmon.h 中所定義名稱以 "SQLM_UTILITY_" 開頭的任何常數。

對於 MON_GET_UTILITY 表格函數及變更歷程事件監視器，公用程式類型是下列其中一項:
  • ADC
  • BACKUP
  • LOAD
  • MOVETABLE
  • ONLINERECOVERY
  • REBALANCE
  • REDISTRIBUTE
  • REORG
  • RESTORE
  • RUNSTATS
對於 Snapshot 監視器介面，公用程式類型是下列其中一項:
  • ADC
  • ASYNC_INDEX_CLEANUP
  • ASYNC_PART_DETACH
  • BACKUP
  • CRASH_RECOVERY
  • GROUP_CRASH_RECOVERY
  • LOAD
  • MDC_ROLROUT_CLEANUP
  • MEMBER_CRASH_RECOVERY
  • REBALANCE
  • REDISTRIBUTE
  • RESTART_RECREATE_INDEX
  • RESTORE
  • ROLLFORWARD_RECOVERY
  • RUNSTATS