CLI parancsok referenciája

Mielőtt bármilyen más CLI-parancsot kiadhatna az Essbase számára, be kell jelentkeznie. Ha biztonságos kapcsolatot kíván használni, az URL-címnek a https szócskával kell kezdődnie.

Az alábbi módokon végezheti el a hitelesítést a CLI használatával:

• Használja a setpassword műveletet egyszer, hogy a rendszer eltárolja a jelszót kliens/felhasználó kombinációhoz. A következő munkamenetekben a login parancs segítségével jelszó megadása nélkül jelentkezhet be.
• Használja a -user és -password lehetőségeket a login paranccsal (figyelmeztetés: a jelszó titkosítatlan szövegként jelenik meg a parancssor ablakban).
• Csak a -user lehetőséget használja a login paranccsal. A rendszer felszólítja a jelszó megadására (a jelszó rejtve van).

Ha Ön összevont SSO-felhasználó az Oracle Identity Cloud Service szolgáltatásban, a MaxL vagy CLI használatával történő bejelentkezése nem támogatott. Az összevont SSO-bejelentkezéshez böngészőablakra van szükség. Hozzon létre eredeti Identity Cloud Service-felhasználót, és azt használja a MaxL vagy CLI használatával történő bejelentkezés helyett.

Szintaxis (login)

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

Példa 1 (login)

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

Példa 2 (login)

A következő példában a bejelentkező felhasználó (admin1@example.com) egy olyan Identity Cloud Service-rendszergazda, aki kezdeti Essbase-rendszergazdaként lett beállítva az Essbase-veremnek az Oracle Cloud Infrastructure szolgáltatásba telepítése során. Mivel a példában nincs megadva a jelszó, a rendszer felszólítja a rendszergazdát, hogy a következő lépésben adja meg. Az URL-cím a feladat kimeneti adataiból származó essbase_url cím, amely a verem telepítése eredményeként jött létre.

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

Szintaxis (logout)

logout

Példa (logout)

esscs logout

A számítási parancsfájlok futtatása előtt először fel kell töltenie a parancsfájlokat .csc fájlként a kockakönyvtárba. A fájlok feltöltéséhez használja a CLI felületet. Lásd: Upload: Kockafájlok felvétele.

Szintaxis

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

Példa

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

A számítási parancsfájlok futtatását a Cube Designer Számítás opciójával, a Smart View szolgáltatással, az Essbase webes felületének a Feladatok opciójával vagy a REST API segítségével, illetve a MaxL szolgáltatás számítás végrehajtása parancsával is végrehajthatja.

Szintaxis

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

Példa

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

Az adatok törlését a Cube Designer Adatok betöltése opciójával, az Essbase webes felületének a Feladatok opciójával vagy a REST API segítségével, illetve a MaxL szolgáltatás DBS-NAME adatbázis módosításának visszaállítása parancsával is végrehajthatja.

Leírás

A szolgáltatás adminisztrátorának ezt a parancsot kell használnia a helyi kapcsolat létrehozásához és mentéséhez, mielőtt bárki használhatná a CLI dataload vagy dimbuild parancsát a streaming beállítással. Továbbá be kell állítania egy EXTERNAL_CLASSPATH környezeti változót úgy, hogy az az adatbázis-illesztőprogram .jar fájljára mutasson (lásd:Dimenziók felépítése és adatok betöltése távoli adatbázisra mutató adatfolyam segítségével).

Szintaxis

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

Ha hálózati kapcsolattal rendelkezik egy külső adatforrás és az Essbase szolgáltatás között, az a leghatékonyabb módszer, ha az Essbase webes felületén definiálja az alkalmazásszintű és globális kapcsolatokat és az adatforrásokat. Ezek a definíciók segítenek könnyedén "áthúzni" az adatokat a külső adatforrásból. Ha nem rendelkezik hálózati kapcsolattal az Essbase szolgáltatás és a külső adatforrás között, akkor a CLI segítségével átviheti az adatbetöltéseket vagy dimenziófelépítéseket. Ehhez először ezzel a paranccsal létre kell hoznia egy helyi kapcsolatot, majd ki kell adnia a dataload vagy dimbuild parancsot az átviteli beállítással.

Megjegyzések

A 21.4-es vagy újabb kiadásra való áttérés után a szolgáltatásadminisztrátornak újra létre kell hoznia minden mentett helyi kapcsolatot, amelyet egy korábbi kiadásban ezzel a paranccsal hoztak létre.

Példák

Ehhez a parancshoz az alábbi beállítások valamelyikét kell használnia:

• Adatfájl és opcionális szabályfájl

• Szabályfájl felhasználónévvel és jelszóval

• Mentett helyi kapcsolatra hivatkozó adatfolyam beállítás

A forrásadatbázisnak az ügyfélhálózaton belül elérhetőnek kell lennie, mivel nem minden adatbázis-illesztőprogram tud együttműködni a Java-proxykkal.

Az adatok betöltéséhez először fel kell töltenie az adatbetöltési és szabályfájlokat a kocka könyvtárába. A fájlok feltöltéséhez használja a CLI felületet. Lásd: Upload: Kockafájlok felvétele.

Szintaxis

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]

Példák

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"

Az adatokat a Cube Designer, a Munkák az Essbase webes felületén vagy a REST API segítségével is betöltheti, vagy adatokat importálhat a MaxL-ben.

Szintaxis

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

Példák

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

esscs deletefile -CF /shared/Data.txt

A fájlok kezelését végezheti a Cube Designer szolgáltatásból, az Essbase webes felületéről vagy a REST API segítségével is.

Szintaxis

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

Példák

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

A kockák telepítését a Cube Designer segítségével vagy az Essbase webes felületének Alkalmazások részében található Importálás opció használatával is elvégezheti.

