部署 Looker 块

本页介绍了安装位于公共 GitHub 代码库中的 Cortex Framework 预构建 Looker 块的步骤，例如：

• SAP for Cortex
• 适用于 Cortex 的 Salesforce Sales Cloud (SFDC)
• 适用于 Cortex 的 Oracle EBS
• 适用于 Cortex 的 Salesforce Marketing Cloud (SFMC)
• Cortex 的元数据
• 适用于 Cortex 的 YouTube（使用 DV360）
• 适用于 Cortex 的跨媒体和产品关联数据分析

如需部署适用于 Dun & Bradstreet 的 Looker 信息中心，请参阅 适用于 Dun & Bradstreet 的 Looker Studio 信息中心。

前提条件

如需访问和使用这些预构建信息中心，您需要先执行以下操作：

1. 部署 Cortex Framework：确保您已设置 Cortex Framework 并将其与数据源配置完毕。如需了解详情，请参阅 Cortex 框架部署前提条件。
2. 访问 Looker：访问 Looker 并熟悉该平台。
3. 探索可用的信息中心：探索您要部署的信息中心中的预构建信息中心和可用数据洞见。如需了解详情，请参阅可用的 Looker 块。

完成前提条件后，您就可以安装 Looker 块了。

安装

Looker Blocks 使用 LookML（Looker 建模语言）定义 Looker 信息中心的语义模型。如需安装与您的 Cortex 数据源对应的 LookML 模型，请使用以下选项之一：

• 方法 A：通过 Looker Marketplace 从 Git 网址安装。
• 选项 B：通过分叉代码库进行安装。

以下部分介绍了每种选项的步骤。

选项 A：通过 Looker Marketplace 使用 Git 网址安装

Looker Marketplace 是 Looker 中的中心位置，可用于查找、部署和管理 Looker 组成块、应用、可视化图表和插件。如需通过 Looker Marketplace 从 Git 网址安装，请按以下步骤操作：

1. 前往您的 Looker 实例。
2. 点击 Looker 菜单栏 上的 Marketplace 按钮。
3. 在“Marketplace”（市场）菜单中，选择 Manage（管理）选项。
4. 在管理页面上，选择三点状图标 Options 菜单 。
5. 选择通过 Git 网址安装按钮。
6. 输入所选代码库的网址和提交 SHA：
   • SAP for Cortex
   • 适用于 Cortex 的 Salesforce Sales Cloud (SFDC)
   • 适用于 Cortex 的 Oracle EBS
   • 适用于 Cortex 的 Salesforce Marketing Cloud (SFMC)
   • Cortex 的元数据
   • 适用于 Cortex 的 YouTube（使用 DV360）
   • 适用于 Cortex 的跨媒体和产品关联数据分析
7. 点击安装。
8. 在条款及条件对话框中，点击“同意并继续”。
9. 输入与您的数据对应的必需参数：
   • 连接名称
   • 项目 ID
   • 报告数据集
10. 点击安装。

如需了解详情，请参阅 Looker 文档，了解如何通过 Git 网址安装工具。

选项 B：通过分叉代码库进行安装

如需通过分叉代码库来安装 Looker 块，请按以下步骤操作：

1. 为 GitHub 代码库创建分支：

   1. 前往所选 Looker 代码块的 GitHub 代码库：
      • SAP for Cortex
      • 适用于 Cortex 的 Salesforce Sales Cloud (SFDC)
      • 适用于 Cortex 的 Oracle EBS
      • 适用于 Cortex 的 Salesforce Marketing Cloud (SFMC)
      • Cortex 的元数据
      • 适用于 Cortex 的 YouTube（使用 DV360）
      • 适用于 Cortex 的跨媒体和产品关联数据分析
   2. 点击代码库右上角的创建分支。
   3. 使用您的用户名创建一个分支。这会在您的 GitHub 账号中创建该代码库的副本。

2. 创建一个空白 LookML 项目：

   注意： 对于 24.20 之前的 Looker 版本，请参阅“新建项目”页面中的创建空白项目
   1. 确认您处于开发模式。
   2. 从 Develop 菜单中选择 Projects。

   3. 在 LookML 项目页面的左上角，选择配置新模型以打开配置模型页面。

   4. 在配置模型页面上，为模型指定选项：

      1. 模型：请为模型命名，并使用代码库中的 model.lkml 文件的名称。例如，将模型命名为 cortex-<datasource>。

         注意 ：Looker 会强制执行唯一的模型名称。如果具有预期名称的模型已存在，系统会显示错误消息。确保模型名称唯一，以免安装失败。

      2. Project（项目）：为项目命名。您可以为其命名为与模型相同的名称，也可以指定其他名称。

      3. 允许的连接：指定模型可以使用哪些数据库连接，或指定允许模型使用任何当前或未来的连接。

   5. 点击保存，将项目另存为待处理项目。

   6. 在 LookML 项目页面中，找到待处理的项目部分下的新项目。

   7. 点击 Add LookML（添加 LookML）以打开 New Project（新建项目）页面。

   8. 在“新建项目”页面上，为您的项目指定选项：

      1. 项目名称：已填充上一步中指定的值。
      2. 起始代码：选择空白项目。

   9. 选择创建项目。Looker 会创建项目并在 Looker IDE 中打开该项目。

   如需了解详情，请参阅有关生成 LookML 模型的原始 Looker 文档。

3. 将新的 LookML 项目连接到分叉的代码库：请按照 Looker 文档中的设置和测试 Git 连接部分中的步骤操作。

4. 更新 manifest.lkml 文件中的常量值：

   1. 在 Looker 中打开分支代码库中的 manifest.lkml 文件。
   2. 找到“常量”部分，然后按照必需参数部分中的说明更新值。

5. 提交更改并将其部署到生产环境。借助基于分叉代码库的 Looker 项目，您可以自定义 LookML 以满足您的独特业务需求。请按照将更改发布到正式版中的步骤操作。

必需参数

这些必需值在 Marketplace 安装过程中进行配置；如果此屏幕块是从分叉的 Git 代码库安装的，则您需要在项目的 manifest.lkml 文件中更新这些常量的值。

参数	值	说明	Looker 块
Connection Name	连接的名称	允许 Looker 查询 Cortex REPORTING 数据集的 BigQuery 连接名称。 必须启用。	所有
Project ID	项目 ID	报告数据集在 BigQuery 中所在的 Google Cloud 项目。如需了解详情，请参阅标识项目。	所有
Reporting Dataset	用于报告的数据集的名称	已部署的 Cortex Data Foundation 报告数据集，其中数据源数据集视图位于 Google Cloud BigQuery 项目中。根据 Cortex Data Foundation 的部署设置，此数据集名称通常采用以 _REPORTING 结尾的模式。	所有
Client	SAP 客户端编号 (mandt)	用于报告的 SAP 客户端编号 (mandt)。	SAP
Sign Change	Yes 或 No	对于损益表/收入表报告，收入通常在总账中显示为负数，表示贷记。将“Sign Change”值设置为 Yes 后，该值会在收入表报告中显示为正数。	SAP

其他特定于版块的要求

某些代码块在部署时有特定的要求。如需了解详情，请参阅特定于块的部署：

屏蔽	指向其他要求的链接
SAP	适用于 SAP 的 Cortex Framework Looker Block 的其他规范。
Oracle EBS	适用于 Oracle EBS 的 Cortex Framework Looker 块的其他规范。

其他资源

如需详细了解 LookML，请参阅以下文档和培训：

• Looker 最佳实践
• Looker Google Cloud 培训