瞭解使用狀況追蹤表格

系統會將使用狀況追蹤資料儲存在三個資料庫表格。

使用狀況追蹤程序會使用您在「系統設定值」頁面中的設定值所指定表格名稱建立這兩個表格。

使用狀況追蹤邏輯查詢日誌記錄表格
使用狀況追蹤實體查詢日誌記錄表格
使用狀況追蹤初始化區塊表格

使用狀況追蹤邏輯查詢日誌記錄表格

下表描述追蹤邏輯查詢的資料庫表格中的每個資料欄。適當的位置會指定資料類型 (例如可變字元欄位 (varchar 和 varchar2)) 和長度。當您複查此表格中的說明時，可以假設加上或減去特定的時間相關資料欄會等於準確值。例如，您可以假設 TOTAL_TIME_SEC 等於 END_TS 減 START_TS。資料欄不會提供這樣的準確值，因為：

各種處理作業會以平行方式執行，其速度取決於負載和資料庫效能。伺服器型作業可能是輕量型或資源密集型。
所有連線都被佔用時，查詢便會排入佇列並等待處理。處理時機則視負載和組態而定。

與使用者、階段作業和 ID 相關的資料欄

資料欄	描述
`ID`	在「邏輯查詢」表格中，此資料欄指示唯一的資料列 ID。在「實體查詢」表格中，此資料欄會以名稱 `LOGICAL_QUERY_ID` 表示。
`NODE_ID`	包含 `<hostname>:obis1`。例如 `examplehost:obis1` (單一執行處理)。
`PRESENTATION_NAME`	代表目錄名稱。預設值為 Null，且資料類型為 Varchar(128)。
`IMPERSONATOR_USER_NAME`	指定模擬使用者的使用者名稱。如果不是以模擬使用者身分執行要求，則此值為 None。預設值為 None，且資料類型為 Varchar(128)。
`USER_NAME`	指定送出查詢的使用者名稱。
`ECID`	代表系統產生的執行相關資訊環境 ID。資料類型為 Varchar2(1024)。
`TENANT_ID`	指定執行初始化區塊的使用者其租用戶名稱。資料類型為 Varchar2(128)。
`SERVICE_NAME`	指定服務的名稱。資料類型為 Varchar2(128)。
`SESSION_ID`	代表階段作業 ID。資料類型為 Number(10)。
`HASH_ID`	代表邏輯查詢的 `HASH` 值。資料類型為 Varchar2(128)。

與查詢來源相關的資料欄

資料欄	描述
`QUERY_SRC_CD`	要求的來源。請注意，要求者可以將 QUERY_SRC_CD 設為任何字串值來識別自己。可能的值包括： Report - 來源為分析或任何匯出作業。 Drill - 如果來源是因為向上展開或向下展開而造成的維度變化。 ValuePrompt - 來源為篩選條件對話方塊或儀表板提示中的「值」下拉式清單。 VisualAnalyzer - 如果來源是視覺化資料的工作簿。 DisplayValueMap 或 MemberBrowserDisplayValues 或 MemberBrowserPath - 如果來源是與顯示分析相關的值。 SOAP - 如果來源是來自 Web 服務 (例如 DataSetSvc) 的呼叫。 Seed - 來源為植入分析伺服器快取的代理程式。 Null - 來源為管理工具實體表格、資料欄資料列數目或視觀表資料。
`SAW_DASHBOARD`	代表儀表板的路徑名稱。如果查詢不是透過儀表板送出，則此值為 NULL。
`SAW_DASHBOARD_PG`	代表儀表板中的頁面名稱。如果要求不是一個儀表板要求，則此值為 NULL。預設值為 Null，且資料類型為 Varchar(150)。
`SAW_SRC_PATH`	指定分析目錄中的路徑名稱。

與查詢詳細資訊相關的資料欄

