将数据从 EPM 云回写到 Oracle Autonomous Database 中

EPM 集成代理通过允许您将数据从 Oracle Enterprise Performance Management Cloud 应用程序移动到本地网络上的 Oracle Autonomous Database 来支持回写。要使用此功能，请注册数据导出应用程序以将数据导出到 Oracle Autonomous Database 中选定的报表数据仓库。

此外，代理可以在执行回写期间执行两个事件脚本：BefExport 和 AftExport。使用 BefExport 事件，可以在向表中插入数据之前执行任何操作，也可以覆盖默认的插入处理。使用 AftExport 事件，可以在向表中插入数据之后执行任何后处理清除操作。

在 SYNC 和 ASYNC 模式下运行的代理均支持回写功能。

要将数据回写到 Oracle Autonomous Database：

  1. 在数据集成中，创建一个文件，其中包含要回写的源数据中的一个标题行。

    该标题行必须与目标维中的维名称完全匹配。在维名称的 SQL 查询中，可以使用别名代表列名称。

    图中显示了文本文件中的维标题。

  2. 将文件另存为带有标题行的 CSV 格式文件。

    注册应用程序时，使用文件浏览器上传该文件。

  3. 注册数据导出应用程序，其类型为数据导出到 Oracle Autonomous Database。

    1. 从数据集成主页中，单击操作，然后选择应用程序。

    2. 在应用程序页上，单击 图中显示了“添加”图标。。

    3. 从创建应用程序中的类别中，选择数据导出。

    4. 从类型中，选择数据导出到 Oracle Autonomous Database。

    5. 从文件中，选择在步骤 2 中创建的文件。

      单击 图中显示了“浏览”图标。 以在“文件浏览器”页上浏览到该文件。

    6. 在前缀中，指定一个前缀以确保应用程序名称唯一。

      前缀与应用程序名称连接在一起，组成一个唯一的应用程序名称。例如，如果要将一个应用程序命名为与现有应用程序相同的名称，您可以将您的姓名首字母指定为前缀。

      图中显示了“应用程序详细信息”页。

    7. 依次单击确定和保存。

  4. 在应用程序页上，单击“数据导出到 Oracle Autonomous Database”源应用程序旁边的 图中显示了“选择”图标。，然后选择应用程序详细信息。

  5. 转到“数据导出到 Oracle Autonomous Database”源应用程序的应用程序详细信息维选项卡，验证标题记录中的列名是否与要将数据加载到的表中的列名或列别名完全匹配。

    名称区分大小写。

    有关详细信息，请参阅“为回写设置应用程序详细信息维”。

  6. 在应用程序详细信息页上，单击选项选项卡。

  7. 在批大小中，指定一次从文件读取到内存的行数。

    该参数主要用于决定性能。加载数据时，此设置决定了在高速缓存中存储多少条记录。例如，当指定了 1000 时，将在高速缓存中存储 1,000 条记录。类似地，当指定了 5000 时，将在高速缓存和提交中存储 5,000 条记录。

    根据服务器内存确定此设置，并根据需要进行调整。

  8. 在表名中，指定要将数据加载到的表名称。

    “数据导出到内部部署”应用程序中的维名必须与表中的列名相匹配。系统会生成 INSERT 语句以自动加载数据并为所有字段插入文本。

    如果您在此字段中指定表名，请勿在插入查询字段中指定 INSERT 语句。

  9. 在插入查询中，指定与在“查询定义”页上创建的自定义 INSERT 语句相关联的 SQL 查询的名称。

    INSERT 查询必须包含值表和值列以及应用程序的维名称。使用此方法，可以提供用户友好的维名称，还可以使用 SQL 函数（如 TO_DATE、TO_NUMBER 和其他函数）执行数据类型转换和其他字符串运算。有关详细信息，请参阅“使用自定义 INSERT 查询进行回写”。

    如果您指定 INSERT 查询，请勿在表名字段中指定表名称。

  10. 在凭据存储中，指定 EPM 集成代理所用的凭据存储的类型。

    可用的凭据存储类型如下：

    • 云
    • 文件

    对于云凭据存储类型，将 username/password/connect 字符串存储在应用程序中。

    对于文件凭据存储类型，创建一个文件，以存储 Oracle Autonomous Database 连接的 JDBC URL、用户名和密码。URL 格式必须包括 JDBC URL、wallet 文件夹的路径、用户名和密码。文件名必须为 appname.cred 且存储在 config 目录中。

    该文件必须包含以下行：

    jdbcurl=jdbc:oracle:thin:@<tns_name>?TNS_ADMIN=<path_to_wallet_folder>

    .cred 文件中的条目示例可能如下所示：

    jdbcurl=jdbc:oracle:thin:@epmdevdb0_low?TNS_ADMIN=C:\ATP Connection\epmdevdb0_wallet
