使用数据实体

数据实体是数据结构的表格式表示形式。

它包括可以在映射中用作源或目标的数据库表或视图。它们只是源和目标的元数据。它们用于创建数据流。

可以通过以下两种方式之一向新创建的项目添加数据实体：

所有新创建或导入的数据实体及其详细信息都显示在数据实体页中。详细信息包括：

  • 数据实体的名称
  • 为其创建数据实体的连接
  • 与数据实体关联的模式
  • 单击所选数据实体旁边的操作图标 (“操作”图标) 可执行以下操作：
    • 选择编辑可编辑现有详细信息。
    • 选择预览以预览所选数据实体。如果数据实体属于 Oracle 数据库，则还可以查看表的统计信息。有关更多详细信息，请参阅查看数据实体的统计信息。
    • 选择 Delete（删除）以删除选定的数据实体。
  • 要成批删除数据实体，请在“数据实体”页中选中相应数据实体的复选框，然后单击删除。
  • 您还可以根据以下筛选器搜索所需的数据实体，以了解其详细信息：
    • 数据实体的名称
    • 为其创建数据实体的连接
    • 与数据实体关联的模式
    • 与数据实体关联的标记

父主题：“数据转换”页

导入数据实体

创建数据实体的最简单且最常见的方法是从连接类型（例如，Oracle 数据库）导入其结构。

要导入现有数据实体，请执行以下操作：

  1. 从主页的左侧窗格中，单击 Data Entities（数据实体）选项卡。

    此时将显示 Data Entities（数据实体）页面。

  2. 单击导入数据实体以导入现有数据实体。

    导入数据实体页滑入。如果您计划使用 Oracle ERP Cloud Server 连接进行导入，请参阅从 Oracle ERP Cloud Server 导入数据实体定义。

  3. 选择连接，后跟模式，最后选择要导入的对象类型。

    对于 Oracle 对象存储连接，“Schema（方案）”下拉列表列出了您在创建连接时在 URL 中指定的存储桶的名称。

  4. ［仅适用于 Oracle Business Intelligence Cloud Connector (BICC) 连接］ 从要导入以进行收集的产品中，选择要导入其数据存储的产品。您必须选择至少一个产品才能导入 BICC 公共视图对象 (PVO)。

    注意：

    BICC PVO 的导入可能需要很长时间，具体取决于所选对象的数量。为了提高性能，Oracle 建议您使用掩码来筛选和限制要导入的 PVO 数。
  5. 如果不想导入方案中的每个对象，请选择掩码 /筛选器。

    根据连接类型，您将看到用于导入的更多选项。

    注意：

    对于 Oracle 对象存储连接，此值区分大小写。如果将批处理相似文件设置为 True，则与掩码匹配且具有相同结构的所有文件将组合到一个数据实体中。
  6. ［仅适用于 Oracle Financials Cloud 连接］ 从资源部分中的列表中，选择要导入的项。导入过程完成时，会为每个选定资源创建一个表。
  7. ［仅适用于 REST 服务器连接］ 在资源部分中，执行以下操作：
    • 在资源 URI 字段中，输入要从中导入资源的 REST 服务的 URL。
    • 单击 + 图标。
    • 在名称列中，输入资源的标识符。
    • 在 Operation URI 列中输入资源的 URI。
    • 单击测试资源以检查条目是否有效。
  8. 单击启动。

    将创建“职务”，并显示相应的“职务 ID”，以便您跟踪期次。单击“作业 ID”以查看作业的详细信息。

    成功执行作业后，将导入所有选定数据实体。单击“Data Entities（数据实体）”页面右角的“Refresh（刷新）”图标 “刷新”图标，以查看导入的新数据实体。

父主题：使用数据实体

创建数据主体

您可以通过 Oracle Data Transforms 界面手动创建或更新数据实体。

数据实体应拥有源连接中的相应对象，以用作数据流中的源。通常，导入过程会确保这些对象处于协调状态。但是，每当手动创建或更新数据实体时，始终确保检查这两个定义是否相互协调。

