CLI 명령 참조

Essbase에 대한 다른 CLI 명령을 실행하려면 로그인해야 합니다. 보안 접속이 필요한 경우 URL을 https로 시작해야 합니다.

CLI를 사용하여 다음 방법으로 인증을 수행할 수 있습니다.

• 클라이언트/사용자 조합에 대해 비밀번호가 저장되도록 setpassword를 한 번 사용합니다. 후속 세션에서는 비밀번호를 입력하지 않고도 login 명령을 사용할 수 있습니다.
• login 명령과 함께 -user 및 -password 옵션을 사용합니다. 주의: 비밀번호는 셸 창에 일반 텍스트로 나타납니다.
• login 명령과 함께 -user 옵션만 사용합니다. 숨겨진 비밀번호를 입력하라는 메시지가 표시됩니다.

Oracle Identity Cloud Service의 통합 SSO 사용자인 경우 MaxL 또는 CLI를 사용한 로그인은 지원되지 않습니다. 통합 SSO 로그인에는 브라우저 창이 필요합니다. 고유 Identity Cloud Service 사용자를 생성하고 대신 이를 사용하여 MaxL 또는 CLI에 로그인하십시오.

구문(로그인)

login [-verbose] -essbaseurl https://instance-name.example.com/essbase -user username [-password password] 

예 1(로그인)

esscs login -url https://myEssbase-test-myDomain.analytics.us2.example.com/essbase -u smith

예 2(로그인)

다음 예제에서 로그인 사용자 admin1@example.com은 Oracle Cloud Infrastructure에서 Essbase 누적 배치 중에 초기 Essbase 관리자로 설정된 Identity Cloud Service 관리자입니다. 이 예제에는 비밀번호가 입력되지 않으므로 관리자에게 다음에 제공하라는 메시지가 표시됩니다. URL은 스택 배치로 인한 작업 출력의 essbase_url입니다.

esscs login -u admin1@example.com -url https://192.0.2.1/essbase

구문(로그아웃)

logout

예(로그아웃)

esscs logout

계산 스크립트를 실행하기 전에 먼저 .csc 파일로 스크립트를 큐브 디렉토리에 업로드해야 합니다. CLI를 사용하여 파일을 업로드할 수 있습니다. Upload: 큐브 파일 추가을(를) 참조하십시오.

구문

calc [-verbose] -application appname -db cubename -script scriptfilename

예

esscs calc -v -a Sample -d Basic -s CALCALL.CSC

Cube Designer 또는 Smart View의 계산 옵션, Essbase 웹 인터페이스 또는 REST API의 작업, 또는 MaxL의 execute calculation을 사용하여 계산 스크립트를 실행할 수도 있습니다.

구문

clear [-verbose] -application appname -db cubename [-option clearOption[-regionspec regionSpec]]

예

esscs clear -a ASOSamp -d Basic -O PARTIAL_DATA -rs "{([Jan],[Sale],[Cash])}" 

Cube Designer의 데이터 로드 옵션, Essbase 웹 인터페이스 또는 REST API의 작업, 또는 MaxL의 alter database DBS-NAME reset을 사용하여 데이터를 지울 수도 있습니다.

설명

누군가 CLI dataload 또는 dimbuild 명령을 스트리밍 옵션과 함께 사용하기 전에 서비스 관리자는 이 명령을 사용하여 로컬 접속을 생성하고 저장해야 합니다. 또한 환경 변수 EXTERNAL_CLASSPATH를 데이터베이스 드라이버에 대한 .jar 파일을 가리키도록 설정해야 합니다(원격 데이터베이스에서 스트리밍하여 차원 빌드 및 데이터 로드 참조).

구문

createLocalConnection [-verbose] -name streamConnection -connectionstring  connectionString -user userName [-driver jdbcDriver] [-password password]

jdbc:oracle:thin:@host:port/service_name

jdbc:oracle:thin:@host:port:SID

