管理員設定 - 永久衍生資料表

Looker Persistent Derived Tables 管理員頁面會顯示 Looker 例項的永久資料表狀態，包括永久衍生資料表和匯總資料表。

「持續性衍生資料表」管理員頁面會顯示多項管理員功能，協助您追蹤及排解持續性資料表行為的問題。如要瞭解如何排解已儲存資料表的問題，請參閱「Looker 中的衍生資料表」說明文件。

Looker 管理員和具備 see_pdts 權限的使用者可以存取「Persistent Derived Tables」頁面。

如要開啟「Persistent Derived Tables」頁面，請按照下列步驟操作：

  1. 按一下 Looker 的「主選單」圖示 ，然後選取「管理」(如果「管理」選單尚未顯示)。(如果您在 Looker 主選單的「探索」或「開發」部分，可能需要按一下返回箭頭，才能查看「管理」選單)。
  2. 在「管理」選單中，選取「永久衍生資料表」。

「永久衍生資料表」頁面只會顯示已為 PDT 啟用的連線，以及符合下列條件的永久表格：

  • 除非您處於開發模式，否則會在實際工作環境的檢視畫面檔案中定義已儲存的資料表。在這種情況下，您可以使用開發分頁查看已儲存資料表的開發版本。
  • 已儲存的資料表是已正確設定的模型的一部分。
  • 已儲存的資料表是您有資料存取權的模型的一部分。

本頁資訊是根據內部 PDT 事件記錄檔，請參閱本頁的「探索 PDT 事件記錄檔」一節。

自訂表格

根據預設，「Persistent Derived Tables」頁面會在頁面上顯示最多 25 個已保存的資料表，並為您在 Looker 執行個體上有資料存取權的所有連線載入已保存的資料表。您可以透過多種方式變更表格中顯示的資料：

  1. 如要只查看特定連線的已儲存資料表，請按一下「所有連線」旁的箭頭，然後選取特定連線的名稱。選擇器只會顯示已為 PDT 啟用且您有資料存取權的連線。
  2. 在搜尋框中輸入關鍵字，即可將已儲存的表格清單縮小至名稱含有關鍵字的已儲存表格。表格會顯示已儲存的資料表，並以粗體顯示相符的搜尋字詞。按一下搜尋列中的「X」，即可清除搜尋查詢字詞。
  3. 按一下「篩選器」圖示，定義表格的篩選條件。
  4. 按一下關閉/開啟圖示，即可顯示或隱藏「一覽無餘」專區。
  5. 按一下資料欄名稱，即可依該欄排序表格。再次按一下資料欄名稱，即可反轉排序順序。
  6. 按一下「選取要顯示的資料欄」圖示，即可隱藏或顯示表格中的資料欄。
  7. 使用顯示選取器，選擇單一頁面要顯示的結果數量。如果表格超過一頁，您可以按一下頁面底部中央的箭頭，前往下一頁或上一頁。

篩選

您可以使用搜尋列旁的「篩選器」圖示，選擇「持續性衍生表格」頁面要顯示哪些已儲存的表格。舉例來說，您可以依據「上次建構狀態」篩選，只查看發生建構錯誤的已儲存表格，也可以依據「模型」篩選，只查看特定模型的已儲存表格。

如要篩選「Persistent Derived Tables」頁面，請按照下列步驟操作：

  1. 按一下「篩選器」圖示 。
  2. 在篩選器選單中，從第一個篩選器選取器中選取篩選器選項。可用的選項如下：
    • 未在最後：依據在指定數量的小時和分鐘內未觸發的永久衍生資料表，篩選「永久衍生資料表」頁面。
    • 在過去：依據在指定小時和分鐘內觸發的永久衍生資料表，篩選「永久衍生資料表」頁面。
    • 模型：針對指定模型中包含的永久資料表，篩選「永久衍生資料表」頁面。
    • 持久性規則：依持久性類型篩選「永久衍生資料表」頁面。
    • Last Attempt Status：依指定的永久保存資料表狀態篩選「Persistent Derived Tables」頁面。
    • 已發布為穩定版檢視表：布林值，用於篩選「持續性衍生資料表」頁面中的持續性資料表，並根據 publish_as_db_view 參數值，針對已發布為穩定版檢視表的持續性資料表顯示「是」，針對未發布為穩定版檢視表的持續性資料表顯示「否」。
    • 上次建立時間長度超過：依據建構作業耗時超過指定秒數的永久衍生資料表，篩選「Persistent Derived Tables」頁面。
    • 專案：根據指定 LookML 專案的永久資料表篩選「永久衍生資料表」頁面。
  3. 在第二個篩選器選取器中，選擇要用來篩選「Persistent Derived Tables」頁面的值。在「過去未觸發」或「過去觸發」選項中，輸入小時或分鐘數。針對「上次建立時間長度超過」選項，輸入秒數。
  4. 按一下「新增篩選器」新增更多篩選器，然後針對每個新增的篩選器重複執行步驟 2 和 3。
    • 如要清除篩選器選項並隨時重新開始，請按一下「全部清除」。
    • 如要移除任何個別額外篩選器，請找出要移除的篩選器，然後點選「清除」選項。
  5. 如要將所選篩選條件套用至「Persistent Derived Tables」頁面，請按一下「Apply」。