A dimenziók betöltése előtt először fel kell töltenie a dimenziófelépítési és szabályfájlokat az Essbase alkalmazásba. A fájlok feltöltéséhez használja a CLI felületet. Lásd: Upload: Kockafájlok felvétele.

Szintaxis

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]

Példák

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

A dimenziókat a Cube Designer, a Munkák az Essbase webes felületén vagy a REST API segítségével is betöltheti, vagy dimenziókat importálhat a MaxL-ben.

Előfordulhat, hogy le kell töltenie a kockához tartozó szövegfájlokat, szabályfájlokat és számítási parancsfájlokat, hogy dolgozni tudjon rajtuk, vagy fel tudja őket tölteni egy másik kockához. A kockához tartozó modellelemek letöltéséhez legalább Adatbázis-módosítási engedéllyel kell rendelkeznie.

Szintaxis

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

Példák

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

A fájlok kezelését végezheti a Cube Designer szolgáltatásból, az Essbase webes felületéről vagy a REST API segítségével is.

Szintaxis

[command] -help | -h

Példák

esscs -help

esscs -h

esscs dataload -help

Szintaxis

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

Megjegyzések

Ezt a parancsot (és a többi CLI-parancsot) az Essbase gépén kívül is lehet használni, míg az LCM segédprogram futtatásához az Essbase gépe szükséges.

Példa

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

Példa Windows-parancsfájlra

Az lcmexportall.bat Windows-parancsfájl az összes alkalmazást abba az aktuális helyi könyvtárba exportálja, ahonnan a CLI meghívásra került.

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

Szintaxis

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

Megjegyzések

• Ezt a parancsot (és a többi CLI-parancsot) az Essbase gépén kívül is lehet használni, míg az LCM segédprogram futtatásához az Essbase gépe szükséges.

• Az LCM-importálás befejezése után előfordulhat, hogy további lépéseket kell tennie a külső forrásokhoz átköltöztetett kapcsolatok visszaállításához. Ehhez nyissa meg a kapcsolatot, és adja meg a jelszót.

• Ha az áttelepítendő kockák között partíciók vannak érvényben, az adatforrást kell előbb importálnia. Ellenkező esetben a rendszer nem tudja helyreállítani a partíciódefiníciókat.

  Az Életciklus-kezelés (LCM) importálási műveletek (és a Migrációs segédprogram importálása) nem támogatottak az összevont partíciók migrálásához. Az összevont partíciókat manuálisan kell újra létrehozni a célponton.

• Az LCM importálása nem telepíti át a helyalias hitelesítő adatokat. Le kell cserélnie a helyalias hitelesítő adatait. Ezt úgy végezheti el, hogy újra létrehozza a helyaliasokat a MaxL használatával, vagy szerkeszti a helyalias hitelesítő adatokat az LCM exportálás által exportált XML-fájlban.

Példa

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

Szintaxis

listapp [-verbose] [-details]

Példa

esscs listapp -v -dtl

Szintaxis

listdb [-verbose] -application applicationName [details]

Példa

esscs listdb -v -a Sample -dtl

A kockához tartozó modellelemek közé sorolhatók az adatfájlok, munkafüzetek, szabályfájlok, számítási parancsfájlok és egyéb modellelemek. A kockához tartozó modellelemek közé tartozik minden olyan fájl, amelyre szükség van ahhoz, hogy műveleteket lehessen végezni az alkalmazásokon és a kockákon.

Egy kocka fájljainak listázásához legalább adatbázis-hozzáférési engedélyre van szüksége az alkalmazásban. Nincs szükség speciális engedélyekre a felhasználói könyvtár fájljainak felsorolásához.

Szintaxis

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

Példák

esscs listfiles -t rul -a Sample -d Basic 

esscs listfiles -CP "/shared"

A fájlok kezelését végezheti a Cube Designer szolgáltatásból, az Essbase webes felületéről vagy a REST API segítségével is.

Szintaxis

listfilters [-verbose] -application appname -db cubename 

Példa

esscs listfilters -v -a Sample -d Basic 

Szintaxis

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

Példa

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

Szintaxis

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

Példák

Kockaszint

esscs listvariables -a Sample -db Basic

Alkalmazásszint

esscs listvariables -a Sample

Globális szint

esscs listvariables

Szintaxis

 setpassword [-verbose] -essbaseurl URL -user userName

Megjegyzések

A 21.4-es vagy újabb kiadásra való áttelepítés után vissza kell állítania minden tárolt jelszót, amelyet egy korábbi kiadásban ezzel a paranccsal mentett.

Példa

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

Szintaxis

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

Példa

esscs start -v -a Sample -d Basic

Szintaxis

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

Példa

esscs stop -v -a Sample -d Basic 

Szintaxis

unsetpassword [-verbose] -essbaseurl URL -user userName

Példa

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

Ahhoz, hogy el tudja végezni az adatbetöltést, a dimenziófelépítést, valamint számításokat vagy más műveleteket tudjon végrehajtani, előfordulhat, hogy fel kell töltenie adatfájlokat, szabályfájlokat, számítási parancsfájlokat vagy egyéb modellelemeket a kocka könyvtárába. A modellelemeket a felhasználói könyvtárába is feltöltheti.

Egy kocka fájljainak feltöltéséhez legalább Adatbázis-kezelő engedéllyel kell rendelkeznie. Nincs szükség speciális engedélyekre a felhasználói könyvtárba való feltöltéshez.

Szintaxis

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

-ca gzip

-ca lz4

Példák

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

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

A fájlok kezelését végezheti a Cube Designer szolgáltatásból, az Essbase webes felületéről vagy a REST API segítségével is.

Szintaxis

version

Példa

esscs version