외부 데이터 소스와 Essbase 간에 네트워크 접속이 있으면 Essbase 웹 인터페이스에서 애플리케이션 레벨 또는 글로벌 접속 및 데이터 소스를 정의하는 것이 가장 효율적입니다. 이 정의를 통해 외부 소스에서 데이터를 쉽게 "풀링"할 수 있습니다. Essbase와 외부 데이터 소스 간에 네트워크 접속이 없으면 CLI를 사용하여 데이터 로드 또는 차원 빌드를 스트림할 수 있습니다. 먼저 이 명령을 사용하여 로컬 접속을 생성한 다음 dataload 또는 dimbuild 명령을 stream 옵션과 함께 실행하십시오.

주

릴리스 21.4 이상으로 이전한 후 서비스 관리자는 기존 릴리스에서 이 명령을 사용하여 생성한 저장된 로컬 접속을 다시 생성해야 합니다.

예

이 명령은 다음 옵션 집합 중 하나가 필요합니다.

• 데이터 파일 및 규칙 파일(선택사항)

• 사용자 이름 및 비밀번호가 있는 규칙 파일

• 저장된 로컬 접속을 참조하는 스트림 옵션

모든 데이터베이스 드라이버가 Java 프록시와 작동하지는 않으므로 클라이언트 네트워크 내에서 소스 데이터베이스에 액세스할 수 있어야 합니다.

데이터를 로드하려면 먼저 데이터 로드 및 규칙 파일을 큐브 디렉토리에 업로드해야 합니다. CLI를 사용하여 파일을 업로드할 수 있습니다. Upload: 큐브 파일 추가을(를) 참조하십시오.

구문

dataload [-verbose] -application appname -db cubename -file filename [| -catalogfile catalogFile] [-rule rulesFile | -catalogrulefile catalogRulesFile] [-user username [-password password]]  [-stream] [-connection connectionName][-query queryString] [-rows n]]  [-abortOnError]

예

esscs dataload -a Sample -db Basic -f Calcdat.txt -abort true

esscs dataload -a Sample -db Basic -r Basic.rul -S -conn oraConn -q "Select * from Data" -rows 50

esscs dataload -a Sample -db Basic -CF /users/weblogic/Data_Basic.txt -r Data.rul -abortonerror

esscs dataload -a Sample -db Basic -CF /users/weblogic/Data_Basic.txt -CRF /shared/Data.rul -abort

esscs dataload -a Sample -db Basic -CRF /shared/Data.rul -S -conn localConnectionName -q "Select * from Table"

Cube Designer, Essbase 웹 인터페이스 또는 REST API의 작업, 또는 MaxL의 import data를 사용하여 데이터를 로드할 수도 있습니다.

구문

deletefile [-verbose] -file fileName [-application application [-db  database] [| -catalogfile catalogFile]]

예

esscs deletefile -a Sample -d Basic -f Act1.rul

esscs deletefile -CF /shared/Data.txt

Cube Designer, Essbase 웹 인터페이스 또는 REST API에서 파일을 관리할 수도 있습니다.

구문

deploy [-verbose] -file fileName [-application application [-database database] | -catalogfile catalogFile] [-restructureoption restructureOption] [-loaddata] [-recreateapplication] [-createfiles] [-executescript]

예

esscs deploy -v -a SampleD1 -d BasicD1 -f Sample_Basic.xlsx -l -ra -cf -e

esscs deploy -CF "/gallery/Applications/Demo Samples/Block Storage/Sample_Basic.xlsx" -a Sample1 -l -cf -e -R ALL_DATA

Cube Designer를 사용하거나 Essbase 웹 인터페이스의 애플리케이션 섹션에서 임포트 옵션을 사용하여 큐브를 배치할 수도 있습니다.

차원을 로드하기 전에 먼저 차원 빌드 및 규칙 파일을 Essbase에 업로드해야 합니다. CLI를 사용하여 파일을 업로드할 수 있습니다. Upload: 큐브 파일 추가을(를) 참조하십시오.

구문

dimbuild [-verbose] -application appname -db cubename -file fileName [| -catalogfile catalogFile] -rule rulesFile [| -catalogrulefile catalogRulesFile]] [-user userName [-password password]] [-stream] [-connection connectionName][-query queryString] [-rows n]] [-restructureOption restructureOption] [-forcedimbuild]

