Reference CLI naredbi

Essbase CLI naredbe koje izdajete u esscs ljusci pomažu vam u obavljanju rutinskih operacija platforme uključujući: calc, dataload, dimbuild, lcmexport, lcmimport, prijenos i preuzimanje elemenata, pokretanje i zaustavljanje aplikacije ili kocke itd.

U sučelju s naredbenim retkom dostupne su sljedeće naredbe. Argumenti za naredbe mogu se izdavati bilo kojim redoslijedom.

Za prikazivanje pomoći za sve naredbe upišite esscs -h. Za prikazivanje pomoći za određenu naredbu upišite esscs naredba -h.

Za uključivanje opisnog prikaza za bilo koju naredbu, odnosno prikazivanje dodatnih informacija (ako su dostupne), upišite esscs naredba -v argumenti naredbe.

Prijava/odjava: CLI provjera autentičnosti

CLI naredba login za Essbase provjerava vašu autentičnost za Essbase kako biste mogli upotrebljavati CLI.

Prije izdavanja bilo kojih drugih CLI naredbi u Essbase, morate se prijaviti. Ako je obvezna sigurna veza, URL mora započinjati s https.

Putem CLI-ja svoju autentičnost možete potvrditi na sljedeće načine:

  • Jednom upotrijebite setpassword kako biste spremili lozinku za svoju kombinaciju klijenta i korisnika. U sljedećim ćete sesijama moći upotrebljavati naredbu login bez upita za unos lozinke.
  • Upotrijebite opcije -user i -password s naredbom login (Oprez: lozinka se u prozoru ljuske prikazuje kao obični tekst).
  • Opciju -user upotrebljavajte samo s naredbom login. Od vas će se zatražiti unos lozinke, koja je skrivena.

Ako ste objedinjeno SSO korisnik u servisu Oracle Identity Cloud Service, prijava u MaxL ili CLI nije podržana. Objedinjena SSO prijava zahtijeva prozor preglednika. Stvorite nativnog korisnika servisa Identity Cloud Service i prijavite se na taj način umjesto putem MaxL-a ili CLI-ja.

Sintaksa (prijava)

login [-verbose] -essbaseurl https://instance-name.example.com/essbase -user username [-password password]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-essbaseurl -url Adresa instance servisa Essbase
-user -u Korisničko ime
-password -p Po izboru. Lozinka za korisnika. Alternativno, lozinku postavite u skladu s uputama u poglavlju setpassword.

Ako naredbu za prijavu izdajete iz skripte, a lozinka sadrži posebne znakove, unesite je između navodnika (npr., "aNb3^5%9$!").

Upotreba znaka $ (znak dolara) u Essbase lozinki nije podržana za prijavu u Linux okruženju.

Primjer 1 (prijava)

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

Primjer 2 (prijava)

U sljedećem primjeru, korisnik koji se prijavljuje, admin1@example.com administrator je servisa Identity Cloud Service koji je postavljen kao početni administrator servisa Essbase pri implementaciji stoga Essbase u okruženju Oracle Cloud Infrastructure. Budući da u ovom primjeru nije unesena lozinka, administrator će dobiti upit da je osigura naknadno. URL je essbase_url iz izlaznih vrijednosti zadatka koje proizlaze iz stoga implementacija.

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

Sintaksa (odjava)

logout

Primjer (odjava)

esscs logout

Izračun: Pokretanje izračunske skripte

CLI naredba calc za Essbase izvršava izračunsku skriptu u kocki. Za pokretanje te naredbe morate imati najmanje dopuštenje za ažuriranje baza podataka, kao i osiguran pristup izračunskoj skripti.

Prije nego što možete pokrenuti izračunske skripte, najprije morate učitati skripte kao .csc datoteke u direktorij kocke. Za učitavanje datoteka možete upotrebljavati CLI. Pogledajte Učitavanje: dodavanje datoteka kocke.

Sintaksa

calc [-verbose] -application appname -db cubename -script scriptfilename
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Naziv baze podataka (kocke)
-script -s Naziv izračunske skripte. Mora imati datotečni nastavak .csc. Ne morate navesti cijeli put. Pretpostavlja se da se datoteke nalaze u relevantnom direktoriju kocke.

Primjer

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

Osim toga, možete pokrenuti izračunske skripte pomoću opcije Izračunaj u alatu Cube Designer ili značajci Smart View, Zadaci u web-sučelju Essbase ili REST API-ju ili pokrenuti izračun u MaxL-u.

Čišćenje: uklanjanje podataka iz kocke

CLI naredba clear za Essbase čisti podatke iz kocke. Za upotrebu te naredbe trebate barem dopuštenje za ažuriranje baze podataka.

Sintaksa

clear [-verbose] -application appname -db cubename [-option clearOption[-regionspec regionSpec]]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Naziv baze podataka (kocke)
-option -O Po izboru. Ključna riječ koja određuje što treba izbrisati. Ako je izostavite, zadana opcija bit će ALL_DATA.