将数据实体用作目标时，它以前不必存在于目标连接中，并且可以作为数据流执行的一部分创建。

要创建新数据实体，请执行以下操作：
  1. 从主页的左侧窗格中，单击 Data Entities（数据实体）选项卡。

    此时将显示 Data Entities（数据实体）页面。

  2. 单击创建数据实体以创建新数据实体。

    此时将显示创建数据实体页。

  3. 在“Name（名称）”文本框中，输入要创建的新数据实体的名称。
  4. 从连接下拉列表中，选择要从中添加新创建的数据实体的必需连接。

    注意：

    此处未列出 Oracle Financials Cloud 连接，因为您无法为此类连接手动创建数据实体。您只能使用“导入数据实体”页从 Oracle Financials Cloud REST 端点导入数据实体。请参阅导入数据实体。
  5. 在 Schema（方案）下拉列表中，与所选连接对应的所有方案将分两组列出。
    • 新数据库模式（以前未导入的模式）和
    • 现有数据库方案（以前导入过并且可能正在替换数据实体的区域）。

    从方案下拉列表中，选择所需的方案。

    注意：

    对于 Oracle 对象存储连接，“Schema（方案）”下拉列表列出了您在创建连接时在 URL 中指定的存储桶的名称。
  6. 从类型下拉列表中，选择数据实体类型。
    • 表：要为新创建的数据实体定义表结构，请单击 + 图标以添加列。对于每列，可以指定名称、数据类型、长度、比例、非 NULL 等参数。双击单元格以配置值。

      单击 'x' 图标可删除行。单击向上和向下箭头对表行进行排序。

    • 内嵌视图：要使用内嵌代码创建数据实体，请在查询选项卡中输入 Select 语句。例如，SELECT * FROM CUSTOMER。单击验证。

      列选项卡显示查询返回的列的只读列表。单击预览选项卡以查看列数据。

  7. 在标记文本框中，输入您选择的标记。可以使用标记筛选“数据实体”页中显示的数据实体。
  8. 对于 Oracle 对象存储连接，此页显示以下选项：
    • Contents（内容） - 选择包含要导入数据的 CSV 文件。预览表中显示的元数据（如数据类型和列长度）基于 CSV 文件的第一行。确保 CSV 文件具有标题行。标题只能包含字母数字字符，不能包含特殊字符。
    • Group Files（组文件） - 如果要将多个 CSV 文件中的数据分组到一个数据实体，请选中此复选框。例如，假设要将 Employee_Data1.csv、Employee_Data2.csv 和 Employee_Data3.csv 中的数据合并为一个数据实体。

      如果要使用 Windows 上载 CSV 文件，请确保首先将文件转换为 Unix 格式，以避免在分组过程中出现字符编码问题。

    • Resource Name（资源名称） - 将此选项与 Group Files（组文件）一起使用。输入要用于标识文件的值。资源名称应为正则表达式。您只能将星号 (*) 用作资源名称中的通配符。例如，Employee_Data*.csv。
  9. 对于 Oracle 数据库连接，可以将数据实体标记为功能组。展开 Advanced Options（高级选项），然后单击 Treat as Feature Group（作为功能组处理）复选框。
  10. 单击保存。

    将创建新的数据实体。

父主题：使用数据实体

在数据流编辑器中创建数据实体

如果已创建或导入目标数据实体，则会将数据实体拖到“设计画布”上并完成列映射和选项。