您會在「持續衍生資料表」頁面頂端看到已套用的篩選器。

在「Persistent Derived Tables」頁面上，按一下已套用篩選器旁的「X」，即可從「Persistent Derived Tables」頁面移除篩選器。按一下「全部清除」即可清除所有篩選條件。

瞭解「永久衍生資料表」頁面

以下各節說明「永久衍生資料表」頁面上的資訊。

「Production」和「Development」分頁

如果您是處於開發模式的 LookML 開發人員，則「Persistent Derived Tables」資料表會有兩個分頁：

  • 系統預設會選取「Production」分頁，並顯示實際運作環境的持續性資料表。這些是已部署至執行個體的生產環境的已保存資料表；這些已保存資料表會為使用者的探索查詢提供資料。(如果您處於正式版模式，或是沒有 develop 權限，則「Persistent Derived Tables」頁面不會顯示任何分頁，且只會顯示正式版持續性資料表的資訊)。

  • 「Development」分頁會顯示開發人員持續性資料表。開發人員持續存在的資料表尚未推送至正式環境。

當 LookML 開發人員在開發人員模式下進行變更，而這些變更會影響儲存資料表中的資料或查詢儲存資料表的方式時，Looker 會建立開發人員的儲存資料表。這些變更會促使 Looker 建立開發人員的持續性資料表，但除非在變更後查詢持續性資料表，否則 Looker 實際上不會建構該資料表。您可以透過「開發」分頁，瞭解 Looker 建立了哪些開發持續性表格，以及是否已建構這些表格。

如要進一步瞭解 Looker 建立開發持續性資料表的觸發條件，以及開發持續性資料表在資料庫中保留的時間長度，請參閱「Looker 中的衍生資料表」說明文件。

「資訊一覽」部分

「一覽無遺」部分會以視覺化方式摘要顯示已儲存資料表表格中顯示的已儲存資料表狀態。如果您已為表格定義篩選器，或是使用頁面頂端「所有連線」旁的箭頭，將表格縮小至特定連線，則「一覽無遺」部分會將結果縮小至與儲存表格表格中顯示的內容相符。

只要點選該區段頂端的關閉/開啟圖示，即可顯示或隱藏「資訊一覽」區段。

資料表資料欄

下列各節將說明「Persistent Derived Tables」頁面上的表格欄。您可以按一下「選取要顯示的資料欄」圖示，隱藏或顯示部分表格資料欄。詳情請參閱本頁的「自訂表格」一節。

PDT 名稱

「PDT Name」欄會顯示已儲存資料表的名稱，這項名稱是在已儲存資料表的 LookML 檢視檔案中 view 參數中定義。

在適用情況下，系統會在已儲存的資料表名稱下方顯示「PDT Name」欄中的這項額外資訊：

  • 「Old Build」表示該列顯示的是舊版已儲存資料表的版本資訊。如要進一步瞭解這則訊息，請參閱「選項」選單中的「PDT 詳細資料」對話方塊。
  • 「Incremental」表示已儲存的資料表是增量 PDT。
  • 「Materialized View」表示已儲存的資料表是資料庫中的具體化檢視表。

上次嘗試狀態