Opcije za block storage kocke:

  • ALL_DATA — čiste se podaci, povezani objekti i struktura

  • UPPER_LEVEL — blokovi najviše razine brišu se

  • NON_INPUT — blokovi bez unosa brišu se

Opcije za aggregate storage kocke:

  • ALL_DATA — čiste se podaci, povezani objekti i struktura

  • ALL_AGGREGATIONS

    — čiste se svi sabrani podaci

  • PARTIAL_DATA

    — čisti se samo navedeno područje podataka. Upotreba s -regionspec
-regionspec -rs MDX izraz koji određuje područje za brisanje

Primjer

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

Podatke možete očistite i putem opcije za učitavanje podataka u alatu Cube Designer, Zadaci u web-sučelju Essbase, putem REST API-ja ili izmjenom baze podataka DBS-NAME uz ponovno postavljanje u MaxL.

Createlocalconnection: spremanje JDBC veze

CLI naredba createlocalconnection za Essbase stvara JDBC vezu i pohranjuje je lokalno. Za upotrebu te naredbe morate imati ulogu administratora ili naprednog korisnika.

Opis

Administrator servisa mora upotrijebiti ovu naredbu za stvaranje i spremanje lokalne veze prije nego što bilo tko može upotrebljavati dataload ili dimbuild naredbe uz opciju prijenosa. Morate i postaviti varijablu okruženja EXTERNAL_CLASSPATH koja će upućivati na .jar datoteku vašeg upravljačkog programa baze podataka (pogledajte poglavlje Izrada dimenzija i učitavanje podataka prijenosom iz udaljene baze podataka).

Sintaksa

createLocalConnection [-verbose] -name streamConnection -connectionstring  connectionString -user userName [-driver jdbcDriver] [-password password]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-name -N Naziv veze
-connectionstring -cs JDBC niz za povezivanje. Format može biti s nazivom servisa, kao u nastavku: 
jdbc:oracle:thin:@host:port/service_name

ili s SDI-om, kao u nastavku:

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

Gornji formati sintakse primjenjuju se na Oracle Database. Pogledajte odjeljak Primjeri za manje razlike u sintaksi niza veze kada radite s drugim pružateljima.
-user -u Korisničko ime
-driver -D JDBC upravljački program. Ako ne postoji, Oracle baza podataka smatra se zadanom, kao što je oracle.jdbc.driver.OracleDriver
-password -p Lozinka (opcionalno)

Ako imate mrežnu vezu između vanjskog izvora podataka i servisa Essbase, najučinkovitije je definirati veze na razini aplikacije ili globalne veze i izvore podataka u web-sučelju Essbase. Te će vam definicije olakšati "povlačenje" podataka iz vanjskog izvora. Ako nemate mrežnu vezu između servisa Essbase i vanjskog izvora podataka, učitavanje podataka ili izradu dimenzija možete usmjeravati putem alata CLI, tako da prvo pomoću te naredbe izradite lokalnu vezu, a zatim izdate naredbu dataload ili dimbuild pomoću opcije za usmjeravanje.

Napomene

Nakon migracije na izdanje 21.4 ili noviju verziju, administrator servisa mora ponovo stvoriti sve spremljene lokalne veze koje su stvorene s pomoću ove naredbe u prethodnom izdanju.

Primjeri

Ako ne postoje opcija -driver i parametar jdbcDriver, pretpostavlja se da je Oracle baza podataka zadana baza podataka.

esscs createLocalConnection -N OracleDBConnection2 -cs jdbc:oracle:thin:@host1.example.com:1521/ORCL.esscs.host1.oraclecloud.com -u OracleUser

Ako ne postoje opcija -driver i parametar jdbcDriver, pretpostavlja se da je Oracle baza podataka zadana baza podataka.

esscs createLocalConnection -N OracleDBConnection1 -cs jdbc:oracle:thin:@myhostname01:1521:ORCL -u OracleUser -D oracle.jdbc.driver.OracleDriver

Ako ne postoje opcija -driver i parametar jdbcDriver, pretpostavlja se da je Oracle baza podataka zadana baza podataka.

esscs createLocalConnection -N DB2conn -cs jdbc:db2://myhostname02.example.com:50000/TBC -u myDB2User -D com.ibm.db2.jcc.DB2Driver

Ako ne postoje opcija -driver i parametar jdbcDriver, pretpostavlja se da je Oracle baza podataka zadana baza podataka.

esscs createLocalConnection -N MySQLconn -cs jdbc:mysql://myhostname03.example.com:3306/tbc -u MySQLUsr -D com.mysql.jdbc.Driver

Ako ne postoje opcija -driver i parametar jdbcDriver, pretpostavlja se da je Oracle baza podataka zadana baza podataka.

