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 資料，請勿指定查詢名稱。

    下列條件可能導致此命令建立空白的資料檔案：

  • 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"