예

esscs dimbuild -a Sample -d Basic -r Basic.rul -u smith -p password -R NO_DATA -F

esscs dimbuild -a Sample -d Basic -r Basic.rul -S -conn oraConn -q "Select * from Data" -rows 50 -R NO_DATA

esscs dimbuild -a Sample -db Basic -CRF /users/weblogic/Dim_Market.rul -CF /shared/Market.txt -R ALL_DATA -F

Cube Designer, Essbase 웹 인터페이스 또는 REST API의 작업, 또는 MaxL의 import dimensions를 사용하여 차원을 로드할 수도 있습니다.

작업을 수행하거나 다른 큐브로 업로드할 수 있도록 텍스트 파일, 규칙 파일 또는 계산 스크립트 파일을 큐브에서 다운로드해야 할 수도 있습니다. 큐브 아티팩트를 다운로드하려면 최소한 데이터베이스 업데이트 권한이 필요합니다.

구문

download [-verbose] -file filename[ | -catalogfile catalogFile] [-application appname [-db cubename]] [-localdirectory path] [-overwrite] [-nocompression]

예

esscs download -v -f Product003.rul -a Sample -d Basic -ld c:/temp -o 

esscs download -f Acli.rul -ld c:/temp -o

esscs download -CF /shared/Acli.rul -ld c:/temp -o

Cube Designer, Essbase 웹 인터페이스 또는 REST API에서 파일을 관리할 수도 있습니다.

구문

[command] -help | -h

예

esscs -help

esscs -h

esscs dataload -help

구문

lcmExport [-verbose] -application appname|-allApp -zipfilename filename [-localDirectory path][-threads threadscount][-skipdata][-overwrite][-generateartifactlist][-include-server-level][-cube][-exportdata][-filetype][-exportpartitions][-exportfilters][-restEncryPassword]

esscs lcmexport -a sample -z sampleXLSOnly.zip -v -ft excel

esscs lcmexport -a sample -z sampleTXTOnly.zip -v -ft txt

주

다른 CLI 명령과 마찬가지로 이 명령은 Essbase 시스템 외부에서 사용할 수 있지만, LCM 유틸리티는 Essbase 시스템에서 실행되어야 합니다.

예

esscs lcmExport -v -a Sample -z Sample.zip -ld c:/temp -skip -o -gal -isl

Windows 스크립트 예제

다음 Windows 스크립트 lcmexportall.bat는 CLI가 호출된 현재 로컬 디렉토리로 모든 애플리케이션을 익스포트합니다.

set ESSCLI_ID=%USERNAME%_%random%
@echo on
echo Login to Essbase
call esscs login -u myusername -p mYpa55w0rD -url https://myserver.example.com:9000/essbase
echo Export all apps and download to this directory
call esscs lcmexport -aa -z allapps.zip
echo Log out of Essbase
call esscs logout
@echo off

구문

lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]

# ------------IMPORT-----------------
import @Provisions
import @Databases/Basic
#import @Databases/Basic/Audit
import @Databases/Basic/Text_files
import @Databases/Basic/Xml_files
import @Databases/Basic/Calc_scripts
import @Databases/Basic/Open_XML_Excel_files
import @Databases/Basic/ScenarioManagement
import @Databases/Basic/Provisions
import @Databases/Basic/Rule_files

주

• 다른 CLI 명령과 마찬가지로 이 명령은 Essbase 시스템 외부에서 사용할 수 있지만, LCM 유틸리티는 Essbase 시스템 내부에서 실행되어야 합니다.

• LCM 임포트가 완료된 후 이전된 접속을 외부 소스로 복원하기 위해 추가 조치를 취해야 할 수도 있습니다. 이를 위해 접속을 열고 비밀번호를 입력합니다.

• 이전하려는 큐브 사이에 파티션이 존재하는 경우 데이터 대상에 앞서 데이터 소스를 임포트해야 합니다. 그렇지 않으면 파티션 정의가 복원되지 않을 수 있습니다.

  LCM(수명 주기 관리) 임포트 작업(및 마이그레이션 유틸리티 임포트)은 통합 파티션 마이그레이션에 지원되지 않습니다. 통합 파티션은 대상에 수동으로 재생성해야 합니다.