esscs createLocalConnection -N MSSQLConn -cs jdbc:sqlserver://myhostname04.example.com:1433 -u MSSQLUsr -D com.microsoft.sqlserver.jdbc.SQLServerDriver

Ako ne postoje opcija -driver i parametar jdbcDriver, pretpostavlja se da je Oracle baza podataka zadana baza podataka.

esscs createLocalConnection -N TeraDconn -cs jdbc:teradata://myhostname05.example.com/DBS_PORT=1025 -u TeraUsr -D com.teradata.jdbc.TeraDriver

Dataload: Učitavanje podataka u kocku

CLI naredba dataload za Essbase učitava podatke u kocku. Za upotrebu te naredbe trebate barem dopuštenje za ažuriranje baze podataka.

Ova naredba zahtijeva jedan od sljedećih skupova opcija:

  • Podatkovna datoteka i neobavezna datoteka s pravilima

  • Datoteka s pravilima s korisničkim imenom i lozinkom

  • Opcija prijenosa koja se odnosi na spremljenu lokalnu vezu

Izvorna baza podataka treba biti dostupna unutar klijentske mreže, jer ne mogu svi upravljački programi baze podataka raditi s Java proxy poslužiteljima.

Za učitavanje podataka najprije morate učitati podatke i datoteke s pravilima u direktorij kocke. Za učitavanje datoteka možete upotrebljavati CLI. Pogledajte Učitavanje: dodavanje datoteka kocke.

Sintaksa

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]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Naziv baze podataka (kocke)
-file -f Naziv datoteke za učitavanje podataka. Ne morate navesti cijeli put. Pretpostavlja se da se datoteke nalaze u relevantnom direktoriju baze podataka. Umjesto te opcije možete upotrijebiti -catalogfile.
-rule -r Po izboru. Naziv datoteke s pravilima. Ne morate navesti cijeli put. Pretpostavlja se da se datoteke nalaze u relevantnom direktoriju baze podataka. Umjesto te opcije možete upotrijebiti -catalogrulefile.
-catalogfile -CF Naziv datoteke za učitavanje podataka iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -file.
-catalogrulefile -CRF Naziv datoteke pravila iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -rule.
-user -u Po izboru. Ime korisnika. Zahtijeva lozinku, ako se upotrebljava.

Ako upotrebljavate spremljenu vezu i izvor podataka, od vas se neće tražiti korisničko ime i lozinka. Ako ne upotrebljavate spremljenu vezu, a datoteka pravila povezuje se s RDBMS-om, odaberite korisničko ime i lozinku za povezivanje s RDBMS-om.
-password -p Po izboru. Lozinka za korisnika. Ako je izostavite, korisniku će se prikazati odzivnik za lozinku.
-stream -S Po izboru. Upotreba učitavanja podataka za prijenos. Zahtijeva opciju -conn, ako se upotrebljava.
-connection -conn Zahtijeva se ako se upotrebljava opcija prijenosa. Naziv spremljene veze koja je stvorena s pomoću createlocalconnection CLI naredbe.
-query -q Po izboru. Upit baze podataka koji se šalje zajedno s učitavanjem podataka za prijenos.
-rows -rows Po izboru. Broj redova za istovremeni prijenos. Zadana vrijednost je 100.
-abortOnError -abort Prekid učitavanja podataka u slučaju pogreške

Primjeri

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"

Podatke možete učitati i s pomoću alata Cube Designer, značajke Zadaci u Essbase web-sučelju ili REST API-ja ili pak možete uvesti podatke u MaxL.

Deletefile: uklanjanje datoteka kocke

CLI naredba deletefile za Essbase uklanja elemente kocke iz aplikacije, baze podataka ili početnog direktorija korisnika. Za brisanje datoteka iz kocke trebat će vam najmanje dopuštenje upravitelja bazama podataka. Za brisanje datoteka iz vlastitog korisničkog direktorija nisu potrebne posebne dozvole.

Sintaksa

deletefile [-verbose] -file fileName [-application application [-db  database] [| -catalogfile catalogFile]]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-file -f Naziv datoteke za brisanje
-application -a Po izboru. Naziv aplikacije. Ako nije definirano, smatra se da se datoteke nalaze u vašem korisničkom početnom direktoriju.
-database -db Po izboru. Naziv baze podataka (kocke)
-catalogfile -CF Naziv i put datoteke iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -file.

Primjeri

esscs deletefile -a Sample -d Basic -f Act1.rul
esscs deletefile -CF /shared/Data.txt

Osim toga, datotekama možete upravljati u alatu Cube Designer, u web-sučelju Essbase ili REST API-ju.

Implementacija: stvaranje kocke iz radne knjige

CLI naredba deploy za Essbase stvara kocku iz Excel aplikacijske radne knjige. Za pokretanje te naredbe morate imati najmanje ulogu superkorisnika.

