使用规则文件构建维并加载数据

使用规则，您可以构建维并从文本文件或其他平面文件加载数据。

在开始之前，您需要以下资源。

  • 对 Essbase 实例的访问权限。

  • 如果您未使用平面文件作为数据源，则需要使用已经在 Essbase 的应用程序级别设置的连接和数据源。

  • 已下载到您的计算机的维元数据文件（示例练习文件：dim-market.txt）。

  • 已下载到您的计算机的数据文件（示例练习文件：data-basic.txt）。

使用列出的资源，您现在可以使用规则执行构建维以及加载数据的任务。

使用规则文件构建维

您可以使用规则编辑维并将其映射到 Essbase 大纲，而不需要手动在 Essbase 大纲编辑器中构建空维。在本部分中，我们将使用规则通过一个平面文件来解决维的构建，并通过示例来说明此过程。

使用规则进行构建时，您将定义维和成员元数据的层次结构。您可以使用单个规则文件创建一个或多个维，也可以为每个维使用一个规则文件。

您可以通过构建维来添加或修改维，但不能使用它来删除现有的维。

此处，我们展示的示例说明了如何使用规则通过一个平面文件构建维。使用 SQL 或通过流式传输来加载数据的过程在其他主题中进行了介绍。

  1. 在带格式的文本编辑器中打开下载的维元数据文件 dim-market.txt。请注意，此文件中没有标题行，且文件分隔符为逗号。
  2. 登录到 Essbase Web 界面。
  3. 在主页上，展开 Sample 应用程序并选择 Basic 多维数据集。
  4. 现在，创建规则文件。
    1. 从多维数据集右侧的操作菜单，启动检查器。
    2. 单击脚本，然后单击规则。此时将显示规则编辑器，其中显示当前定义的规则。
    3. 单击创建，选择维构建（基于索引）来定义构建维规则。基于索引的构建维规则删除字段彼此之间的依赖关系并允许字段以任何顺序出现。
    4. 在“新建规则”对话框中，输入 Dim_market1 作为规则文件的名称。
    5. 在“预览数据”下，选择文件作为平面文件输入选项。
    6. 单击浏览图标，找到您下载的文件 dim-market.txt 并单击打开以选择它。
    7. 如您之前所见，平面文件的第一行未包含标题值。取消选中标题行复选框（如果已选中）。
    8. 根据文件格式将分隔符值指定为逗号。
    9. 单击继续。
      现在，您可以在规则编辑器中预览维结构，列将根据输入平面文件显示。
    规则编辑器的右上角工具栏显示规则的“全局”选项。您可以在此处更改属性或数据源，以及查看结果。规则编辑器的左侧工具栏显示规则的“字段”选项。
  5. 在规则编辑器页面上，您现在可以设置和编辑规则。
    1. 在新规则的预览页面上，在第一个字段（列）中，单击维，并选择 Market 作为维名称。Market 维现在已分配给所有字段。
    2. 在 Market 下，在第一个字段中，单击类型，选择维类型父级。
      此规则的源文件采用父-子格式。如果您有基于层代的源文件，则可以将第一个字段设置为“层代”。在这种情况下，“层代编号”设置为 2，因为默认情况下层代 1 是维自身。
    3. 设置其他字段：
      将字段 2 类型设置为子级。
      将字段 3 类型设置为属性，将第三行的“父级/子级”框设置为子级。
      对于字段 4 和 5，将类型设置为 UDA，将第三行的“父级/子级”框设置为子级。
      对于字段 6-9，将类型设置为别名，将第三行的“别名”框分别设置为 ChineseNames、JapaneseNames、RussianNames 和 GermanNames；将第四行的框设置为子级。
      将字段 10 类型设置为属性成员，将第三行的框设置为填充，将第四行的框设置为子级。
      “维”字段通常设置为“层代”、“父级”或“子级”。如果您所需的维名称不在菜单中，请单击维（在“全局”工具栏上），添加维名称，然后单击添加和确定。
    4. 现在，检查字段的字段属性。选择最后一个字段列填充。在“字段”选项工具栏上，打开属性选项卡并确认“大小写”选项设置为无操作 > 这意味着在此处不会以与源文本文件中不同的方式处理大写和小写文本。
    5. 在“全局”工具栏中，如果希望更改数据源文件，请单击源选项卡。在“文件属性”选项卡上，验证“分隔符”是否设置为逗号。
    6. 完成规则定义后，在“全局”工具栏中单击验证以验证规则语法。
    7. 单击保存和关闭。
    8. 单击刷新。查看您创建的规则现在是否在“脚本”选项卡的“规则”窗格中列出。可以通过单击规则名称并单击继续来编辑您的规则。
      从列出的规则的操作菜单中，您还可以复制、重命名或导出维构建（导出到 json 文件中以用于故障排除）。单击关闭以返回到主页。
  6. 接下来，您创建并运行一个作业来使用规则构建维。
    1. 在主页上，选择作业，然后选择新建作业。
    2. 选择构建维。
    3. 在构建维对话框中，从应用程序列表中选择 Sample 应用程序。
    4. 在数据库列表中，选择 Basic 多维数据集。加载可能需要一段时间。
    5. 在脚本列表中，选择您创建的构建维规则 Dim_market1.rul。
    6. 对于加载类型，选择文件。
    7. 在数据文件列表中，选择 Dim_Market 作为数据维数据文件。此文件位于 Sample 下的 Basic 文件夹中。
    8. 从重建选项列表中，针对您希望保留的数据选择保留输入数据选项。

      如果希望将已连接到 Sample 中的 Basic 多维数据集的其他用户断开连接，以便您可以立即构建维，可以选择强制构建维。

      对于叶级别数据，只会保留级别 0 的值。如果计算所需的全部数据位于级别 0 成员中，请使用此选项。对于输入数据，仅会保留包含正在加载的数据的块。任一选项都不适用于聚合存储数据库。

    9. 单击确定。此时将执行构建维作业。
    10. 在作业页上，单击刷新以监视作业状态。
    11. 在作业完成时，单击所执行作业的操作菜单，并选择作业详细信息来验证您的构建作业的状态。
    12. 在“应用程序”主页上，在 Sample 应用程序中的 Basic 多维数据集右侧，打开操作，然后打开大纲来验证维层次。在操作、数据库、检查中，还可以在维选项卡下查看已创建的层代名称。完成后，退出视图。
    您现在已完成了使用规则构建维。

