Looker Blocks をデプロイする

このページでは、一般公開されている GitHub リポジトリにある Cortex Framework 用に事前構築された Looker ブロックをインストールする手順について説明します。

Dun & Bradstreet 向けの Looker ダッシュボードをデプロイする方法については、Dun & Bradstreet 向けの Looker Studio ダッシュボードをご覧ください。

前提条件

これらの事前構築済みダッシュボードにアクセスして使用するには、事前に次の操作を行う必要があります。

  1. Cortex Framework をデプロイする: Cortex Framework がデータソースで設定されていることを確認します。詳細については、デプロイ用の Cortex Framework の前提条件をご覧ください。
  2. Looker にアクセスする: Looker にアクセスして、プラットフォームに慣れ親しみます。
  3. 利用可能なダッシュボードを確認する: 事前構築済みのダッシュボードと、デプロイするダッシュボードで利用可能な分析情報を確認します。詳細については、使用可能な Looker Block をご覧ください。

前提条件を完了したら、Looker Block をインストールする準備が整います。

インストール

Looker Block は LookML(Looker モデリング言語)を使用して、Looker ダッシュボードのセマンティック モデルを定義します。Cortex データソースに対応する LookML モデルをインストールするには、次のいずれかのオプションを使用します。

  • オプション A: Git URL から Looker Marketplace 経由でインストールします。
  • オプション B: リポジトリをフォークしてインストールします。

以降のセクションでは、各オプションの手順について説明します。

オプション A: Git URL から Looker Marketplace 経由でインストールする

Looker Marketplace は、Looker Blocks、アプリケーション、ビジュアリゼーション、プラグインの検出、デプロイ、管理を行うための Looker 内の一元的な場所です。Git URL から Looker Marketplace 経由でインストールする手順は次のとおりです。

  1. Looker インスタンスに移動します。
  2. Looker のメニューバー で [Marketplace] ボタンをクリックします。
  3. Marketplace メニューから [管理] オプションを選択します。
  4. [管理] ページで、三点アイコンの [オプション] メニュー を選択します。
  5. [Git URL を介してインストール] ボタンを選択します。
  6. 選択したリポジトリの URL と commit SHA を入力します。
  7. [インストール] をクリックします。
  8. 利用規約ダイアログで [同意して続行] をクリックします。
  9. データに対応する必須パラメータを入力します。
    • 接続名
    • プロジェクト ID
    • レポート データセット
  10. [インストール] をクリックします。

詳細については、Looker のドキュメントでGit URL からツールをインストールするをご覧ください。

オプション B: リポジトリをフォークしてインストールする

リポジトリをフォークして Looker ブロックをインストールする手順は次のとおりです。

  1. GitHub リポジトリをフォークする:

    1. 選択した Looker ブロックの GitHub リポジトリに移動します。
    2. リポジトリの右上にある [フォーク] をクリックします。
    3. ユーザー名でフォークを作成します。これにより、GitHub アカウントにリポジトリのコピーが作成されます。
  2. 空の LookML プロジェクトを作成する:

    1. Development Mode になっていることを確認します
    2. [開発] メニューから [プロジェクト] を選択します。
    3. [LookML プロジェクト] ページの左上にある [新しいモデルを構成] を選択して、[モデルを構成する] ページを開きます。

    4. [Configure a Model] ページで、モデルのオプションを指定します。

      1. モデル: リポジトリ内の model.lkml ファイルと同じ名前でモデルに名前を付けます。たとえば、モデルに cortex-<datasource> という名前を付けます。

      2. プロジェクト: プロジェクトに名前を付けます。モデルと同じ名前にするか、別の名前を指定します。

      3. Allowed Connections: モデルで使用できるデータベース接続を指定するか、モデルが現在または将来の任意の接続を使用できるように指定します。

    5. [保存] をクリックして、プロジェクトを保留中のプロジェクトとして保存します。

    6. [LookML プロジェクト] ページで、[保留中のプロジェクト] セクションで新しいプロジェクトを見つけます。

    7. [LookML を追加する] をクリックして [新しいプロジェクト] ページを開きます。

    8. [新しいプロジェクト] ページで、プロジェクトのオプションを指定します。

      1. プロジェクト名: 前の手順で指定した値がすでに入力されています。
      2. 開始点: [空のプロジェクト] を選択します。
    9. [プロジェクトを作成] を選択します。Looker でプロジェクトが作成され、Looker IDE で開きます。

    詳細については、元の Looker ドキュメントの LookML モデルの生成をご覧ください。

  3. 新しい LookML プロジェクトをフォークされたリポジトリに接続する: Looker のドキュメントの Git 接続の設定とテストの手順に沿って操作します。

  4. manifest.lkml ファイル内の定数の値を更新します

    1. フォークされたリポジトリの manifest.lkml ファイルを Looker で開きます。
    2. 定数セクションを見つけて、必須パラメータのセクションの説明に沿って値を更新します。
  5. 変更を commit して本番環境にデプロイします。フォークしたリポジトリに基づく Looker プロジェクトを使用すると、独自のビジネスニーズに合わせて LookML をカスタマイズできます。本番環境に対する変更の取得の手順に沿って操作します。

必須パラメータ

これらの必須値は、Marketplace のインストール プロセス中に構成されます。または、このブロックがフォークされた Git リポジトリからインストールされた場合は、プロジェクトの manifest.lkml ファイルでこれらの定数の値を更新する必要があります。

パラメータ 説明 Looker Blocks
Connection Name 接続の名前 Looker が Cortex REPORTING データセットをクエリできるようにする BigQuery 接続名。を有効にする必要があります。 すべて
Project ID Project ID レポート データセットが BigQuery にある Google Cloud プロジェクト。詳細については、プロジェクトの識別をご覧ください。 すべて
Reporting Dataset レポート用のデータセットの名前 デプロイされた Cortex Data Foundation REPORTING データセット。データソース データセット ビューは Google Cloud BigQuery プロジェクト内にあります。Cortex Data Foundation のデプロイ設定に応じて、このデータセット名は通常、_REPORTING で終わるパターンになります。 すべて
Client SAP クライアント番号(mandt レポートに使用する SAP クライアント番号(mandt)。 SAP
Sign Change Yes または No 損益計算書のレポートでは、収益は通常、クレジットを示す負の数値として総勘定元帳に表示されます。符号変更の値を Yes に設定すると、損益計算書レポートに正の数値として表示されます。 SAP

ブロック固有の追加要件

一部のブロックには、デプロイに関する特定の要件があります。詳細については、ブロック固有のデプロイをご覧ください。

ブロック その他の要件へのリンク
SAP SAP 向け Cortex Framework Looker Block の追加仕様
Oracle EBS Oracle EBS 用の Cortex Framework Looker ブロックの追加仕様

その他のリソース

LookML の詳細については、次のドキュメントとトレーニングをご覧ください。