財務模型套件

一個在 Metabase 中設定指標儲存庫，以建立您的新創公司財務模型的函式庫。

財務模型套件

財務建模套件將協助您在 Metabase 中設定指標儲存庫，您可以使用它來填入包含您的財務資料的範本試算表。

然後您可以使用該試算表來

• 追蹤營收和客戶數量的歷史指標。
• 預測成長並嘗試替代情境。

此套件採用MIT 授權條款，請盡情使用。

概觀

財務建模套件從您 Metabase 中的 Stripe 資料建立指標儲存庫，然後您可以使用它匯入我們的財務建模範本。

此套件使用 dap CLI（dap 是「資料產品」的縮寫），它會執行以下操作

• 從儲存在 PostgreSQL 資料庫中的 Stripe 資料建立一系列模型和問題。
• 透過公開連結以 CSV 格式提供某些 Metabase 問題的結果。

從那裡，您可以將該 CSV 資料匯入我們的財務模型範本，並擁有一個功能完整的試算表，以檢視歷史資料，並透過調整特定值來嘗試預測和情境建模。

財務建模套件的先決條件

為了讓 dap 命令發揮作用，您需要勾選相當多的方框

• MacOS 和 Homebrew。我們已在 MacOS 上使用 Homebrew 安裝所需的套件進行測試。
• Fivetran 擷取的 Stripe 資料。dap 預期 Stripe 資料具有特定的「形狀」，如同 Fivetran 擷取的一樣。
• PostgreSQL。該 Stripe 資料必須儲存在 PostgreSQL 資料庫中。
• Google 試算表。您需要存取 Google 試算表。

您還需要一個 Metabase 執行中並具有以下設定

• Metabase 的管理員電子郵件/密碼。dap create 命令需要管理員帳戶才能透過 Metabase 的 API 建立模型/問題。管理員帳戶必須使用電子郵件地址建立；使用 SSO 建立的管理員帳戶將無法運作。如果您使用 SSO，您可以簡單地建立一個額外的管理員帳戶，專門用於此用例。
• 公開分享已開啟。
• 您的 Metabase 必須可從網際網路存取（以便 Google 試算表可以從該 Metabase 匯入資料）。
• 模型持久性在您的 Metabase 中啟用。否則，您的指標將在 Google 試算表可以匯入它們之前逾時。

如您所見，這是一個非常特定的設定。但即使您不符合條件，您仍然可以透過瀏覽 repo 中的 SQL、我們的 財務建模範本的設定，以及我們關於 財務建模概念的資訊彙整來學到很多東西。

如何將您的資料放入財務模型範本

以下是您將執行的基本概觀

• 您將複製財務模型範本
• 複製財務建模套件 repo
• 安裝 repo 的依賴項
• 取得有關您的 Metabase 和 Stripe 資料的資訊
• 設定 Python 虛擬環境
• 執行 dap 命令並插入您的資訊
• 將 Metabase CSV URL 複製並貼到您的財務模型範本中

您可以選擇性地將自訂指標新增至工作表。

設定工作相當多，因此讓我們逐步完成。

複製財務模型範本

建立 財務模型範本的副本。在範本中，前往檔案 > 建立副本。

複製財務建模套件儲存庫

複製 財務建模套件 repo。

透過遵循 github.com 上的說明，或（如果您使用的是 MacOS）透過執行以下命令，透過 homebrew 套件管理器安裝 gh CLI

brew install gh

安裝完成後，執行以下命令來複製此 repo

gh repo clone metabase/financial-modeling-package

安裝依賴項

brew install python3 tox

取得有關您的 Metabase 和 Stripe 資料的資訊

• 您的 Metabase URL（您的 Metabase 的首頁）。
• Metabase 管理員電子郵件和密碼。SSO 帳戶將無法運作，因此您可能需要透過電子郵件和密碼建立管理員帳戶。
• Stripe 結構描述。Fivetran 擷取的 stripe 結構描述的名稱。它可能是「Stripe」，但您可能已將其命名為其他名稱。
• 包含該 Stripe 結構描述的資料庫的顯示名稱。在 Metabase 中，此名稱稱為顯示名稱——您在 Metabase 使用者介面中看到的資料庫名稱。

設定 Python 虛擬環境

從您複製的 financial-modeling-package 目錄中，執行

tox

然後

source .tox/data-products/bin/activate

執行 dap 命令

dap 將根據該資料建立大量模型，以及您可以匯入試算表的公開問題。

dap setup

依照提示並輸入資訊。輸入後，dap 將執行其操作，然後列印出

