跳到主要內容
在 GitHub 上編輯此頁面

建立您的第一個儀表板​

本節重點在於將 Superset 用於資料分析和探索工作流程的終端使用者（資料分析師、商業分析師、資料科學家等）的文件。除了本網站之外，Preset.io 還在 docs.preset.io 維護一套更新的終端使用者文件。

本教學課程針對想要在 Superset 中建立圖表和儀表板的人。我們將向您展示如何將 Superset 連接到新的資料庫，並設定該資料庫中的表格以進行分析。您還將探索您已公開的資料，並將視覺化效果新增至儀表板，讓您了解端對端的使用者體驗。

連接到新的資料庫​

Superset 本身沒有儲存層來儲存您的資料，而是與您現有的 SQL 資料庫或資料儲存配對。

首先，我們需要將您的資料庫連線憑證新增到 Superset 中，以便查詢和視覺化其中的資料。如果您是透過 Docker compose 在本機使用 Superset，則可以略過此步驟，因為名為 examples 的 Postgres 資料庫已包含在 Superset 中並已預先設定。

在右上角的 + 功能表中，選取「資料」，然後選取「連線資料庫」選項



然後在出現的模式視窗中選取您的資料庫類型



選取資料庫後，您可以在此視窗中設定許多進階選項，或者為了本逐步解說的目的，您可以按一下所有這些欄位下方的連結



請注意，如果您嘗試連線到另一個在本機執行的資料庫（無論是在主機上還是另一個容器中），並且收到訊息 The port is closed.，則您需要將 HOST 調整為 host.docker.internal

按一下該連結後，您只需要指定兩件事（資料庫名稱和 SQLAlchemy URI）



如表單下方的文字所示，您應參閱 SQLAlchemy 文件，了解如何為目標資料庫 建立新的連線 URI。

按一下 測試連線 按鈕以確認一切都正常運作。如果連線看起來良好，請按一下模式視窗右下角的 連線 按鈕來儲存設定

恭喜，您剛剛在 Superset 中新增了一個新的資料來源！

註冊新表格​

現在您已設定資料來源，您可以選取要在 Superset 中公開以進行查詢的特定表格（在 Superset 中稱為 資料集）。

瀏覽至 資料 ‣ 資料集，然後選取右上角的 + 資料集 按鈕。

前面應該會彈出一個模式視窗。使用出現的下拉式選單選取您的 資料庫、結構描述 和 表格。在以下範例中，我們註冊來自 examples 資料庫的 cleaned_sales_data 表格。

若要完成，請按一下右下角的 新增 按鈕。您現在應該會在資料集清單中看到您的資料集。

自訂欄屬性​

現在您已註冊資料集，您可以設定欄屬性，以設定如何在「探索」工作流程中處理欄

  • 欄是時間性的嗎？（是否應將其用於時間序列圖表中的切片和分割？）
  • 欄是否應可篩選？
  • 欄是否為維度？
  • 如果是日期時間欄，Superset 應如何剖析日期時間格式？（使用 ISO-8601 字串模式）

Superset 語意層​

Superset 有一個輕薄的語意層，可為分析師增加許多生活品質的改進。Superset 語意層可以儲存 2 種計算資料

  1. 虛擬指標：您可以撰寫 SQL 查詢，以彙總多個欄的值（例如 SUM(recovered) / SUM(confirmed)），並將其作為欄（例如 recovery_rate）提供，以便在「探索」中進行視覺化。允許使用彙總函式，且鼓勵用於指標。

如果您願意，也可以在此檢視中認證指標給您的團隊。

  1. 虛擬計算欄：您可以撰寫 SQL 查詢，以自訂特定欄的外觀和行為（例如 CAST(recovery_rate as float)）。不允許在計算欄中使用彙總函式。

在「探索」檢視中建立圖表​

Superset 有 2 個主要介面來探索資料

  • 探索：無程式碼的視覺化工具。選取您的資料集、選取圖表、自訂外觀並發佈。
  • SQL Lab：SQL IDE，用於清理、聯結和準備資料以用於「探索」工作流程

我們現在將重點介紹「探索」檢視，以建立圖表。若要從「資料集」索引標籤啟動「探索」工作流程，請先按一下將為您的圖表提供支援的資料集名稱。



現在您將看到一個強大的工作流程，用於探索資料和反覆運算圖表。

  • 左側的「資料集」檢視列出了範圍限定為您選取的目前資料集的欄和指標。
  • 圖表區域下方的「資料」預覽也提供有用的資料內容。
  • 使用「資料」索引標籤和「自訂」索引標籤，您可以變更視覺化類型、選取時間欄、選取要依其分組的指標，以及自訂圖表的美學。

當您使用下拉式選單自訂圖表時，請務必按一下 執行 按鈕以取得視覺回饋。

在以下螢幕擷取畫面中，我們只需按一下下拉式選單中的選項，即可製作一個分組時間序列長條圖，以視覺化我們的產品線季度銷售資料。

建立切片和儀表板​

若要儲存您的圖表，請先按一下 儲存 按鈕。您可以

  • 儲存您的圖表並將其新增至現有的儀表板
  • 儲存您的圖表並將其新增至新的儀表板

在以下螢幕擷取畫面中，我們會將圖表儲存到新的「Superset Duper 銷售儀表板」

若要發佈，請按一下「儲存並前往儀表板」。

在幕後，Superset 會建立一個切片，並將建立圖表所需的所有資訊儲存在其輕薄的資料層中（查詢、圖表類型、選取的選項、名稱等）。

若要調整圖表大小，請先按一下右上角的「編輯儀表板」按鈕。

然後，按一下並拖曳圖表的右下角，直到圖表版面配置貼齊到您喜歡的位置上，放到下方的網格上。

按一下 儲存 以持續變更。

恭喜！您已成功在 Superset 中連結、分析和視覺化資料。還有許多其他表格設定和視覺化選項，因此請開始探索並建立您自己的切片和儀表板

ֿ

管理儀表板的存取權​

儀表板的存取權是透過擁有者（具有儀表板編輯權限的使用者）來管理

非擁有者使用者的存取權可以透過兩種不同的方式管理

  1. 資料集權限 - 如果您將相關的角色權限新增至資料集，它會自動授予對使用這些允許資料集的所有儀表板的隱含存取權
  2. 儀表板角色 - 如果您啟用 DASHBOARD_RBAC 功能旗標，則您可以管理哪些角色可以存取儀表板
    • 授予角色存取儀表板的權限將會略過資料集層級的檢查。擁有儀表板存取權會隱含地授予對儀表板中所有特色圖表的讀取存取權，並因此也授予對所有相關資料集的讀取存取權。
    • 如果沒有為儀表板指定任何角色，則將套用一般的 資料集權限。

自訂儀表板​

可以使用以下 URL 參數來修改儀表板的呈現方式

  • 獨立:
    • 0 (預設)：正常顯示儀表板
    • 1：隱藏頂端導覽
    • 2：隱藏頂端導覽 + 標題
    • 3：隱藏頂端導覽 + 標題 + 頂層索引標籤
  • show_filters:
    • 0：呈現沒有篩選列的儀表板
    • 1 (預設)：如果啟用原生篩選器，則呈現具有篩選列的儀表板
  • expand_filters:
    • (預設)：如果存在原生篩選器，則呈現展開篩選列的儀表板
    • 0：以摺疊的篩選列呈現儀表板
    • 1：以展開的篩選列呈現儀表板

例如，在執行本地開發建置時，以下設定將停用頂部導覽列並移除篩選列：https://127.0.0.1:8088/superset/dashboard/my-dashboard/?standalone=1&show_filters=0