「Last Attempt Status」欄會顯示上次嘗試建構每個已列出的持續性資料表的狀態：

  • 「Regenerating」表示系統可以查詢已儲存的資料表，並正在建構更新的資料表。時間戳記：指出快取表格開始建構的時間。
  • 「Success」表示已成功建構已儲存的資料表。
  • 「Building」表示系統正在建構已儲存的資料表，在建構完成前無法查詢。
  • 「Not Built」表示未建構已儲存的資料表。
  • 「Build Error」表示在建構期間發生錯誤。如果您有查看 LookML 的適當權限，可以點選「Build Error」查看錯誤來源，並前往已儲存表格的 LookML。如要進一步瞭解如何針對「持續衍生資料表」頁面中的持續性資料表進行疑難排解，請參閱本頁的「選項選單」一節。

上次嘗試時間

「Last Attempted At」欄會顯示上次嘗試建構已儲存表格的時間。

上次成功的建構作業

「上次成功建構時間」欄會顯示上次成功建構已儲存表格的時間。

上次建構作業的持續時間

「最近一次建構作業的時間長度」欄會顯示該持續性資料表的最新建構作業所需的時間長度 (以秒為單位)，以及建構持續性資料表的平均時間長度 (以秒為單位)。

保留規則

「Persistence Rule」欄會顯示套用至已儲存資料表的儲存類型，如已儲存資料表的 LookML 定義所指定。這項屬性也會指出上次檢查成功建構的已儲存表格時間 (針對觸發事件類型已儲存表格)，或是上次檢查成功建構的已儲存表格到期時間 (針對已儲存類型已儲存表格)。「Persistence Rule」欄會顯示兩種持續性：

  • 如果是使用 persist_for 參數儲存的已儲存資料表，系統會顯示「Persist for: (time)」。
  • 如果是使用 datagroup_trigger 參數儲存的已儲存資料表，系統會顯示「Trigger: (datagroup name)」。您可以點選資料群組名稱連結，查看 datagroup 參數的 sql_trigger 值。
  • 如果永久性資料表是使用 sql_trigger_value 參數儲存，系統會顯示「觸發條件：SQL」。您可以點選連結查看 sql_trigger_value 陳述式。
  • 系統會針對materialized view 顯示「Materialized View」，這類資料檢視可利用資料庫的功能，在資料庫中儲存衍生資料表。

專案

「Project」欄會顯示定義已儲存資料表的 LookML 專案名稱。

連線

如果從連線選取畫面選取「All Connections」，系統會顯示「Connection」欄，並顯示啟用快照資料表的「connection」名稱。

模型

「Model」欄會顯示與已儲存資料表相關聯的模型檔案名稱。對於 PDT，這通常是包含 PDT 定義的檢視檔案的模型檔案。匯總表格通常是定義匯總表格的模型檔案。

選項選單

三點圖示的「選項」選單 特別適合用來排解非預期的行為。您可以透過這項資訊查看表格的上次建構時間、建構所需時間、最新建構時間與平均建構時間的比較結果，以及確認觸發條件是否正常運作。您可以選擇以下選項：

  • 前往 LookML：如果您具備查看 LookML 的適當權限，系統會開啟定義已儲存資料表的檢視表檔案。
  • PDT 活動資訊主頁：開啟 PDT 活動資訊主頁，系統會篩選出所選持久化資料表在過去四週內的活動。
  • PDT 詳細資料：開啟對話方塊，其中包含特定已儲存資料表的更多資訊和統計資料。詳情請參閱本頁的「PDT 詳細資料互動視窗」一節。

如需疑難排解提示，請參閱「Looker 中的衍生資料表」說明文件頁面中的「監控及疑難排解 PDT」一節。

PDT 詳細資料互動視窗

按一下已儲存表格的三點「選項」選單 中的「PDT 詳細資料」選項，即可查看 PDT 詳細資料對話方塊。

