部署 Looker 模塊

本頁面說明如何安裝預先建構的 Cortex Framework Looker 區塊,這類區塊位於公開的 GitHub 存放區,例如:

如要部署鄧白氏集團的 Looker 資訊主頁,請參閱「鄧白氏集團的 Looker Studio 資訊主頁」。

必要條件

如要存取及使用這些預先建構的資訊主頁,請先完成下列步驟:

  1. 部署 Cortex Framework:請確認您已設定 Cortex Framework,並已設定資料來源。詳情請參閱部署 Cortex Framework 的必要條件
  2. 存取 Looker:存取 Looker 並熟悉這個平台。
  3. 探索可用的資訊主頁:探索預先建構的資訊主頁,以及您要部署的資訊主頁中可用的洞察資訊。詳情請參閱「可用的 Looker Blocks」。

完成事前準備後,即可安裝 Looker Block。

安裝

Looker Blocks 使用 LookML (Looker 模型語言) 定義 Looker 資訊主頁的語意模型。如要安裝與 Cortex 資料來源對應的 LookML 模型,請使用下列任一選項:

  • 選項 A:透過 Git 網址從 Looker Marketplace 安裝。
  • 方法 B:透過分叉存放區安裝。

以下各節將說明每個選項的步驟。

選項 A:透過 Git 網址從 Looker Marketplace 安裝

Looker Marketplace 是 Looker 中的集中位置,可供您尋找、部署及管理 Looker 模塊、應用程式、圖表和外掛程式。如要透過 Looker Marketplace 從 Git 網址安裝,請按照下列步驟操作:

  1. 前往 Looker 執行個體。
  2. 按一下 Looker 選單列 上的「Marketplace」按鈕。
  3. 從 Marketplace 選單中選取「管理」選項。
  4. 在「管理」頁面中,選取三點「選項」選單
  5. 選取「透過 Git 網址安裝」按鈕。
  6. 輸入所選存放區的網址和提交 SHA:
  7. 按一下 [安裝]
  8. 在條款及細則對話方塊中,點選「同意並繼續」。
  9. 輸入與資料相符的必要參數
    • 連線名稱
    • 專案 ID
    • 報表資料集
  10. 按一下 [安裝]

詳情請參閱 Looker 說明文件中的「從 Git 網址安裝工具」。

方法 B:透過分叉存放區安裝

如要透過分叉存放區安裝 Looker 區塊,請按照下列步驟操作:

  1. 建立 GitHub 存放區分支

    1. 前往所選 Looker Block 的 GitHub 存放區:
    2. 按一下存放區右上角的「Fork」(分支)
    3. 使用您的使用者名稱建立 Fork。這樣一來,您 GitHub 帳戶中就會有存放區副本。
  2. 建立空白 LookML 專案

    1. 確認你處於開發模式
    2. 從「Develop」選單中選取「Projects」
    3. 在「LookML 專案」頁面左上方,選取「設定新模型」,開啟「設定模型」頁面。

    4. 在「設定模型」頁面中,指定模型的選項:

      1. 模型:將模型命名為存放區中 model.lkml 檔案的名稱。例如將模型命名為 cortex-<datasource>

      2. 專案:為專案命名,您可以將其命名為與模型相同的名稱,也可以指定其他名稱。

      3. 允許的連線:指定模型可使用的資料庫連線,或指定模型可使用目前或日後的任何連線。

    5. 按一下「儲存」,將專案儲存為「待處理專案」

    6. 在「LookML Projects」頁面中,找出「Pending Projects」部分的新專案。

    7. 按一下「新增 LookML」,開啟「新專案」頁面。

    8. 在「New Project」頁面中,指定專案的選項:

      1. 專案名稱:已填入先前步驟中指定的值。
      2. 起點:選取「空白專案」
    9. 選取「建立專案」。Looker 會建立專案,並在 Looker IDE 中開啟。

    詳情請參閱原始 Looker 說明文件,瞭解如何產生 LookML 模型

  3. 將新的 LookML 專案連結至分支存放區:按照 Looker 說明文件中的步驟操作,請參閱「設定及測試 Git 連線」。

  4. 更新 manifest.lkml 檔案中的常數值

    1. 在 Looker 中開啟存放區分支版本中的 manifest.lkml 檔案。
    2. 找出常數部分,然後按照「必要參數」一節的說明更新值。
  5. 將變更提交並部署至正式環境。您可以使用以已分叉存放區為基礎的 Looker 專案,自訂 LookML 來滿足獨特的業務需求。請按照「將變更發布至正式版」一文中的步驟操作。

必要參數

這些必要值會在 Marketplace 安裝程序中設定,如果這個 Block 是從已分岔的 Git 存放區安裝,您需要更新專案 manifest.lkml 檔案中這些常數的值。

參數 說明 Looker Blocks
Connection Name 連線名稱 BigQuery 連線名稱,可讓 Looker 查詢 Cortex REPORTING 資料集。必須啟用。 全部
Project ID 專案 ID 報表資料集在 BigQuery 中的 Google Cloud 專案。詳情請參閱「識別專案」。 全部
Reporting Dataset 用於產生報表的資料集名稱 已部署的 Cortex Data Foundation 報表資料集,其中資料來源資料集檢視畫面位於 Google Cloud BigQuery 專案中。視 Cortex 資料基礎的部署設定而定,這個資料集名稱通常會採用以「_REPORTING」結尾的模式。 全部
Client SAP 客戶號碼 (mandt) 用於報表的 SAP 用戶端編號 (mandt)。 SAP
Sign Change YesNo 在損益/收益表報表中,收益通常會以負數顯示在總帳中,表示為貸方。將「符號變更」值設為 Yes,收益表報表就會顯示正數。 SAP

其他區塊專屬規定

部分區塊的部署作業有特定規定。詳情請參閱特定區塊的部署作業:

封鎖 附加規定連結
SAP SAP 適用的 Cortex Framework Looker Block 其他規格
Oracle EBS Oracle EBS 適用的 Cortex Framework Looker Block 其他規格

其他資源

如要進一步瞭解 LookML,請參閱下列說明文件和訓練課程: