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 파일을 둘 다 생성하는 ZIP_AND_TEXT가 있습니다.
  • queryName은 애플리케이션에서 정의된 쿼리를 식별하는 선택적 매개변수입니다. 공백 문자가 포함된 쿼리 이름은 큰따옴표로 묶어야 합니다.

    애플리케이션에 속하는 Oracle Essbase 데이터를 모두 익스포트하려는 경우 쿼리 이름을 지정하지 마십시오.

    다음 조건에서 이 명령은 빈 데이터 파일을 생성할 수 있습니다.

    • 데이터를 검색하지 않는 잘못된 형식의 쿼리
    • 데이터를 너무 많이 생성하는 쿼리. 이 시나리오에서는 더 적은 데이터를 검색하거나 쿼리를 더 작은 쿼리로 나누도록 쿼리 범위를 좁히는 것이 좋습니다.

      Profitability and Cost Management 관리에서 Oracle Profitability and Cost Management Cloud 쿼리 관리를 참조하십시오.

  • exportOnlyLevel0Flg는 선택사항으로, 쿼리에서 level0 데이터만 검색할지 여부를 지정합니다. 이 매개변수 값을 모두 소문자로 지정합니다.

    쿼리 이름을 생략하여 모든 애플리케이션 데이터를 내보내는 경우 이 매개변수는 무시됩니다.

  • roundingPrecision은 선택사항으로, 쿼리 결과를 익스포트할 때 사용할 소수 자릿수(반올림 정밀도)를 지정합니다. queryName을 지정한 경우에만 적용할 수 있습니다. 기본값은 2입니다.
  • dataFormat은 선택사항으로, 출력 형식을 나타냅니다. 적합한 값은 다음과 같습니다.
    • NATIVE는 쿼리 결과를 Essbase 기본 형식 데이터로 유지관리합니다. 기본값입니다.
    • COLUMNAR는 Essbase 기본 형식 데이터를 변환하며 열에 순서를 지정하여 쉽게 해석하고 다른 애플리케이션으로 임포트할 수 있도록 합니다.

      이 옵션은 모든 Essbase 데이터를 익스포트하고 queryName 매개변수 값을 무시합니다. memberFilters 매개변수 값을 설정하여 데이터를 필터링할 수 있습니다.

    주:

    이 명령에서는 dataFormat이 COLUMNAR로 지정된 경우에만 다음 선택적 매개변수를 고려합니다.
  • memberFilters는 선택사항으로, JSON으로 형식 지정된 문자열에서 차원 및 level0 멤버별로 필터링하도록 허용합니다. 예를 들어 "{\"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 데이터 형식으로 Level0 데이터 익스포트:

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

  • 단일 차원 및 단일 멤버 필터가 사용된 COLUMNAR 데이터 형식으로 Level0 데이터 익스포트:

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

  • 단일 차원 및 여러 멤버 필터가 사용된 COLUMNAR 데이터 형식으로 Level0 데이터 익스포트:

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

  • 여러 차원 및 여러 멤버 필터가 사용된 COLUMNAR 데이터 형식으로 Level0 데이터 익스포트:

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