• LCM 임포트는 위치 별칭 인증서를 이전하지 않습니다. MaxL을 사용하여 위치 별칭을 다시 생성하거나, LCM 익스포트로 내보낸 XML에서 위치 별칭 인증서를 편집하여 위치 별칭 인증서를 바꿔야 합니다.

예

esscs lcmImport -z C:/Sample/Sample.zip -o -al C:/Sample/Sample.txt

구문

listapp [-verbose] [-details]

예

esscs listapp -v -dtl

구문

listdb [-verbose] -application applicationName [details]

예

esscs listdb -v -a Sample -dtl

큐브 아티팩트에는 데이터 파일, 워크북, 규칙 파일, 계산 스크립트 파일 또는 기타 아티팩트가 포함될 수 있습니다. 큐브 아티팩트에는 애플리케이션 및 큐브에 대해 작업을 수행하는 데 필요한 파일이 포함됩니다.

큐브에 대한 파일을 나열하려면 최소한 애플리케이션에 대한 데이터베이스 액세스 권한이 필요합니다. 사용자 디렉토리에서 파일을 나열하는 데는 특별한 권한이 필요하지 않습니다.

구문

listfiles [-verbose] [-type filetype] [-application appname [-db cubename] | -catalogpath catalogPath] 

예

esscs listfiles -t rul -a Sample -d Basic 

esscs listfiles -CP "/shared"

Cube Designer, Essbase 웹 인터페이스 또는 REST API에서 파일을 관리할 수도 있습니다.

구문

listfilters [-verbose] -application appname -db cubename 

예

esscs listfilters -v -a Sample -d Basic 

구문

listlocks [-verbose] -application appname -db cubename [-object] 

예

esscs listlocks -v -a Sample -d Basic -obj

구문

listvariables [-verbose] [-application application [-db database]]

예

큐브 레벨

esscs listvariables -a Sample -db Basic

애플리케이션 레벨

esscs listvariables -a Sample

글로벌 레벨

esscs listvariables

구문

 setpassword [-verbose] -essbaseurl URL -user userName

주

릴리스 21.4 이상으로 이전한 후 기존 릴리스에서 이 명령을 사용하여 저장된 비밀번호를 재설정해야 합니다.

예

esscs setpassword -url https://myEssbase-test-myDomain.analytics.us2.example.com/essbase -user rschmidt

구문

start [-verbose] -application appname [-db cubename]

예

esscs start -v -a Sample -d Basic

구문

stop [-verbose] -application appname [-db cubename]

예

esscs stop -v -a Sample -d Basic 

구문

unsetpassword [-verbose] -essbaseurl URL -user userName

예

esscs unsetpassword -url https://myEssbase-test-myDomain.analytics.us2.example.com/essbase -u user1

데이터 로드, 차원 빌드, 계산 또는 기타 작업 등의 태스크를 수행하려는 경우 데이터 파일, 규칙 파일, 계산 스크립트 파일 또는 기타 아티팩트를 큐브 디렉토리로 업로드해야 할 수 있습니다. 사용자 디렉토리로 아티팩트를 업로드할 수도 있습니다.

큐브로 파일을 업로드하려면 최소한 데이터베이스 관리자 권한이 필요합니다. 사용자 디렉토리로 업로드하는 데는 특별한 권한이 필요하지 않습니다.

구문

upload [-verbose] -file filename [-application appname [-db cubename] | -catalogpath catalogPath] [-overwrite] [-nocompression][-compressionalgorithm]

-ca gzip

-ca lz4

예

esscs upload -v -f c:/temp/Maxl01.msh -a Sample -d Basic -o -ca lz4

esscs upload -f C:/temp/Act1.rul -CP /shared

Cube Designer, Essbase 웹 인터페이스 또는 REST API에서 파일을 관리할 수도 있습니다.

구문

version

예

esscs version