資料欄	描述
`ERROR_TEXT`	包含後端資料庫傳回的錯誤訊息。只有 `SUCCESS_FLAG` 設為 0 (零) 以外的值時，才適用此資料欄。多則訊息串接在一起，系統不會進行剖析。預設值為 Null，且資料類型為 Varchar(250)。
`QUERY_BLOB`	包含沒有任何截斷的整個邏輯 SQL 敘述句。`QUERY_BLOB` 資料欄為 Long 類型的字元字串。
`QUERY_KEY`	包含系統從邏輯 SQL 敘述句產生的 MD5 雜湊金鑰。預設值為 Null，且資料類型為 Varchar(128)。
`QUERY_TEXT`	代表為查詢送出的 SQL 敘述句。資料類型為 Varchar(1024)。您可以變更此資料欄的長度 (使用 ALTER TABLE 命令)，但請注意，已寫入此資料欄的文字一律會截斷為實體層所定義的大小。語意模型管理員不得將此資料欄的長度值設為大於後端實體資料庫支援的查詢長度上限。例如，Oracle Database 能夠處理的 Varchar 上限為 4000，但是 Oracle Database 會截斷為 4000 個位元組，而不是 4000 個字元。如果您使用多位元組字元集，則根據使用的字元集和字元而定，實際的字串大小上限會和字元數目有所不同。
`REPOSITORY_NAME`	指定查詢存取的語意模型名稱。
`SUBJECT_AREA_NAME`	包含存取的業務模型名稱。
`SUCCESS_FLG`	代表查詢的完成狀態，定義如下： 0 - 順利完成查詢，沒有任何錯誤。 1 - 查詢逾時。 2 - 查詢因超過資料列限制而失敗。 3 - 查詢因其他原因而失敗。

與執行時機相關的資料欄

資料欄	描述
`COMPILE_TIME_SEC`	包含編譯查詢所需的時間 (秒)。`TOTAL_TIME_SEC` 值包含 `COMPILE_TIME_SEC` 值。
`END_DT`	代表完成邏輯查詢的日期。
`END_HOUR_MIN`	代表在幾點幾分完成邏輯查詢。
`END_TS`	代表完成邏輯查詢的日期和時間。開始和結束時戳還反映了查詢等待資源成為可用狀態所需的任何時間。如果使用者送出查詢後，在完成查詢前便離開頁面，則不會進行最後的擷取，並且會記錄 3600 的逾時值。但如果使用者在逾時之前回到頁面，則會在此時完成擷取，並且記錄為 `end_ts` 時間。
`START_DT`	代表送出邏輯查詢的日期。
`START_HOUR_MIN`	代表在幾點幾分送出邏輯查詢。
`START_TS`	代表送出邏輯查詢的日期和時間。
`TOTAL_TIME_SEC`	代表系統在從屬端等待分析回應時，處理查詢所花費的時間 (秒)。`TOTAL_TIME_SEC` 包含 `COMPILE_TIME_SEC` 的時間。
`RESP_TIME_SEC`	代表查詢回應所使用的時間。資料類型為 Number(10)。

與執行詳細資訊相關的資料欄

資料欄	描述
`CUM_DB_TIME_SEC`	包含傳送至資料庫的所有查詢累計時間。查詢會以平行方式執行，所以累計時間會等於或大於連線至資料庫的時間總計。例如，假設邏輯要求產生 4 個傳送至資料庫的實體 SQL 敘述句，其中 3 個查詢的查詢時間為 10 秒，1 個查詢的查詢時間為 15 秒，查詢會以平行方式執行，因此 `CUM_DB_TIME_SEC` 顯示為 45 秒。
`CUM_NUM_DB_ROW`	包含後端資料庫傳回的資料列總數。
`NUM_DB_QUERY`	代表送到後端資料庫以滿足邏輯查詢要求的查詢數目。若為成功查詢 (SuccessFlag = 0)，此數目為 1 或更大值。
`ROW_COUNT`	代表查詢從屬端所傳回的資料列數目。從查詢傳回大量資料時，在使用者顯示所有資料之前，將不會填入此資料欄。
`TOTAL_TEMP_KB`	指定收到查詢的總 KB 數。資料類型為 Number(10)。

與快取相關的資料欄