要在数据流编辑器中创建实体的定义，请执行以下操作：

  1. 将数据实体拖到设计画布上。
  2. 选择组件并单击目标组件右上角显示的“添加数据实体”图标 “添加数据实体”图标。
  3. 此时将显示 Add Data Entity（添加数据实体）页面，可用于配置目标组件的以下详细信息：

    一般信息选项卡

    • 在名称文本框中，输入新创建的数据实体的名称。
    • 从实体类型下拉列表中，选择数据实体类型。
      • 表
      • ML 模型
        选择此实体时，请按如下方式键入用户界面更改：
        • 连接类型下拉列表仅列出 Oracle 作为选项。因此，连接下拉列表仅列出您已创建的 Oracle 连接。
        • “添加数据实体”向导将显示属性选项卡，您可以在其中选择学习类型、函数类型、算法和配置参数以定义 ML 模型。有关创建和使用 ML 模型数据实体的详细信息，请参阅使用机器学习 (ML) 模型。
    • 从连接类型下拉列表中，选择要从中添加新创建的数据实体的必需连接。“Connection（连接）”下拉列表中将填充您已使用关联的连接类型创建的连接。
    • 从连接下拉列表中，选择要从中添加新创建的数据实体的服务器名称。
    • 在 Schema（方案）下拉列表中，与所选连接对应的所有方案将分两组列出。
      • 新数据库模式（以前未导入的模式）和
      • 现有数据库方案（以前导入过并且可能正在替换数据实体的区域）。
      从方案下拉列表中，选择所需的方案。

      注意：

      对于 Oracle 对象存储连接，“Schema（方案）”下拉列表列出了您在创建连接时在 URL 中指定的存储桶的名称。
    • 在标记文本框中，输入您选择的标记。可以使用标记筛选“数据实体”页中显示的数据实体。
    • 对于 Oracle 数据库连接，可以将数据实体标记为功能组。展开 Advanced Options（高级选项），然后单击 Treat as Feature Group（作为功能组处理）复选框。
    • 单击下一步。

    列选项卡

    • 单击 “添加列”图标“Add Columns（添加列）”图标，将新列添加到新创建的数据实体。

      将向显示的表中添加一个新列。

    • 该表显示以下列：
      • 名称
      • Data Type（数据类型）- 单击单元格以配置所需的数据类型。
      • 缩放比例
      • 长度
      • 操作 - 单击交叉图标以删除创建的列。
    • 要成批删除列，请选择这些列，然后单击 “删除”图标“删除”图标。
    • 要搜索所需的列详细信息，请在“搜索”文本框中输入所需的列名称，然后单击“输入”。将显示必需列的详细信息。
    • 单击下一步。

    预览数据实体选项卡

    它显示所有已创建列的预览及其配置的详细信息。如果数据实体属于 Oracle 数据库，则还可以查看表的统计信息。有关详细信息，请参阅查看数据实体的统计信息。

  4. 单击保存。

    将创建新的目标数据实体。

  5. 展开右侧窗格中的属性面板以查看所创建组件的以下设置：
    • General（常规）- 显示组件的名称及其连接和方案详细信息。
    • 属性 - 显示与组件关联的所有属性的详细信息。
    • 列映射 - 单击“自动映射”以自动映射所有列。
    • 预览 - 单击以预览组件。
    • Options（选项）- 根据需要更改选项。

父主题：使用数据实体

查看数据实体的统计信息

“预览”选项卡显示每个数据实体的详细统计信息。

注意：

此功能仅适用于 Oracle 数据库表。
可以通过以下方式之一查看所选数据实体的统计信息：
  • 在“数据实体”列表中，单击“数据实体”旁边的操作图标 (“操作”图标)，然后单击预览。选择统计信息选项卡可查看所选数据实体的统计信息。
  • 在任何数据流上，单击任何源或目标数据实体，然后展开右侧窗格中的属性面板。单击预览。

统计数据如下：

  • 数据实体中的行和列总数显示在顶部。
  • 统计信息面板显示每个列的缩略图，其中包含有关 Min、Max、Distinct 和 Null 值的信息。
  • 根据直方图显示两种类型的缩略图表示：
    • 条形图表示频率和最高频率直方图的数据。条形图显示表中行数的前 10 个值。
    • 表中列出了混合直方图和高度平衡直方图的数据。该表显示整个数据并且可滚动。此表显示值范围和每个范围内行的百分比。
  • 您可以单击每个缩略图以在新的浏览器选项卡中查看列的统计信息。
  • 每个图表的详细视图还显示直方图的类型。

父主题：使用数据实体