Sintaksa

deploy [-verbose] -file fileName [-application application [-database database] | -catalogfile catalogFile] [-restructureoption restructureOption] [-loaddata] [-recreateapplication] [-createfiles] [-executescript]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-file -f Naziv datoteke aplikacijske radne knjige
-application -a Po izboru. Naziv aplikacije. Ako nije naveden, aplikacijski naziv će se uzeti iz radne knjige.
-database -db Po izboru. Naziv baze podataka (kocke). Ako nije naveden, naziv baze podataka uzet će se iz radne knjige.
-catalogfile -CF Aplikacijska radna knjiga iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -file.
-loaddata -l Po izboru. Učitajte podatke, ako aplikacijska radna knjiga sadržava podatkovni radni list. U suprotnom se u kocku uvoze samo metapodaci.
-restructureoption -R Po izboru. Ključna riječ koja označava željenu opciju restrukturiranja.

Opcije za block storage kocke:

  • ALL_DATA — očuvanje svih podataka

  • NO_DATA — bez očuvanja podataka

  • LEAFLEVEL_DATA — očuvanje podataka na nultoj razini (razina lista)

  • INPUT_DATA — očuvanje ulaznih podataka

Opcije za aggregate storage kocke:

  • ALL_DATA — očuvanje svih podataka

  • NO_DATA — bez očuvanja podataka
-recreateapplication -ra Po izboru. Ponovno stvorite aplikaciju ako već postoji
-createfiles -cf Po izboru. Stvorite elemente kocke u direktoriju datoteka u servisu Essbase.
-executescript -e Po izboru. Izvršavanje izračunskih skripti. Primjenjivo samo ako aplikacijska radna knjiga sadržava izračunski radni list za koji je vrijednost opcije Izvrši izračun u definicijama postavljena na Da.

Primjeri

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

Osim toga, kocke možete implementirati pomoću alata Cube Designer ili pomoću opcije Uvezi u odjeljku Aplikacije web-sučelja Essbase.

Dimbuild: Učitavanje dimenzija u kocku

CLI naredba dimbuild za Essbase učitava dimenzije u kocku. Za pokretanje te naredbe potrebno vam je najmanje dopuštenje za upravitelja bazama podataka za kocku.

Prije nego što možete učitati dimenzije, najprije u Essbase morate učitati konstrukciju dimenzije i datoteke pravila. Za učitavanje datoteka možete upotrebljavati CLI. Pogledajte Učitavanje: dodavanje datoteka kocke.

Sintaksa

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]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Naziv baze podataka (kocke)
-file -f Naziv datoteke s konstrukcijom dimenzije. Ne morate navesti cijeli put. Pretpostavlja se da se datoteke nalaze u relevantnoj aplikaciji ili direktoriju baze podataka. Umjesto te opcije možete upotrijebiti -catalogfile.
-rule -r Naziv datoteke s pravilima. Ne morate navesti cijeli put. Pretpostavlja se da se datoteke nalaze u relevantnoj aplikaciji ili direktoriju baze podataka. Umjesto te opcije možete upotrijebiti -catalogrulefile.
-catalogfile -CF Naziv datoteke s konstrukcijom dimenzije iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -file.
-catalogrulefile -CRF Naziv datoteke pravila iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -rule.
-user -u Po izboru. Ime korisnika. Zahtijeva lozinku, ako se upotrebljava.

Ako upotrebljavate spremljenu vezu i izvor podataka, od vas se neće tražiti korisničko ime i lozinka. Ako ne upotrebljavate spremljenu vezu, a datoteka pravila povezuje se s RDBMS-om, odaberite korisničko ime i lozinku za povezivanje s RDBMS-om.
-password -p Po izboru. Lozinka za korisnika. Ako je izostavite, korisniku će se prikazati odzivnik za lozinku.
-stream -S Po izboru. Upotreba konstrukcije dimenzije koja se šalje prijenosom. Zahtijeva opciju -conn, ako se upotrebljava.
-connection -conn Zahtijeva se ako se upotrebljava opcija prijenosa. Naziv spremljene veze koja je stvorena s pomoću createlocalconnection CLI naredbe.
-query -q Po izboru. Upit baze podataka koji se šalje zajedno s izradom dimenzije za prijenos.
-rows -rows Po izboru. Broj redova za istovremeni prijenos. Zadana vrijednost je 100.
-restructureOption -R

Kontrolira odabire očuvanja za preuređivanje strukture.

Za block storage moguće su sljedeće opcije:

  • ALL_DATA: Pri učitavanju dimenzija očuvat će se svi podaci.
  • NO_DATA: Podatci se neće očuvati.
  • LEAFLEVEL_DATA: Očuvat će se samo podatkovne vrijednosti na nultoj razini. Ako su svi potrebni podaci za izračun u članovima razine 0, odaberite ovu opciju. Prije restrukturiranja kocke izbrisat će se svi blokovi gornje razine. Pri ponovnom izračunu kocke ponovo će se stvoriti blokovi gornje razine.
  • INPUT_DATA: Očuvat će se samo ulazni podaci.

