Popis príkazov rozhrania príkazového riadka

Skôr než budete môcť v Essbase zadávať ďalšie príkazy rozhrania CLI, je potrebné sa prihlásiť. Ak sa vyžaduje zabezpečené pripojenie, adresa URL sa musí začínať výrazom https.

Autentifikáciu s použitím CLI môžete vykonať týmito spôsobmi:

• Jedenkrát použite príkaz setpassword, aby sa uložilo heslo pre kombináciu klient/používateľ. V nasledujúcich reláciách môžete použiť príkaz login bez toho, aby ste boli vyzvaný na zadanie hesla.
• Použite voľby -user a -password s príkazom login (upozornenie: heslo sa zobrazí v okne rozhrania shell nešifrované).
• Použite iba voľbu -user s príkazom login. Zobrazí sa výzva na zadanie hesla, ktoré je skryté.

Ak ste federovaný používateľ SSO v službe Oracle Identity Cloud Service, prihlasovanie pomocou príkazov MaxL alebo CLI nie je podporované. Federované prihlásenie SSO vyžaduje okno prehľadávača. Ak sa chcete prihlásiť pomocou rozhrania MaxL alebo CLI, vytvorte na to natívneho používateľa služby Identity Cloud Service.

Syntax (login)

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

Príklad 1 (login)

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

Príklad 2 (login)

Prihlasujúci sa používateľ v nasledujúcom príklade admin1@example.com je administrátor služby Identity Cloud Service, ktorý bol nastavený ako prvý administrátor služby Essbase počas nasadzovania zásobníka Essbase do infraštruktúry Oracle Cloud Infrastructure. Keďže v príklade nie je zadané heslo, administrátorovi sa zobrazí výzva na jeho zadanie v ďalšom kroku. Adresou URL je essbase_url z výstupov úloh po nasadení zásobníka.

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

Syntax (logout)

logout

Príklad (logout)

esscs logout

Pred spustením skriptov výpočtu je potrebné najprv ich nahrať do adresára kocky ako súbory .csc. Na nahranie súborov môžete použiť príkazový riadok. Pozrite si časť Upload: Pridanie súborov kocky.

Syntax

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

Príklad

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

Skripty výpočtov môžete spustiť aj pomocou voľby výpočtu v návrhárovi kocky alebo aplikácii Smart View, stránky Úlohy vo webovom rozhraní Essbase alebo rozhraní REST API, prípadne pomocou príkazu MaxL execute calculation.

Syntax

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

Príklad

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

Dáta môžete vymazať aj pomocou voľby Zaviesť dáta v návrhárovi kociek, pomocou úloh vo webovom rozhraní Essbase alebo v rozhraní REST API, alebo pomocou príkazu alter database DBS-NAME reset v MaxL.

Popis

Tento príkaz musí administrátor služby použiť na vytvorenie a uloženie lokálneho pripojenia predtým, ako budú môcť ostatní používatelia použiť príkazy CLI dataload alebo dimbuild s voľbou streamovania. Takisto je potrebné nastaviť premennú prostredia EXTERNAL_CLASSPATH, ktorá bude odkazovať na súbor .jar pre ovládač databázy (pozrite si časť Vytváranie dimenzií a zavádzanie dát streamovaním zo vzdialenej databázy).

Syntax

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

Ak máte sieťové pripojenie medzi externým zdrojom dát a službou Essbase, najefektívnejšie je definovať pripojenia na úrovni aplikácie alebo globálne pripojenia a dátové zdroje vo webovom rozhraní Essbase. Tieto definície vám pomôžu jednoducho načítať dáta z externého zdroja. Ak nemáte sieťové pripojenie medzi službou Essbase a externým zdrojom dát, zavádzané dáta alebo vytvárané dimenzie môžete streamovať pomocou rozhrania CLI. Najskôr je potrebné pomocou tohto príkazu vytvoriť lokálne pripojenie a potom vydať príkaz dataload alebo dimbuild s voľbou streamovania.

Poznámky

Po migrácii na vydanie 21.4 alebo novšie musí administrátor služby znova vytvoriť všetky uložené lokálne pripojenia, ktoré boli vytvorené pomocou tohto príkazu v predchádzajúcom vydaní.

Príklady

Tento príkaz vyžaduje jednu z nasledujúcich množín volieb:

• Dátový súbor a voliteľný súbor pravidiel

• Súbor pravidiel s menom používateľa a heslom

• Voľba streamovania odkazujúca na uložené lokálne pripojenie

Zdrojová databáza musí byť prístupná v rámci klientskej siete, pretože nie všetky databázové ovládače dokážu pracovať so servermi proxy Java.

Ak chcete zaviesť dáta, je potrebné najprv nahrať zavedenie dát a súbory pravidiel do adresára kocky. Na nahranie súborov môžete použiť príkazový riadok. Pozrite si časť Upload: Pridanie súborov kocky.

Syntax

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]

Príklady

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"

Dáta môžete zaviesť aj pomocou návrhára kociek, sekcie Úlohy vo webovom rozhraní Essbase alebo v rozhraní REST API, prípadne pomocou importu dát v MaxL.

Syntax

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

Príklady

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

esscs deletefile -CF /shared/Data.txt

Súbory môžete spravovať aj v návrhárovi kociek, vo webovom rozhraní Essbase alebo v rozhraní REST API.

Syntax

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

Príklady

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

Môžete tiež nasadiť kocky pomocou návrhára kociek alebo pomocou voľby Importovať v sekcii Aplikácie vo webovom rozhraní Essbase.