使用规则文件加载数据

您可以使用规则来提取、转换数据值并将其加载到 Essbase 多维数据集中。源数据值可以包含以下项：

  • 数据值

  • 成员名称、别名和公式

  • 层代和级别名称

  • 数据存储属性

  • 属性和用户定义的属性

在构建 Essbase 多维数据集时，会在多维数据集目录中创建数据文件和数据加载规则文件。您还可以使用受支持的 Essbase 内部部署版中的数据和规则。

透视表数据和行集平面文件数据格式都受支持。

加载数据时，支持跨行对数据列执行 SUM、MIN、MAX、AVG 和 COUNT 运算。这将支持在创建的 Essbase 多维数据集中包含较高级别成员的大数据用例。您可以从 Essbase 穿透钻取以查看更细粒度级别的数据。

此处，我们展示的示例说明了如何使用规则从平面文件加载数据。使用 SQL 或通过流式传输来加载数据的过程在其他主题中进行了介绍。

  1. 在带格式的文本编辑器中打开下载的数据文件 data-basic.txt。请注意，此文件中没有标题行，且文件分隔符为逗号。
  2. 登录到 Essbase Web 界面。
  3. 在主页上，展开 Sample 应用程序并选择 Basic 多维数据集。
  4. 现在，创建加载规则。
    1. 从 Basic 多维数据集右侧的操作菜单，启动检查器。
    2. 选择脚本选项卡，然后选择规则。此时将显示规则编辑器，其中显示当前定义的规则。
    3. 单击创建，并选择数据加载来定义加载数据规则。
    4. 在新建规则对话框中，输入 Data_basic1 作为规则名称。
    5. 输入 Measures 作为数据维。
    6. 在“预览数据”下，选择文件作为平面文件输入。
    7. 单击浏览图标来查找您下载的 data-basic.txt 文件，并单击打开以选择它。
    8. 如您之前所见，平面文件的第一行未包含标题值。取消选中标题行复选框（如果已选中）。当存在标题行时，将自动映射列。
    9. 根据文件格式选择逗号作为分隔符值。
    10. 单击继续。
      现在，您可以在规则编辑器中查看数据的预览。数据将根据输入平面文件显示。
    使用规则编辑器右上角的“全局”选项工具栏，可以修改文件属性或数据源，并在规则编辑器中查看结果。使用规则编辑器左侧的“字段”选项工具栏可以在规则中映射字段。
    因为输入文件中没有标题，所以您需要将每个列映射到合适的维和成员。
  5. 在规则编辑器中，您现在可以设置规则字段。
    1. 单击创建下拉菜单，并开始设置字段名称。
      Set Field (column) 1 to Product.
      Set Field 2 to Market.
      Set Field 3 to Year.
      Set Field 4 to Scenario.
      Set Field 5 to Sales.
      Set Field 6 to COGS.
      Set Field 7 to Marketing.
      Set Field 8 to Payroll.
      Set Field 9 to Misc.
      Set Field 10 to Opening Inventory.
      Set Field 11 to Additions.
      必须在加载数据规则中提供所有维，然后才能加载任何数据。
    2. 使用全局和字段选项完成规则定义后，在“全局”工具栏上单击验证以验证语法，然后单击关闭。
    3. 在验证语法后，单击保存并关闭。
    4. 单击刷新。查看您创建的规则现在是否在“脚本”选项卡的“规则”窗格中列出。可以通过单击规则名称并单击继续来编辑您的规则。
    5. 单击关闭以返回到“应用程序”主页。
    接下来，使用规则创建一个作业来加载数据。
  6. 在主页上，选择作业，然后选择新建作业。
    1. 选择加载数据。
    2. 在加载数据对话框中，从应用程序菜单中，选择 Sample 应用程序。
    3. 在数据库列表中，选择 Basic 多维数据集。
    4. 在脚本列表中，选择您创建的加载数据规则 Data_market1.rul。
    5. 对于加载类型，选择文件。
    6. 从数据文件列表中选择文件 Data_Basic1。此文件位于 Sample > Basic 文件夹中。
    7. 可选：如果希望在出现错误时停止加载，请选中出错时终止复选框。
    8. 单击确定。此时将执行加载数据作业。
    9. 在“作业”页上，单击刷新以监视作业状态。
  7. 在作业完成后，验证输入记录是否已处理并加载。
    1. 在“应用程序”主页上，单击 Sample 应用程序中 Basic 多维数据集右侧的操作。
    2. 选择作业详细信息来检查加载数据作业详细信息。
    3. 完成后，单击关闭。
    4. 还是在“应用程序”主页上，打开 Sample 多维数据集的操作检查器。
    5. 选择统计信息以查看 Basic 多维数据集的结果统计信息。
    您现在已完成了使用规则加载数据。