Za aggregate storage moguće su sljedeće opcije:

  • ALL_DATA: Pri učitavanju dimenzija očuvat će se svi podaci.
  • NO_DATA: Podatci se neće očuvati.
-forcedimbuild -F Nastavak izrade dimenzije čak i ako su u tijeku druge korisničke aktivnosti. Poništava aktivne korisničke sesije.

Primjeri

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

Dimenzije možete učitati i u alatu Cube Designer, na kartici Zadaci u Essbase web-sučelju, u REST API-ju ili možete uvesti dimenzije u MaxL.

Preuzimanje: dohvaćanje datoteka kocke

CLI naredba download za Essbase preuzima elemente kocke iz instance servisa Essbase u lokalni direktorij.

Možda ćete morati preuzeti tekstne datoteke, datoteke s pravilima, datoteke izračunskih skripti ili datoteke skripte iz kocke, tako da možete raditi na njima ili ih učitati u drugu kocku. Za preuzimanje artefakata kocki trebate barem dopuštenje za ažuriranje baze podataka.

Sintaksa

download [-verbose] -file filename[ | -catalogfile catalogFile] [-application appname [-db cubename]] [-localdirectory path] [-overwrite] [-nocompression]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-file -f Naziv datoteke za preuzimanje
-application -a Po izboru. Naziv aplikacije. Ako nije predviđeno, elementi se preuzimaju iz korisničkog početnog direktorija.
-db -d Po izboru. Naziv baze podataka (kocke)
-catalogfile -CF Datoteka iz kataloga datoteka. Tu opciju možete upotrijebiti umjesto -file.
-localdirectory -ld Po izboru. Put za lokalni direktorij
-overwrite -o Po izboru. Zapisivanje preko postojeće datoteke
-nocompression -nc Po izboru. Onemogući kompresiju prijenosa podataka

Primjeri

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

Osim toga, datotekama možete upravljati u alatu Cube Designer, u web-sučelju Essbase ili REST API-ju.

Pomoć: prikaz sintakse naredbe

CLI naredba help Essbase prikazuje pomoć na razini naredbe u konzoli ili terminalu.

Sintaksa

[command] -help | -h

Primjeri

esscs -help
esscs -h
esscs dataload -help

LcmExport: stvaranje sigurnosne kopije datoteka kocke

CLI naredba lcmexport za Essbase sigurnosno kopira aplikacije i elemente kocke u Lifecycle Management (LCM) .zip datoteku koju preuzima na vaš lokalni uređaj. Za pokretanje te naredbe morate imati najmanje dopuštenje za upravitelja aplikacijama.

Sintaksa

lcmExport [-verbose] -application appname|-allApp -zipfilename filename [-localDirectory path][-threads threadscount][-skipdata][-overwrite][-generateartifactlist][-include-server-level][-cube][-exportdata][-filetype][-exportpartitions][-exportfilters][-restEncryPassword]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa.
-application -a Naziv aplikacije čiju sigurnosnu kopiju treba izraditi.
-allApp -aa Nije obavezno (i razlikuju se mala i velika slova). Ako se upotrebljava umjesto -aplikacije ,izvozi sve aplikacije u jednu zip datoteku. lcmimport može prihvatiti zip datoteke jedne aplikacije ili zip datoteke više aplikacija.
-zipfilename -z Po izboru. Naziv komprimirane datoteke za spremanje sigurnosnih kopija.
-localdirectory -ld Po izboru. Put za lokalni direktorij. Ako nije navedeno, zip je spremljen u <Application Directory>/catalog/users/<user_name> na Essbase poslužitelju.
-threads -T Po izboru. Broj niti koje treba odgoditi u slučaju paralelnog izvoza. Minimum: 10
-skipdata -skip Po izboru. Nemoj uključiti podatke u sigurnosnu kopiju.
-overwrite -o Po izboru. Zapiši preko postojeće sigurnosne kopije.
-generateartifactlist -gal Po izboru. Generiranje tekstne datoteke s potpunim popisom izvedenih elemenata. Pomoću te tekstne datoteke možete upravljati uvozom elemenata. Na primjer, možete preraspodijeliti elemente u popisu kako biste upravljali redoslijedom njihova uvoza. Možete preskočiti uvoz određenih elemenata tako da ih uklonite ili izdvojite stavke iz popisa.
-include-server-level -isl Po izboru. Uključite globalno definirane veze i izvore podataka.
-cube -c Po izboru. Izvoz jedne kocke. Ova se opcija može navesti zajedno s opcijama samo za izvoz: podataka, datoteka određenih vrsta, particija ili filtara.
-exportdata -d Po izboru. Samo izvezi podatke.
-filetype -ft