模式中的資訊取決於已儲存資料表的設定。以下是您可能會看到的資訊：

  • 資料表名稱：最近一次成功建構的持續性資料表的 雜湊值。
  • Model：模型檔案的名稱，其中包含已儲存資料表的檢視檔案。
  • 穩定名稱：如果已將已儲存的資料表發布為穩定的資料檢視，則為資料庫中已儲存資料表的穩定資料檢視名稱。您可以將已儲存的資料表發布為資料庫中的穩定檢視畫面，方法是將 publish_as_db_view: yes 陳述式新增至 PDT 或匯總資料表，或是使用 materialized_view: yes 陳述式將衍生資料表設為實體檢視畫面。
  • Connection：啟用已儲存資料表的連線名稱。
  • 舊版版本：布林值，如果版本是舊版的已儲存資料表版本，則顯示「是」，否則顯示「否」。
    • 資料表類型：在舊版本中，這個欄位會顯示資料表類型。值包括「舊版資料表」和「替代資料表」。
  • 增量 PDT：布林值，如果持續性資料表是增量 PDT，則顯示「是」；如果不是，則顯示「否」。
  • 狀態：提供上次嘗試狀態。如果建構作業失敗，系統會提供 SQL 錯誤訊息，以及模型 LookML 的連結 (如果使用者具備查看 LookML 的適當權限)。
  • 依附元件：按一下「顯示依附關係圖表」按鈕，即可顯示這個永久資料表依附的所有衍生資料表的關係圖表。圖表中的每個節點都對應至衍生資料表。每個節點的顏色會對應衍生表格的狀態，如下所示：
    • 綠色節點代表已成功建構的已儲存資料表。
    • 黃色節點代表正在建立或增加的已保存表格。
    • 紅色節點代表無法建構的已儲存資料表。
    • 灰色節點代表尚未建構的已儲存資料表。
    • 白色節點代表 Looker 不會建構的臨時衍生資料表。
  • 上次建構：
    • 最近一次成功建構時間：最近一次成功建構已儲存資料表的日期和時間。
    • 最新建構時間：最近一次建構持續性資料表所需的時間 (以秒為單位；如果尚未建構資料表，則會顯示 –)。
    • 平均建構時間長度：建構已儲存資料表的平均時間 (以秒為單位；如果資料表尚未建構，則會顯示 –)。
    • 建構原因：建構已儲存資料表的原因 (初始建構為inception；如果已儲存資料表是透過資料群組儲存，則為datagroup triggered；如果已儲存資料表的 SQL 觸發值已變更，則為trigger value change)。
    • 遞增索引鍵：針對使用遞增式建構作業的已快取資料表，適用的 increment_key 參數。
    • 遞增偏移量：針對使用遞增式建構的已儲存資料表的 increment_offset 參數。
    • 增量版本新增/移除的資料列：資料表上次增量時新增或移除的資料列數量 (如果資料表的持久化策略上次觸發增量時沒有新增或移除資料列，則會顯示 –)。
    • 上次嘗試的 SQL：用於查詢資料庫，以建立資料表上次版本的 SQL。
  • Persistence Rule：
    • 類型：表格使用的持久性類型。如要瞭解可能的值，請參閱本頁面的「持續性規則」欄。
    • Persist For：如果是「Persist」類型的永久資料表，則為永久保存時間值。不適用於 Trigger 類型的持續性資料表。
    • Datagroup：針對資料群組觸發事件的已儲存資料表，提供資料群組名稱。
    • SQL 程式碼區塊：如果是資料群組和 SQL 觸發事件持續存在的資料表，程式碼區塊會顯示觸發事件的 SQL 陳述式。對於資料群組觸發事件，這是資料群組的 sql_trigger 參數所需的 SQL。對於 SQL 觸發事件，這是 sql_trigger_value 參數的 SQL。
    • 觸發值：針對「觸發」類型的已儲存表格，顯示觸發已儲存表格建構作業的值 (如果已成功建構已儲存表格，且以 datagroup_trigger 儲存，則會顯示「–」；如要查看datagroup的最新觸發值，請參閱「管理」面板中的「資料群組」頁面)。
    • 上次檢查時間：針對「觸發條件」類型的持續性資料表，上次檢查觸發條件值的時間。
    • 到期時間：已快取的資料表到期時間 (如適用) (不適用於資料群組觸發條件)。

PDT 活動資訊主頁

PDT 活動資訊主頁會顯示已儲存資料表、重建作業和查詢的相關資訊。

