模型

模型是 Metabase 中的基本建構區塊。模型整理來自相同資料庫中另一個表格或多個表格的資料，以預測人們會針對資料提出的問題類型。您可以將它們視為衍生表格，或是一種特殊的已儲存問題，旨在用作新問題的起點。您可以將模型建立在 SQL 或查詢產生器問題之上，這表示您可以在模型中包含自訂的計算欄位。

模型

• 讓您可以更新欄位描述並自訂元數據，以建立絕佳的探索起點。
• 在搜尋結果中排名更高，並在其他使用者開始新問題時突出顯示，以促進重複使用。
• 存在於集合中，使其與雜亂的資料庫結構描述分開。
• 可以在搜尋結果中顯示個別記錄。
• 可以持久化以加快載入速度。

如需深入了解為何以及如何使用模型，請查看我們關於模型的「學習」文章。

如何使用模型

您可以使用模型來

• 建立，嗯，模型，此處的模型指的是您在業務中針對某些概念的直覺式描述，並將其編碼為一組欄位。模型範例可以是「客戶」，這是一個表格，它從多個表格中提取客戶資訊，並新增計算欄位，例如新增終身價值 (LTV) 欄位。此模型代表您認為與理解客戶相關的指標和維度。
• 讓使用者可以使用查詢產生器探索 SQL 查詢的結果 (前提是您已設定欄位類型)。
• 建立摘要表格，從多個表格中提取或彙總資料。
• 清理表格，移除不必要的欄位和篩選掉的列。

模型的想法是為其他人提供一個良好的「起點表格」，讓他們更容易回答關於塑模主題的任何問題。

建立模型

首先，搜尋已存在的模型。如果您找不到符合您需求的模型，您可以建立模型

• 從頭開始，或
• 從已儲存的問題.

您建立的模型會自動釘選到目前的集合。

從頭開始建立模型

1. 在右上角，按一下「新增 +」>「模型」。
2. 選擇查詢產生器或原生查詢 (如果您想使用 SQL)。使用查詢產生器的優點是 Metabase 將能夠為您填寫一些元數據；如果您使用 SQL，則必須手動填寫該元數據。
3. 選擇您的資料。
4. 建立並儲存您的查詢。

從已儲存的問題建立模型

1. 使用查詢產生器或 SQL 編輯器提出問題，或選取您要轉換為模型的現有已儲存問題。
2. 儲存問題。
3. 按一下「…」>「轉換成模型」。

模型詳細資訊

若要檢視模型的詳細資訊，請造訪模型並按一下右上角的「資訊」按鈕。您將在此處看到數個標籤

• 概觀：包含描述、建立者和最後編輯者，以及模型中包含的欄位清單。以及模型的實體 ID。
• 歷史記錄：列出模型的變更及其變更者。
• 關聯性：列出哪些問題使用該模型，以及該模型連結到哪些表格。
• 動作：列出根據模型建立的動作。
• 洞察：關於模型使用情況的資訊。僅對 Pro 或 Enterprise 方案的管理員可見。

將元數據新增至模型中的欄位

元數據是模型的秘密武器。當您撰寫 SQL 查詢時，Metabase 可以顯示結果，但它無法「知道」它傳回的資料類型 (就像使用查詢產生器建立的問題一樣)。這在實務上意味著使用者將無法使用查詢產生器探索結果，因為 Metabase 不了解結果是什麼。但是，透過模型，您可以告訴 Metabase 每個傳回的欄位中包含的資料類型，以便 Metabase 仍然可以執行其查詢魔法。元數據還將透過顯示正確的篩選器小工具使篩選更美觀，並且它將幫助 Metabase 為結果選擇正確的視覺化。

如果您只設定一種元數據，請設定「欄位類型」以讓 Metabase 知道它正在處理的資料類型。

顯示名稱

使用者將看到的欄位名稱。

描述

撰寫欄位實用背景資訊的地方。

此欄位對應到的資料庫欄位

對於基於 SQL 查詢的模型，您可以告訴 Metabase 欄位是否具有與現有資料庫欄位相同的類型。

欄位類型

您可以設定欄位類型。預設值為「無特殊類型」。

如果您的模型基於 SQL 查詢，並且您希望使用者能夠使用查詢產生器探索結果，則需要為模型中的每個欄位設定欄位類型。

此欄位應顯示在…

您可以指定欄位應顯示在表格檢視中，還是僅顯示在詳細資訊檢視中 (當您按一下列的實體/主鍵時)。

• 表格和詳細資訊檢視
• 僅詳細資訊檢視

顯示為

• 文字
• 連結 (使用者應可按一下的 URL)

透過比對此欄位在搜尋中顯示個別記錄

對於具有整數實體金鑰的記錄中的字串欄位，Metabase 將為您提供選項，使該欄位中的值在使用者搜尋您的 Metabase 時顯示出來。基本上，Metabase 將索引這些值，並使其可用於 Metabase 的搜尋引擎。當使用者經常想要直接跳到模型中的個別記錄時，此選項非常方便。

例如，如果您有一個包含帳戶的模型，則可以針對列出帳戶名稱或電子郵件的欄位開啟此選項，以便使用者可以從 Metabase 中的任何位置快速搜尋模型中的特定帳戶。當使用者按一下搜尋結果中的記錄時，Metabase 將直接跳到模型和該記錄的物件詳細資訊。

此索引有一些限制

• 索引欄位必須是文字/字串類型。
• 包含欄位的記錄必須具有整數實體金鑰。
• 為了保持搜尋速度，Metabase 只會索引該欄位中的 5000 個唯一值，因此對於包含大量記錄的表格，此選項並非最佳選擇。

編輯模型的查詢

您可以透過按一下模型名稱旁邊的向下箭頭，然後按一下「編輯查詢定義」來編輯模型的查詢。當您進行編輯時，請務必儲存變更。與問題不同，問題會提示您另存為新問題，此處的任何變更都會覆寫現有模型。如果您想從現有模型建立新模型，請從模型側邊欄 (兩個重疊正方形的圖示) 選取「複製此模型」。

從模型開始提問

請參閱「提出問題」。

在 SQL 查詢編輯器中參考模型

您可以在 SQL 查詢中參考模型，就像參考已儲存的問題一樣

SELECT * FROM {{#1-customer-model}}

或作為通用表格運算式 (CTE)

WITH model AS {{#3807-invoice-model}}
SELECT *
FROM model;

只需輸入 {{#}} 即可讓您搜尋模型 (例如，您可以輸入 {{#customer}} 來搜尋標題中包含「customer」一詞的模型、問題和表格)。

您也可以使用資料參考側邊欄來瀏覽可用的模型。若要開啟資料參考側邊欄，請按一下書籍圖示。

模型版本歷史記錄

對於問題、儀表板和模型，Metabase 會為該項目先前的十五個版本保留版本歷史記錄。您可以檢視變更並還原到先前的版本。

請參閱「歷史記錄」。

刪除模型

您可以將過時或不需要的模型移至垃圾桶，或將其永久刪除。刪除模型將會影響使用它作為資料來源的問題。

請參閱「刪除和還原項目」。

驗證模型

請參閱內容驗證。

模型持久化

請參閱模型持久性

延伸閱讀

• Metabase 中的模型
• 模型疑難排解.