Po izboru. Samo izvezi datoteke određene vrste. Podržane vrste datoteka uključuju OTL (struktura), TXT (tekst), RUL (pravilo), CSC (izračunska skripta), DTR (definicija analitičkog izvješća) i Excel (izvoze se samo .xls datoteke. Nije izvezena nijedna .xlsx datoteka).

Primjeri:

esscs lcmexport -a sample -z sampleXLSOnly.zip -v -ft excel
esscs lcmexport -a sample -z sampleTXTOnly.zip -v -ft txt
-exportpartitions -ep

Po izboru. Samo izvezi definicije particije.

Operacije uvoza u servisu Lifecycle Management (LCM) (i uvoz u uslužnom programu za migraciju) nisu podržane za migraciju objedinjenih particija. Objedinjene particije moraju se ručno ponovo stvoriti za odredište.
-exportfilters -ef Po izboru. Samo izvezi sigurnosne filtre.
-restEncryPassword -encryPwd

Ako je aplikacija šifrirana, lozinka štiti šifriranu aplikaciju tijekom migracije. Lozinka mora sadržavati između 6 i 15 znakova te ne smije sadržavati nijedan od sljedećih posebnih znakova: ?=.,*!@#&()[{}]:;'/~$^+<>-

Oprez: zaboravljena lozinka ne može se vratiti i aplikacija se neće moći uvesti.

Napomene

Ova naredba, baš kao i ostale CLI naredbe, može se upotrebljavati Essbase računala, a uslužni program LCM mora se izvoditi na Essbase računalu.

Primjer

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

Primjer Windows skripte

Sljedeća Windows skripta, lcmexportall.bat, izvozi sve aplikacije u trenutačni lokalni direktorij iz kojeg je CLI pozvan.

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: vraćanje datoteka kocke

CLI naredba lcmimport za Essbase vraća elemente kocke iz Lifecycle Management (LCM) .zip datoteke. Za pokretanje te naredbe morate biti superkorisnik koji je stvorio aplikaciju ili administrator servisa.

Sintaksa

lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-zipfilename -z Naziv komprimirane datoteke koja sadržava datoteke sigurnosne kopije
-overwrite -o Po izboru. Ponovno stvara odredišnu aplikaciju.
-targetappName -ta Po izboru. Ako želite da se razlikuje od izvornog naziva, ciljajte na naziv aplikacije.
-artifactlist -al Po izboru. Naziv datoteke koja sadrži popis elemenata za uvoz. Tu datoteku možete generirati pomoću naredbe lcmexport.

Za preskakanje elemenata, izdvojite ili izbrišite unose s popisa. Na primjer, želite li preskočiti uvoz kontrolnih zapisa, izdvojite taj redak na sljedeći način:

# ------------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

Za kontrolu redoslijeda uvoza, prerasporedite unose za uvoz u tekstnoj datoteci.

U slučaju naredbe –overwrite, operacija uvoza izbrisat će i ponovno izraditi čitavu aplikaciju, uvozeći samo elemente s popisa. U slučaju izostanka naredbe –overwrite, operacija uvoza obuhvatit će elemente navedene na popisu, ne utječući na druge elemente koji se već nalaze u odredišnoj aplikaciji.
-include-server-level -isl Po izboru. Uključite globalno definirane veze i izvore podataka.
-restEncryPassword -encryPwd

Ako je aplikacija šifrirana, lozinka štiti šifriranu aplikaciju tijekom migracije. Lozinka mora sadržavati između 6 i 15 znakova te ne smije sadržavati nijedan od sljedećih posebnih znakova: ?=.,*!@#&()[{}]:;'/~$^+<>-

Oprez: zaboravljena lozinka ne može se vratiti i aplikacija se neće moći uvesti.

Napomene

  • Ova naredba, baš kao i ostale CLI naredbe, može se upotrebljavati Essbase računala, a uslužni program LCM mora se izvoditi unutar Essbase računala.

  • Nakon dovršetka LCM uvoza, možda ćete trebati poduzeti dodatnu radnju kako biste vratili migrirane veze u vanjske izvore. Da biste to učinili, otvorite vezu i unesite lozinku.

  • Ako postoje particije između kocki koje se migriraju, prije odredišta podataka morate uvesti izvor podataka. U suprotnom se definicije particija neće moći vratiti.

    Operacije uvoza u servisu Lifecycle Management (LCM) (i uvoz u uslužnom programu za migraciju) nisu podržane za migraciju objedinjenih particija. Objedinjene particije moraju se ručno ponovo stvoriti za odredište.

  • LCM uvoz ne migrira sigurnosne podatke drugog naziva lokacije. Morate zamijeniti sigurnosne podatke drugog naziva lokacije, bilo ponovnim stvaranjem drugih naziva lokacije s pomoću alata MaxL ili uređivanjem sigurnosnih podataka drugog naziva lokacije u XML-u izvezenom putem alata LCM Export.