Skôr ako budete môcť zaviesť dimenzie, do Essbase je potrebné nahrať súbory vytvorenia dimenzií a súbory pravidiel. Na nahranie súborov môžete použiť príkazový riadok. Pozrite si časť Upload: Pridanie súborov kocky.

Syntax

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]

Príklady

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

Dimenzie môžete zaviesť aj pomocou návrhára kociek, stránky Úlohy vo webovom rozhraní Essbase alebo v rozhraní REST API, prípadne pomocou importu dimenzií v MaxL.

Môže byť potrebné stiahnuť textové súbory, súbory pravidiel alebo súbory skriptov výpočtov z kocky, aby ste s nimi mohli pracovať alebo ich nahrať do inej kocky. Na stiahnutie artefaktov kocky potrebujete povolenie minimálne na úrovni aktualizácie databázy.

Syntax

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

Príklady

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

Súbory môžete spravovať aj v návrhárovi kociek, vo webovom rozhraní Essbase alebo v rozhraní REST API.

Syntax

[command] -help | -h

Príklady

esscs -help

esscs -h

esscs dataload -help

Syntax

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

Poznámky

Podobne ako iné príkazy rozhrania príkazového riadka, aj tento príkaz možno spúšťať z iného počítača ako je počítač Essbase. Utilita LCM však musí byť spustená v počítači Essbase.

Príklad

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

Príklad skriptu systému Windows

Nasledujúci skript systému Windows, lcmexportall.bat, exportuje všetky aplikácie do aktuálneho lokálneho adresára, z ktorého bol vyvolaný príkaz 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

Syntax

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

Poznámky

• Podobne ako iné príkazy rozhrania príkazového riadka, aj tento príkaz možno spúšťať z iného počítača ako je počítač Essbase. Utilita LCM však musí byť spustená v počítači Essbase.

• Po dokončení importu LCM môže byť potrebné vykonať ďalšiu akciu na obnovenie migrovaných pripojení k externým zdrojom. Ak to chcete vykonať, otvorte pripojenie a zadajte heslo.

• Ak existujú partície medzi migrovanými kockami, dátový zdroj je potrebné importovať pred dátovým cieľom. V opačnom prípade sa definície partícií nemusia obnoviť.

  Operácie importu utility Lifecycle Management (LCM) (a import utility migrácie) nie sú pre migráciu federovaných partícií podporované. Federované partície je potrebné manuálne znovu vytvoriť v cieli.

• Pri importe LCM sa nemigrujú doklady aliasu umiestnenia. Doklady aliasu umiestnenia je potrebné nahradiť, a to buď opätovným vytvorením aliasov umiestnení pomocou príkazov MaxL, alebo úpravou dokladov aliasu umiestnenia v súbore XML exportovanom prostredníctvom exportu LCM.

Príklad

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

Syntax

listapp [-verbose] [-details]

Príklad

esscs listapp -v -dtl

Syntax

listdb [-verbose] -application applicationName [details]

Príklad

esscs listdb -v -a Sample -dtl

Artefakty kocky môžu zahŕňať dátové súbory, zošity, súbory pravidiel, súbory skriptov výpočtov alebo iné artefakty. Artefakty kocky zahŕňajú ľubovoľné súbory, ktoré sú potrebné na vykonávanie akcií v aplikáciách a kockách.

Ak chcete zobraziť zoznam súborov kocky, pre aplikáciu potrebujete povolenie minimálne na úrovni Prístup k databáze. Na zobrazenie zoznamu súborov z vlastného adresára používateľa sa nevyžadujú žiadne špeciálne povolenia.

Syntax

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

Príklady

esscs listfiles -t rul -a Sample -d Basic 

esscs listfiles -CP "/shared"

Súbory môžete spravovať aj v návrhárovi kociek, vo webovom rozhraní Essbase alebo v rozhraní REST API.

Syntax

listfilters [-verbose] -application appname -db cubename 

Príklad

esscs listfilters -v -a Sample -d Basic 

Syntax

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

Príklad

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

Syntax

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

Príklady

Úroveň kocky

esscs listvariables -a Sample -db Basic

Úroveň aplikácie

esscs listvariables -a Sample

Globálna úroveň

esscs listvariables

Syntax

 setpassword [-verbose] -essbaseurl URL -user userName

Poznámky

Po migrácii na vydanie 21.4 alebo vyššie je potrebné znovunastaviť všetky uložené heslá, ktoré boli pomocou tohto príkazu uložené v predchádzajúcom vydaní.

Príklad

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

Syntax

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

Príklad

esscs start -v -a Sample -d Basic

Syntax

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

Príklad

esscs stop -v -a Sample -d Basic 

Syntax

unsetpassword [-verbose] -essbaseurl URL -user userName

Príklad

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

Ak chcete vykonávať úlohy ako zavádzanie dát, vytváranie dimenzií, výpočty alebo iné operácie, do adresára kocky môže byť potrebné nahrať dátové súbory, súbory pravidiel, súbory skriptov výpočtov alebo ďalšie artefakty. Môžete tiež nahrať artefakty do svojho adresára používateľa.

Ak chcete nahrať súbory do kocky, potrebujete povolenie minimálne na úrovni správcu databázy. Na nahrávanie do vlastného adresára používateľa nie sú potrebné žiadne špeciálne povolenia.

Syntax

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

-ca gzip

-ca lz4

Príklady

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

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

Súbory môžete spravovať aj v návrhárovi kociek, vo webovom rozhraní Essbase alebo v rozhraní REST API.

Syntax

version

Príklad

esscs version