資料欄	描述
`CACHE_IND_FLG`	Y 表示查詢快取命中；N 則表示快取未命中。預設值為 N。
`NUM_CACHE_HITS`	代表查詢傳回快取結果的次數。`NUM_CACHE_HITS` 是 32 位元整數 (或 10 位數整數)。預設值為 Null。
`NUM_CACHE_INSERTED`	代表查詢產生快取項目的次數。預設值為 Null。`NUM_CACHE_INSERTED` 是 32 位元整數 (或 10 位數整數)。

使用狀況追蹤實體查詢日誌記錄表格

下表描述追蹤實體查詢的資料庫表格。此資料庫表格記錄邏輯查詢日誌記錄表格中所儲存邏輯查詢的實體 SQL 資訊。實體查詢表格和邏輯查詢表格之間具有外來索引鍵關係。

與使用者、階段作業和 ID 相關的資料欄

資料欄	描述
`ID`	指定唯一的資料列 ID。
`LOGICAL_QUERY_ID`	參照邏輯查詢日誌記錄表格中的邏輯查詢。資料類型為 Varchar2(50)。
`HASH_ID`	代表邏輯查詢的 `HASH` 值。資料類型為 Varchar2(128)。
`PHYSICAL_HASH_ID`	代表實體查詢的 `HASH` 值。資料類型為 Varchar2(128)。

與查詢詳細資訊相關的資料欄

資料欄	描述
`QUERY_BLOB`	包含沒有任何截斷的整個實體 SQL 敘述句。 `QUERY_BLOB` 資料欄為 Long 類型的字元字串。
`QUERY_TEXT`	包含為查詢送出的 SQL 敘述句。資料類型為 Varchar(1024)。

與執行時機相關的資料欄

資料欄	描述
`END_DT`	代表完成實體查詢的日期。
`END_HOUR_MIN`	代表幾點幾分完成實體查詢。
`END_TS`	代表完成實體查詢的日期和時間。開始和結束時戳還反映了查詢等待資源成為可用狀態所需的任何時間。
`TIME_SEC`	代表實體查詢執行時間。
`START_DT`	代表送出實體查詢的日期。
`START_HOUR_MIN`	代表在幾點幾分送出實體查詢。
`START_TS`	代表送出實體查詢的日期和時間。

與執行詳細資訊相關的資料欄

資料欄	描述
`ROW_COUNT`	包含傳回至查詢從屬端的資料列數目。

使用狀況追蹤初始化區塊表格

下表描述追蹤初始化區塊相關資訊的表格。

註：

初始化區塊使用狀況追蹤表格目前僅包含階段作業初始化區塊，不包含語意模型初始化區塊。

與使用者、階段作業和 ID 相關的資料欄

資料欄	描述
`USER_NAME`	執行初始化區塊的使用者名稱。資料類型為 Varchar2(128)。
`TENANT_ID`	執行初始化區塊的使用者其租用戶名稱。資料類型為 Varchar2(128)。
`SERVICE_NAME`	服務的名稱。資料類型為 Varchar2(128)。
`ECID`	系統產生的執行相關資訊環境 ID。資料類型為 Varchar2(1024)。
`SESSION_ID`	階段作業 ID。資料類型為 Number(10)。

與查詢詳細資訊相關的資料欄

資料欄	描述
`REPOSITORY_NAME`	查詢存取的語意模型名稱。資料類型為 Varchar2(128)。
`BLOCK_NAME`	已執行初始化區塊的名稱。資料類型為 Varchar2(128)。

與執行時機相關的資料欄

資料欄	描述
`START_TS`	啟動初始化區塊的日期和時間。
`END_TS`	完成初始化區塊的日期和時間。開始和結束時戳還反映了查詢等待資源成為可用狀態所需的時間。
`DURATION`	執行初始化區塊所花費的時間長度。資料類型為 Number(13,3)。

與執行詳細資訊相關的資料欄

資料欄	描述
`NOTES`	初始化區塊及其執行的相關附註。資料類型為 Varchar2(1024)。