exportQueryResults

运行应用程序中定义的查询并将结果导出到文本文件中。

查询结果文件存储在 profitoutbox；可以使用 downloadFile 命令或者使用 Profitability and Cost Management 文件资源管理器下载该文件。

适用于

Profitability and Cost Management

所需角色

服务管理员、超级用户、用户、查看者

用法

epmautomate exportQueryResults APPLICATION_NAME fileName=FILE_NAME [fileOutputOptions=ZIP_ONLY|ZIP_AND_TEXT|TEXT_ONLY] [queryName=QUERY_NAME] [exportOnlyLevel0Flg=true|false] [roundingPrecision=2] [dataFormat=NATIVE|COLUMNAR] [memberFilters=JSON_FILTER] [includeHeader=true|false] [delimiter="DELIMITER"] [keepDuplicateMemberFormat=true|false]，其中：
  • APPLICATION_NAME 是要为其运行查询的 Profitability and Cost Management 应用程序的名称。
  • fileName 是将存储查询结果的文件的名称。在未指定 queryName 参数值时需要提供此参数值。在指定 queryName 参数值时此参数是可选的，此时查询名称用作查询结果文件的名称。

    您指定的数据格式用于确定输出文件的格式。如果使用 dataFormat=NATIVE（默认值），则导出过程将创建文本文件。如果使用 dataFormat=COLUMNAR，则导出过程将创建多个按顺序编号的文本文件，并将它们压缩到 Zip 文件中。

  • fileOutputOptions（可选）标识查询结果文件的输出格式。默认值为 ZIP_ONLY，它根据是否为 fileName 参数指定了值来创建 fileName.ZIP 或 queryName.ZIP。其他选项为 TEXT_ONLY（创建文本文件形式的输出文件）和 ZIP_AND_TEXT（生成文本文件和 zip 文件）。
  • queryName 是可选参数，标识应用程序中定义的查询。包含空格字符的查询名称必须用双引号括起来。

    如果要导出属于应用程序的所有 Oracle Essbase 数据，则不要指定查询名称。

    以下情况可能会导致此命令创建空数据文件：

    • 不检索任何数据的格式错误的查询
    • 生成太多数据的查询。对于此情况，请考虑缩小查询范围从而其检索较少数据，或者将该查询分为更小的查询

      请参阅《管理 Profitability and Cost Management》中的“管理 Oracle Profitability and Cost Management Cloud 查询”。

  • exportOnlyLevel0Flg（可选）指定查询是否只应检索 0 级数据。请以全部小写形式指定此参数值。

    如果您通过省略查询命令来导出所有应用程序数据，将忽略此参数。

  • roundingPrecision（可选），指定要在导出查询结果时使用的小数位数（舍入精度）。仅在指定 queryName 时可用。默认值为 2。
  • dataFormat（可选）标识输出格式。有效值为：
    • NATIVE，将查询结果作为 Essbase 本机格式数据进行维护。这是默认值。
    • COLUMNAR，转换 Essbase 本机格式数据并在列中对数据进行排序，以便于解释和导入到其他应用程序。

      此选项将导出所有 Essbase 数据并忽略 queryName 参数值。可以通过设置memberFilters 参数值筛选数据。

    注：

    仅当 dataFormat 指定为 COLUMNAR 时，该命令才考虑以下可选参数。
  • memberFilters（可选）接受 JSON 格式的字符串，以按维和 0 级成员进行筛选。例如，"{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
  • includeHeader（可选）添加维名称作为列标题。将此值设置为 false 可排除列标题。默认值为 true。
  • delimiter（可选）标识在查询结果文件中用于分隔维成员的分隔符。分隔符必须用双引号括起来。默认值为空格 (" ")。
  • keepDuplicateMemberFormat（可选）指定是否以 Essbase 重复成员格式（例如，[Account]@[Accoun1]）输出成员格式。将此值设置为 false 可仅输出成员名称。默认值为 true。

示例

  • 导出所有应用程序数据：

    epmautomate exportQueryResults BksML12 fileName="BksML12_MyQuery1.txt" fileOutputOptions=TEXT_ONLY

  • 导出特定查询的结果：

    epmautomate exportQueryResults BksML12 queryName="My Product Query" roundingPrecision=3

  • 以 NATIVE 数据格式导出 0 级数据：

    epmautomate exportQueryResults BksML30 fileName="BksML30_ExportLevel0-Data" fileOutputOptions=ZIP_AND_TEXT exportOnlyLevel0Flg=true

  • 使用单个维和单个成员筛选器，以 COLUMNAR 数据格式导出 0 级数据：

    epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

  • 使用单个维和多个成员筛选器，以 COLUMNAR 数据格式导出 0 级数据：

    epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

  • 使用多个维和多个成员筛选器，以 COLUMNAR 数据格式导出 0 级数据：

    epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Year\":[\"2016\"],\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"