收集及分析查詢日誌

查詢日誌包含功能強大的診斷資訊,可讓管理員分析與疑難排解查詢效能、錯誤案例及錯誤結果的相關問題。在 Oracle Analytics 中啟用查詢日誌時,會將剖析、最佳化、執行計畫、實體查詢、摘要統計資料等相關資訊寫入查詢日誌。

存取查詢日誌

查詢日誌會依照在系統執行查詢的相同順序依序寫入。每個階段作業與要求都會以唯一的 ID 加以識別。管理員可以在主控台的階段作業與查詢快取頁面存取這些查詢日誌。若要瞭解如何存取此頁面,請參閱分析 SQL 查詢和日誌

註:

工作簿作者也可以存取查詢資訊,例如工作簿中視覺化元件的查詢時間、伺服器時間及串流處理時間。請參閱本主題結尾的存取工作簿的查詢日誌,。

查詢日誌層級

  • 日誌層級決定所產生日誌的詳細程度與資料量。

  • 您可以在系統、階段作業或報表層級設定日誌層級。
  • 您可以使用系統日誌記錄層級特性 (在「工具 -> 選項 -> 儲存區域」底下) 或使用階段作業變數定義語意模型的 (RPD) 全域日誌層級。

    以下為 GUID-8BF38235-E497-4FC9-B4C3-D5E3B11C2991-default.jpg 的說明
    .jpg

  • 您可以將 LOGLEVEL 變數新增至報表進階頁籤中的前置碼特性,覆寫報表的日誌層級。

  • 若要確保避開快取命中,取得完整的日誌,除了 LOGLEVEL,您還可以包含 DISABLE_CACHE_HIT=1 變數。

    以下為 GUID-028022F5-7C3F-4EA4-B497-88453DFF4853-default.jpg 的說明
    .jpg

  • 日誌層級 (LOGLEVEL) 值在 0-7 的範圍之間。
    • LOGLEVEL=0 表示停用日誌記錄。
    • LOGLEVEL=7 是最高日誌記錄層級,主要供 Oracle 開發團隊使用。
    • LOGLEVEL=2 最適用於效能調校與基本瞭解。
    • LOGLEVEL=3 為疑難排解資料列層級資料安全篩選所需。
  • 根據日誌層級,查詢日誌會包含查詢的相關資訊,包括邏輯要求、導覽與執行計畫、產生的實體查詢、執行時間、在不同執行節點收到的資料列數與位元組數,以及快取相關資訊。

管理員可以使用適當的 LOGLEVEL 和變數設定值來執行查詢,從主控台的發出 SQL 頁面擷取查詢日誌。

以下為 GUID-CE500760-79A2-4D2E-83CA-F401163B111F-default.jpg 的說明
.jpg

讀取查詢日誌

階段作業和查詢快取頁面列出目前作用中的所有查詢和階段作業。管理員可以從主控台存取此頁面。

以下為 GUID-E741680B-8E04-4FBA-9173-4D2F1CAA680E-default.jpg 的說明
.jpg

頁面上的每個項目皆可依所設定的層級 (即語意模型、階段作業或報表層級),存取特定查詢的查詢日誌。

以下為 GUID-AF2BE54A-CC5E-44C0-88E2-9ADD91B3962C-default.jpg 的說明
.jpg

Oracle Analytics 中的每個要求都有唯一的 requestid

邏輯 SQL 查詢

以下是 Oracle Analytics 中的範例邏輯 SQL 查詢。

以下為 GUID-ACCBD275-1027-48FB-9183-8EB87EB94078-default.jpg 的說明
.jpg

以下是您可能會在邏輯 SQL 要求中見到的常用變數:

  • QUERY_SRC_CD:查詢的來源:提示、報表、DV、發出 SQL 等。
  • SAW_SRC_PATH:若已儲存查詢,此為查詢在目錄中的路徑。
  • SAW_DASHBOARD:若查詢包含在儀表板中,此為儀表板在目錄中的路徑。
  • SAW_DASHBOARD_PG:儀表板頁面的名稱。

邏輯要求

邏輯要求是在新增安全篩選之後 (如果有的話),從展示圖層到業務模型和對應圖層的查詢轉譯。

以下為 GUID-74E1CA85-56BB-412D-B9F1-468E1D143DFD-default.jpg 的說明
.jpg

Oracle Analytics 會根據邏輯要求來決定查詢是否命中現有快取,或是必須從資料庫擷取。

以下為 GUID-AD43A89E-4AC8-4A6A-B30F-167EEA2BAE0F-default.jpg 的說明
.jpg

執行計畫

執行計畫是將實際邏輯要求變成最佳執行計畫的轉譯。這包括每個作業的傳送計畫,以及作業是在資料庫或 Oracle Analytics 中執行。在 Oracle Analytics 中處理作業時,查詢日誌會指示 [for database 0:0,0]

以下為 GUID-41665BED-DD61-4056-BEDD-D54D2292BD58-default.jpg 的說明
.jpg

查詢執行期間,Oracle Analytics 會確實遍歷此樹狀結構。在詳細日誌中,可以取得在執行樹狀結構每個節點所處理資料列的相關資訊。