Created config.yml with a list of all Stripe products.

Please edit it to update the Stripe product names and indicate if it is a main product or not.
A main product will be included in the financial reports while other products will be
collapsed and aggregated as part of the main product in the same subscription.

Once done, run "dap create" to create the data models/questions in Metabase.

目前，只需將設定檔保持原樣即可。

建立設定檔後，執行

dap create

輸出將如下所示（儘管文字會指定 dap 在您的 Metabase 中建立這些模型和問題的位置）。

Creating models
        * Created new collection
        * Created new model Stripe Price
        * Created new model Stripe Subscription Item
        * Created new model Stripe Customer
        * Created new model Stripe Subscription
        * Created new model Monthly Trialers
        * Created new model Quarterly Trialers
        * Created new model Stripe Invoice
        * Created new model Revenue
        * Created new model Monthly Customers
        * Created new model Monthly ARR
        * Created new model Quarterly ARR
        * Created new model Quarterly Customers
        * Created new question Exported Quarterly Metrics
        - Publicly shared at [LINK]
        * Created new question Exported Latest Metrics
        - Publicly shared at [LINK]

Please copy the CSV URLs above and paste them into the **Inputs** sheet of the Financial Model template in the cells that say `<TODO: Add url>``

If the import times out, wait a few minutes for Metabase model/query caching to kick in, and then try again by deleting the URL followed by reverting.

前往您的 Metabase，您應該能夠找到 dap 建立的新集合，包括其模型和問題。選用：在您的集合上設定您想要的任何權限，因為預設情況下，該集合將可供所有使用者群組使用。

若要深入瞭解 dap 建立的模型，請查看我們對套件建立的指標儲存庫導覽。

將 Metabase CSV URL 複製並貼到您的財務模型範本中

複製 dap create 列印出的兩個公開問題 CSV 匯出 URL。

• 匯出的季度指標
• 匯出的最新指標

您也可以透過造訪 Metabase 中 dap 建立的集合中的問題本身來找到這些 URL。造訪問題並按一下螢幕右下角的分享按鈕，然後按一下 CSV 選項以建立公開連結。請確保您貼到試算表中的連結以 .csv 結尾。

前往您的財務模型範本 Google 試算表副本，按一下輸入標籤，然後將每個 URL 貼到適當的輸入儲存格中。

等待幾分鐘，並檢查財務模型範本工作表中的匯入進度

根據您的資料量，Google 試算表可能會逾時並取消其匯入。如果資料庫的查詢未在 100 秒內傳回結果，則可能會發生逾時。

這就是模型快取是必要條件的原因。一旦問題執行，Metabase 將快取結果，以便您下次執行問題時，Metabase 可以傳回預先計算的結果，並且財務模型範本將能夠在匯入逾時之前下載資料。

若要查看工作表的完整清單，請按一下範本左下角的漢堡選單。在列出的工作表中，您會看到三個隱藏的工作表（灰色顯示）

• _imported_latest_metrics
• _imported_quarterly_metrics
• _pivoted_quarterly_metrics

按一下這些隱藏的工作表以檢視進度。如果匯入成功，您應該會看到資料。

然後，_pivoted 工作表會樞紐分析匯入的資料，並使用季度作為欄。

避免刪除這些隱藏的工作表。否則，「實際」和「預測」工作表將無法運作。

如果您的匯入失敗

在 Metabase 有足夠的時間執行模型和問題並快取其結果之前，您的匯入可能會失敗。

如果您的匯入失敗，您需要

• 等待幾分鐘。
• 刪除您貼上的 CSV 連結。
• 將相關的 CSV URL 重新貼到指定的輸入儲存格中。

自訂指標

若要新增您自己的自訂時間序列指標

1. 建立一個新問題，以每個季度產生一個指標，每季度一行，包含以下 4 個欄位
   • quarter（季度的第一天日期）
   • quarter_name（例如，2023 年第 1 季）
   • metric（您想要在隱藏的 _pivoted 標籤中看到的名稱，以及在公式中引用的名稱）
   • value（指標的整數或浮點數值）。
2. 使用 union all，在匯出的季度指標問題（由 dap create 建立）的最後一個區塊中新增新問題。
3. 前往輸入標籤，刪除問題的對應 CSV URL，然後重新貼上以重新載入資料。載入後，您應該會在 _pivoted 工作表中看到新資料。
4. 前往實際工作表，然後
   • 將現有的指標複製到另一列。
   • 使用新的指標名稱更新第一個公式。
   • 拖曳公式以填滿其餘欄。