Looker Block をデプロイする

このページでは、パブリック GitHub リポジトリにある Cortex Framework 用の事前構築済み Looker Block をインストールする手順について説明します。たとえば、次のようなものがあります。

• Cortex 用 SAP
• Cortex 用 Salesforce Sales Cloud（SFDC）
• Cortex 用 Oracle EBS
• Cortex 用 Salesforce Marketing Cloud（SFMC）
• Cortex 用 Meta
• Cortex 用 YouTube（ディスプレイ＆ビデオ 360）
• Cortex 用のクロス メディアとプロダクトのコネクテッド インサイト

Dun & Bradstreet 用の Looker ダッシュボードのデプロイについては、 Dun & Bradstreet 用の データポータル ダッシュボードをご覧ください。

前提条件

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

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 を入力します。
   • Cortex 用 SAP
   • Cortex 用 Salesforce Sales Cloud（SFDC）
   • Cortex 用 Oracle EBS
   • Cortex 用 Salesforce Marketing Cloud（SFMC）
   • Cortex 用 Meta
   • Cortex 用 YouTube（ディスプレイ＆ビデオ 360）
   • Cortex 用のクロス メディアとプロダクトのコネクテッド インサイト
7. [インストール] をクリックします。
8. 利用規約のダイアログで [同意して続行] をクリックします。
9. データに対応する必須パラメータ を入力します。
   • 接続名
   • プロジェクト ID
   • レポート データセット
10. [インストール] をクリックします。

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

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

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

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

   1. 選択した Looker Block の GitHub リポジトリに移動します。
      • Cortex 用 SAP
      • Cortex 用 Salesforce Sales Cloud（SFDC）
      • Cortex 用 Oracle EBS
      • Cortex 用 Salesforce Marketing Cloud（SFMC）
      • Cortex 用 Meta
      • Cortex 用 YouTube（ディスプレイ＆ビデオ 360）
      • Cortex 用のクロス メディアとプロダクトのコネクテッド インサイト
   2. リポジトリの右上にある [フォーク] をクリックします。
   3. ユーザー名でフォークを作成します。これにより、GitHub アカウントにリポジトリのコピーが作成されます。

2. 空の LookML プロジェクトを作成する:

   **注:** Looker バージョン 24.20 より前の場合は、 空のプロジェクトを作成する を[新しいプロジェクト] ページからご覧ください。
   1. Development Mode になっていることを確認します。
   2. [Develop] メニューから [Projects] を選択します。

   3. [LookML プロジェクト] ページの左上にある [新しいモデルを構成] を選択して、[モデルを構成] ページを開きます。

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

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

         注: Looker では、モデル名が一意である必要があります。目的の名前のモデルがすでに存在する場合は、エラー メッセージが表示されます。インストール エラーを回避するため、モデル名が一意であることを確認してください。

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

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

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

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

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

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

      1. プロジェクト名: 前のステップで指定した値がすでに設定されています。
      2. [開始点]: [空のプロジェクト] を選択します。

   9. [プロジェクトを作成] を選択します。Looker でプロジェクトが作成され、 Looker IDEで開きます。

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

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

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

   1. Looker で、フォークされたリポジトリの manifest.lkml ファイルを開きます。
   2. 定数セクションを見つけて、 必須パラメータ セクションの説明に従って値を更新します。

5. 変更を commit して本番環境にデプロイする 。フォークされたリポジトリに基づく Looker プロジェクトを使用すると、独自のビジネスニーズに合わせて LookML をカスタマイズできます。本番環境に対する変更の取得の手順に沿って操作します。

必須パラメータ

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

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

Block 固有の追加要件

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

<th">Block <th">追加要件へのリンク </th"></th"><td"> SAP <td">Cortex Framework Looker Block for SAP の追加仕様。 </td"></td"><td"> Oracle EBS <td">Cortex Framework Looker Block for Oracle EBS の追加仕様。 </td"></td">

その他のリソース

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

• Looker のベスト プラクティス
• Looker Google Cloud Training