以下為 GUID-58CDEF0F-CE9D-41D7-A639-1F68749074B1-default.jpg 的說明
.jpg

實體或資料庫要求

Oracle Analytics 會根據執行計畫產生要在所指定資料庫執行的實體 SQL。可能會有一或多個要求傳送至一或多部資料庫。

以下為 GUID-67BA9E19-057C-4918-A583-C127B2D14F32-default.jpg 的說明
.jpg

對於傳送至資料庫的每個實體要求,都會有所擷取資料列與位元組數目的日誌。

以下為 GUID-A103C103-084C-4370-BDB6-0D2728A66DAB-default.jpg 的說明
.jpg

有多個查詢時,您可以使用查詢 ID (此範例中為 1914627) 來比對傳送查詢至資料庫區段中記錄的確實查詢。這可讓您將查詢與多個資料庫要求查詢時所擷取的資料列對應。

根據報表結構與語意模型定義,一份報表可能會傳送多個查詢至一或多部資料庫。例如,在此查詢日誌有 3 個實體查詢傳送至資料庫。

以下為 GUID-6AD88CC1-CED9-4609-BB30-F6B0F94BB105-default.jpg 的說明
.jpg

日誌會針對執行計畫中的所有節點提供相似的資料列處理資訊。最後,記錄傳送至從屬端的資料列。

以下為 GUID-94913767-718C-44B4-AE6C-6081DD12D8B4-default.jpg 的說明
.jpg

日誌還包含最終的統計資料摘要,包括完整的執行時間。您可以在此與時間關聯,以便對效能問題進行分析與調查。

以下為 GUID-2F47CE96-DFE8-4B4F-940A-3FF9CE336F2A-default.jpg 的說明
.jpg

摘要統計資料

查詢日誌摘要中便會顯示數個時間統計資料。
  • 經歷時間 - 從收到邏輯查詢到從屬端關閉游標的經歷時間總計。如果從屬端允許使用者捲動檢視結果 (如 Oracle Analytics 一般),則游標可能會長時間保持開啟狀態,直到使用者瀏覽至其他頁面或登出。
  • 編譯時間 - Oracle Analytics 用於從邏輯 SQL 查詢產生執行計畫與實體查詢的時間。
  • BI 伺服器時間總計 - 從屬端等待回應的時間總計。這包括實體查詢執行時間、擷取期間的等待時間,以及 Oracle Analytics 在內部執行所花費的時間。
  • 執行時間 - 從 Oracle Analytics 收到邏輯查詢到邏輯查詢執行完成的時間。這不包括邏輯查詢執行完成之後,從屬端擷取結果所花費的任何時間。
  • 回應時間 - 從 Oracle Analytics 收到邏輯查詢到傳回第一個資料列至從屬端的時間。

查詢日誌注意事項

  • 單一繫線活動。在不利的情況下,您可能會遇到日誌層級大於 2 的效能瓶頸。

  • 列出與計算的時間是將項目寫入日誌的時間,這幾乎等於事件發生時間 (也就是起始日誌輸入的活動)。除非有其他影響日誌記錄的效能瓶頸。

  • 查詢日誌記錄是用於診斷,而非用於收集使用狀況資訊。若要瞭解使用狀況追蹤,請參閱追蹤使用狀況

存取工作簿的查詢日誌

只有管理員可以透過主控台的階段作業與查詢快取頁面存取日誌。但是,內容作者可以透過開發人員功能表存取其工作簿中視覺化查詢的日誌資訊,這對想要疑難排解查詢效能的作者是很有用的工具。若要存取工作簿的效能工具 (開發人員功能表選項),使用者必須在我的設定檔下的進階功能表中開啟啟用開發人員選項

以下為 GUID-1C5E06A4-B442-41CF-9A16-029A8878237B-default.jpg 的說明
.jpg

啟用後,便會在工作簿功能表中顯示開發人員功能表選項。

以下為 GUID-72F0DD44-DD0A-47D4-942B-3E014F122B0F-default.jpg 的說明
.jpg

開發人員選項可讓使用者能夠在工作區即時檢視與分析任何視覺化的各種日誌。工作區下方會顯示個別框架,其中對於每個資訊類型都有不同的頁籤。當視覺化執行時,預設不會填入或重新整理日誌。

以下為 GUID-5D339116-5D5F-4AA2-B16B-82096E0B0D3C-default.jpg 的說明
.jpg

請選擇您想要分析的視覺化,然後按一下重新整理以產生日誌。重新整理後,便會顯示與該視覺化有關的各種資訊,您可以分析特定視覺化的日誌資訊。若要分析多個視覺化,您必須個別加以重新整理,然後逐一進行分析。

以下為 GUID-5A53D8E3-0776-44DC-ADD9-214C231E172B-default.jpg 的說明
.jpg
內容作者可以使用開發人員選項分析某個範圍的資訊,例如效能日誌、JSON、XML 以及資料集相關資訊。這表示他們無須管理員存取階段作業與查詢快取頁面便可分析日誌。

註:

開發人員功能表僅適用於工作簿。對於傳統的分析與儀表板,您可以透過階段作業與查詢快取頁面存取查詢日誌。