username=apps
password=w+Sz+WjKpL8[

    注：

    两个凭据存储类型所使用的密码必须加密。

    当类型为“云”存储时，以常规方式在用户界面中键入密码。系统将加密并存储密码。

    当类型为“文件”存储时，必须使用 encryptpassword 实用程序加密密码，并将密码存储在文件中。有关加密密码的详细信息，请参阅“加密 EPM 云用户密码”。

  11. 在工作流模式中，指定有关如何加载数据的方法。

    默认情况下，数据管理中的数据加载过程设计为具有明确定义的流程流，可以提供数据加载过程的完整审核以及在工作台中向下钻取和查看数据的功能。但是，由于出于审核目的而对数据进行存档，完整的数据流可能会导致处理时间延长。当处理大量数据或不需要审核，而性能是关键要求时，工作流模式选项可提供可扩展的解决方案。

    有三个工作流模式选项：

    • 完全
    • 完全 (无存档)
    • 简单

    “完全”选项是用于加载数据的默认流。以标准方式在临时表之间加载数据，可在工作台中查看数据，且支持向下钻取。

    “完全 (无存档)”选项加载数据的方式与完全模式相同，但在数据加载过程结束时将从临时表中删除数据。只有在导入步骤完成后才能在工作台中查看数据。向下钻取功能不适用于“完全 (无存档)”模式。如果要在加载过程中查看和验证数据，但又不要求审核或向下钻取，则此方法非常有用。

    此方法不会提供性能改进，但会限制空间使用，因为它不会保留数据以供将来参考。

    “简单”选项会限制在临时表之间移动数据。向下钻取功能不适用，且无法在工作台中查看数据。此方法提供性能改进，在不要求审核或向下钻取时非常有用。

    “简单”选项会限制在临时表之间移动数据。向下钻取功能不适用，且无法在工作台中查看数据。此方法提供性能改进，在不要求审核或向下钻取时非常有用。

  12. 在用户名中，指定用于连接到 Oracle Autonomous Database 的用户名。

    如果使用 SQL Developer 连接到 Oracle Autonomous Database，请指定 SQL Developer 用户名和密码。

  13. 在密码中，指定用于连接到 Oracle Autonomous Database 的密码。

  14. 在服务名称中，指定服务名称。

    可以通过打开 tnsnames.ora 文件并选择与连接关联的服务名称来找到服务名称。服务名称是映射到连接描述符中包含的数据库网络地址的别名。

    连接到数据库时，需要选择服务名称。自治数据仓库连接的服务名称采用如下格式：

    • databasename_high

    • databasename_medium

    • databasename_low

    这些服务映射到 LOW、MEDIUM 和 HIGH 使用者组。

    例如，如果您创建一个具有“数据仓库”工作量类型的自治数据库，并将数据库名称指定为 DB2020，则服务名称为：

    • db2020_high

    • db2020_medium

    • db2020_low

    如果您使用 db2020_low 服务进行连接，则该连接使用 LOW 使用者组。

    这些使用者组的基本特征为：

    • HIGH：资源最多，并发性最低。并行运行查询。

    • MEDIUM：资源较少，并发性较高。并行运行查询。

      您可以修改 MEDIUM 服务并发限制。有关详细信息，请参阅 "Change MEDIUM Service Concurrency Limit"。

    • LOW：资源最少，并发性最高。串行运行查询。

  15. 在 Wallet 位置中，指定 EPM 集成代理服务器中的目录位置，您的 wallet 已下载并解压缩到该位置。

  16. 在累计数据中，输入是以在导出之前汇总帐户数据并按一列或多列对结果进行分组。

    输入否不在导出之前汇总帐户数据，且不按一列或多列对结果进行分组。

    图中显示了“应用程序选项”选项卡。

  17. 单击保存。

  18. 通过完成以下任务将 EPM 云应用程序与“数据导出到 Oracle Autonomous Database”应用程序集成。

    任务 说明 更多信息
    常规 为基于文件的源和直接集成源添加或编辑集成。 定义数据集成
    映射维 将数据源中的列映射到目标应用程序中的维。

    映射维
    映射成员 映射维以确定如何将源字段值转换为目标维成员。 映射成员
    选项 定义用于导入和导出数据的选项。此外，定义任何源筛选器。 设置数据集成选项
    运行集成

    执行集成时，EPM 集成代理会在 EPM 云中启动导出过程。代理会下载导出数据。代理还基于选定的方法构造相应的 INSERT 语句并将数据加载到目标表中。

    可以通过从“进程详细信息”下载输出文件来审核所导出的数据。回写数据库列名在所生成的文件中指定为列标题，如下所示。

    		 运行集成