Primjer

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

Listapp: prikaz aplikacija

CLI naredba listapp navodi aplikacije kojima imate pristup u ovoj instanci servisa Essbase.

Sintaksa

listapp [-verbose] [-details]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-details -dtl Po izboru. Prikazuje više pojedinosti u izlazu (vrsta aplikacije i trenutačni status).

Primjer

esscs listapp -v -dtl

Listdb: prikaz kocki

CLI naredba listdb ispisuje baze podataka kojima imate pristup unutar definirane aplikacije Essbase.

Sintaksa

listdb [-verbose] -application applicationName [details]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-application -a Naziv aplikacije
-details -dtl Po izboru. Prikazuje pojedinosti statusa u rezultatima

Primjer

esscs listdb -v -a Sample -dtl

Listfiles: prikaz datoteka

CLI naredba listfiles navodi elemente kocke koji postoje u instanci servisa Essbase.

Elementi kocke mogu sadržavati podatkovne datoteke, radne knjige, datoteke s pravilima, datoteke izračunskih skripti ili druge elemente. Elementi kocke uključuju sve datoteke koje su potrebne za izvođenje radnji na aplikacijama i kockama.

Za prikaz datoteka za kocku potrebno vam je najmanje dopuštenje za aplikaciju. Za prikaz datoteka iz vlastitog korisničkog direktorija nisu potrebne posebne dozvole.

Sintaksa

listfiles [-verbose] [-type filetype] [-application appname [-db cubename] | -catalogpath catalogPath]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-type -t Po izboru. Proširenje/vrsta datoteke za prikaz, ne uključujući razdoblje.

Podržane vrste datoteka su:

  • .csc (izračunske skripte)
  • .rul (datoteke s pravilima)
  • .txt (tekstne datoteke)
  • .msh (MaxL skripte)
  • .xls, .xlsx (radne knjige programa Excel)
  • .xlsm (Excel radne knjige s omogućenim makronaredbama)
  • .xml (XML datoteke)
  • .zip (komprimirane zip datoteke)
  • .csv (datoteke u kojima su vrijednosti odvojene zarezima)
-application -a Po izboru. Naziv aplikacije. Ako nije predviđeno, prikazuju se datoteke iz korisničkog početnog direktorija.
-db -d Po izboru. Naziv baze podataka (kocke)
-catalogpath -CP Po izboru. Put kataloga do naziva datoteke. Možete upotrebljavati umjesto -a [-d] kako biste definirali lokaciju kataloga datoteka.

Primjeri

esscs listfiles -t rul -a Sample -d Basic 
esscs listfiles -CP "/shared"

Osim toga, datotekama možete upravljati u alatu Cube Designer, u web-sučelju Essbase ili REST API-ju.

Listfilters: Prikaz sigurnosnih filtara

CLI naredba listfilters prikazuje popis Essbase sigurnosnih filtara. Za prikaz filtriranih kocki u aplikaciji trebat će vam najmanje dopuštenje za upravljanje bazama podataka u aplikaciji.

Sintaksa

listfilters [-verbose] -application appname -db cubename
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Naziv baze podataka (kocke)

Primjer

esscs listfilters -v -a Sample -d Basic

Listlocks: prikaz zaključanih podataka

CLI naredba listlocks za Essbase prikazuje sve zaključane podatkovne blokove ili objekte povezane s kockom. Za pokretanje te naredbe potrebno vam je najmanje dopuštenje za pristup bazama podataka u aplikaciji.

Sintaksa

listlocks [-verbose] -application appname -db cubename [-object]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Naziv baze podataka (kocke)
-object -obj Po izboru. Prikaz zaključanih datoteka/elemenata.

Primjer

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

Listvariables: prikaz zamjenskih varijabli

CLI naredba listvariables za Essbase navodi zamjenske varijable definirane u kocki, aplikaciji ili u globalnom opsegu. Prikaz varijabli kocke zahtijeva najmanje dopuštenje za pristup bazi podataka, prikaz varijabli aplikacije ulogu upravitelja aplikacijama, a prikaz globalnih varijabli ulogu administratora servisa.

Sintaksa

listvariables [-verbose] [-application application [-db database]]
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa.
-application -a Po izboru. Naziv aplikacije.
-database -db Po izboru. Naziv baze podataka (kocke).

Primjeri

Razina kocke

esscs listvariables -a Sample -db Basic

Razina aplikacije

esscs listvariables -a Sample

Globalna razina

esscs listvariables

Setpassword: Spremanje sigurnosnih podataka za CLI

CLI naredba setpassword za Essbase sprema lozinku povezanu s vašom kombinacijom klijenta/korisnika. U sljedeće se sesije možete prijaviti bez unosa lozinke.