PDT 活動資訊主頁預設會顯示過去四週的活動資訊。您可以使用資訊主頁頂端的篩選器列，變更顯示的時間範圍。PDT 活動資訊主頁包含顯示下列資訊的資訊方塊：

  • 已儲存資料表的摘要，其中包含定義已儲存資料表的 LookML 模型和檢視畫面名稱、已儲存資料表使用的資料庫連線名稱、已儲存資料表的成功和失敗建構嘗試次數總數，以及失敗的總建構嘗試次數百分比。
  • 上次完整重建已儲存資料表的日期和時間。
  • 如果持續性資料表是增量 PDT，則為 PDT 最新增量重建作業的日期和時間。
  • 如果已儲存的資料表是增量 PDT，則為自上次完整重建作業以來，增量重建作業的次數。
  • 重建已儲存資料表所需的平均時間。
  • 這張圖表顯示最近發生的所有建立事件，並依據造成事件的動作類型摘要分組。
  • 資訊主頁時間範圍內發生的所有已儲存資料表重建作業清單，包括每個重建作業的完成日期、每個重建作業所需的秒數、重建作業是否為增量建構作業、觸發每個重建作業的觸發事件，以及已儲存資料表建構作業的數量。
  • 所有失敗的重建嘗試清單，包括失敗的重建作業開始日期和時間、導致失敗的錯誤類型、錯誤訊息，以及建立失敗的次數。
  • 所有已儲存表格重建觸發事件的清單，包括事件 ID 編號、事件日期、事件類型，以及觸發事件所包含的資料。
  • 所有已儲存表格重建事件的清單，包括事件 ID 編號、事件日期、事件類型，以及重建事件所包含的資料。
  • 直接查詢欄位的查詢數量，並依查詢來源和每個查詢來源的平均執行時間分組。
  • 在已儲存資料表上執行的查詢總數。
  • 已查詢的所有已儲存表格欄位清單，包括定義欄位的 LookML 檢視畫面和模型、欄位名稱、包含該欄位的探索執行作業名稱，以及查詢中包含該欄位的次數。

探索 PDT 事件記錄檔

Looker 包含名為 system_activity 的預先建構模型，可用來探索 PDT 事件記錄，這是資料庫連線臨時架構中的資料表，可追蹤觸發事件和已儲存資料表的建構活動。

您可以透過「持續性衍生資料表」頁面「選項」三點選單 的「近期建構事件」和「近期觸發事件」連結，或從 Looker「管理」面板的「連線」頁面存取模型。

如要從「連線」頁面存取「PDT 事件記錄檔」探索功能，請為每個連線選取齒輪圖示下拉式選單 中的「顯示 PDT 事件記錄檔」選項。

您可以探索模型，就像使用其他 Looker 探索項目一樣。透過「連線」頁面存取時，系統會為整個連線篩選「PDT 事件記錄」探索。從「永久衍生資料表」頁面存取時，系統會針對特定永久資料表篩選「PDT 事件記錄」探索。

以下簡要說明 PDT 事件記錄檔探索功能中可用的欄位：

欄位說明
動作說明發生的動作，可能包括再生、放棄、建立和收割活動。

如要進一步瞭解如何查看及瞭解 PDT 記錄動作及其對應的動作資料，請參閱「解讀 PDT 記錄動作」說明文件。
動作資料提供動作的詳細資訊，包括所使用的觸發條件、觸發條件的值、持久性資料表的到期時間、重建的原因，以及錯誤訊息的文字。

如要進一步瞭解如何查看及瞭解 PDT 記錄動作及其對應的動作資料，請參閱「解讀 PDT 記錄動作」說明文件。
連線衍生表所在的連線名稱。
雜湊每個衍生表格都包含用來建立該表格的 SQL 雜湊值。
ID產生已儲存資料表的 Looker 例項專屬 ID。在許多情況下，只有一個 Looker 例項會指向資料庫，因此您只會看到一個 ID。不過，如果您有測試環境或類似的項目，可能會看到多個 ID。
模型名稱產生資料表的模型名稱。
發生日期事件發生的日期和時間。
發生時間 (UTC) 顯示日期事件發生的日期和時間 (以世界標準時間為準)。
順序已儲存資料表建構作業中的步驟編號。
短雜湊用於建立衍生資料表的 SQL 哈希值的截斷版本。
資料表名稱已儲存資料表的全名，包括資料表類型前置字串、雜湊和檢視表名稱。
Tid交易 ID。
檢視表名稱衍生表格的檢視表名稱。