Sintaksa

 setpassword [-verbose] -essbaseurl URL -user userName
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-essbaseurl -url Adresa instance servisa Essbase
-user -u Vaše korisničko ime

Napomene

Nakon migracije na izdanje 21.4 ili noviju verziju morate ponovno postaviti sve spremljene lozinke koje su spremljene s pomoću naredbe u prethodnom izdanju.

Primjer

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

Pokretanje: Pokretanje aplikacije ili kocke

CLI naredba start pokreće Essbase aplikaciju ili kocku učitavanjem u memoriju. Za pokretanje te naredbe potrebno vam je najmanje dopuštenje za pristup bazama podataka u aplikaciji.

Sintaksa

start [-verbose] -application appname [-db cubename]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Po izboru. Naziv baze podataka (kocke)

Primjer

esscs start -v -a Sample -d Basic

Stop: zaustavljanje aplikacije ili kocke

CLI naredba stop zaustavlja aplikaciju ili kocku servisa Essbase Za pokretanje te naredbe potrebno vam je najmanje dopuštenje za pristup bazama podataka u aplikaciji.

Sintaksa

stop [-verbose] -application appname [-db cubename]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-application -a Naziv aplikacije
-db -d Po izboru. Naziv baze podataka (kocke)

Primjer

esscs stop -v -a Sample -d Basic

Unsetpassword: Uklanjanje spremljenih CLI sigurnosnih podataka

CLI naredba unsetpassword za Essbase uklanja spremljene sigurnosne podatke za prijavu povezane s vašom kombinacijom klijenta/korisnika, čime se poništava efekt naredbe setpassword.

Sintaksa

unsetpassword [-verbose] -essbaseurl URL -user userName
Opcija Skraćenica Opis
-verbose -v Prikaz proširenih opisa
-essbaseurl -url Adresa instance servisa Essbase
-user -u Korisnik za kojega želite poništiti postavljanje lozinke

Primjer

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

Učitavanje: dodavanje datoteka kocke

CLI naredba upload učitava elemente kocke iz lokalnog direktorija u instancu servisa Essbase.

Kako biste izvršili zadatke poput učitavanja podataka, izrade dimenzija ili drugih operacija, možda ćete u direktorij kocke morati učitati podatkovne datoteke, datoteke s pravilima, datoteke izračunskih skripti ili druge elemente. Elemente možete učitati i u svoj korisnički direktorij.

Za učitavanje datoteka u kocku, trebat će vam najmanje dopuštenje upravitelja bazama podataka. Za učitavanje u vlastiti korisnički direktorij nisu potrebne posebne dozvole.

Bilješka:

Možete omogućiti skeniranje virusa u Essbase web-sučelju kako bi se datoteke prije učitavanja na poslužitelj skenirale radi zaštite od virusa.

Sintaksa

upload [-verbose] -file filename [-application appname [-db cubename] | -catalogpath catalogPath] [-overwrite] [-nocompression][-compressionalgorithm]
Opcija Skraćenica Opis
-verbose -v Po izboru. Prikaz proširenih opisa
-file -f Naziv datoteke za učitavanje

Bilješka:

Datotečni nastavci moraju biti napisani malim slovima. Na primjer, naziv datoteke.txt.
-application -a Po izboru. Naziv aplikacije. Ako nije navedena, datoteke će se učitati u vaš korisnički direktorij ili u put kataloga koji je definiran pod -CP.
-db -d Po izboru. Naziv baze podataka (kocke). Zahtijeva -a.
-catalogpath -CP Po izboru. Put kataloga do naziva datoteke. Možete upotrebljavati umjesto -a [-d] kako biste definirali lokaciju kataloga datoteke.
-overwrite -o Po izboru. Zapisivanje preko postojeće datoteke
-nocompression -nc Po izboru. Onemogući kompresiju prijenosa podataka
-compressionalgorithm -ca Po izboru. Raspoloživo ako se ne upotrebljava -nc. Određuje koji će se algoritam kompresije upotrijebiti za prijenos podataka. Mogući izbori: gzip ili lz4.

  • gzip—zadano ako se upotrebljava kompresija. Omogućava manji prijenos podataka sa sporijim izračunom.

  • lz4—Omogućava brži izračun sa sporijim prijenosom podataka.

Primjeri upotrebe:

-ca gzip
-ca lz4

Primjeri

esscs upload -v -f c:/temp/Maxl01.msh -a Sample -d Basic -o -ca lz4
esscs upload -f C:/temp/Act1.rul -CP /shared

Osim toga, datotekama možete upravljati u alatu Cube Designer, u web-sučelju Essbase ili REST API-ju.

Verzija: Prikaz verzije API-ja

CLI naredba version dohvaća verziju REST API-ja koja je povezana s ovom instancom servisa Essbase.

Sintaksa

version

Primjer

esscs version