Αναφορά εντολών CLI

Για να μπορέσετε να δώσετε άλλες εντολές CLI στο Essbase, πρέπει να συνδεθείτε. Εάν απαιτείται μια ασφαλής σύνδεση, η διεύθυνση τοποθεσίας πρέπει να αρχίζει με https.

Ο έλεγχος ταυτότητας όταν χρησιμοποιείτε εντολές CLI γίνεται με τους παρακάτω τρόπους:

• Χρησιμοποιήστε setpassword μία φορά για να αποθηκευτεί ο κωδικός πρόσβασης για το συνδυασμό client/χρήστη που σας αφορά. Στις επόμενες συνεδρίες, μπορείτε να χρησιμοποιείτε την εντολή σύνδεσης χωρίς να σας ζητείται να πληκτρολογήσετε κωδικό πρόσβασης.
• Χρησιμοποιήστε τις επιλογές -user και -password με την εντολή σύνδεσης (Προσοχή: ο κωδικός πρόσβασης εμφανίζεται στο παράθυρο του κελύφους ως cleartext).
• Χρησιμοποιήστε μόνο την επιλογή -user με την εντολή σύνδεσης . Θα σας ζητηθεί να πληκτρολογήσετε κωδικό πρόσβασης, ο οποίος είναι κρυφός.

Αν είστε ενοποιημένος χρήστης SSO στην υπηρεσία Oracle Identity Cloud Service, δεν υποστηρίζεται η σύνδεση με χρήση MaxL ή CLI. Η ενοποιημένη σύνδεση SSO απαιτεί παράθυρο ενός προγράμματος περιήγησης. Δημιουργήστε έναν εγγενή χρήστη της υπηρεσίας Oracle Identity Cloud Service, και συνδεθείτε με αυτόν τον χρήστη όταν χρησιμοποιείτε MaxL ή CLI.

Σύνταξη (login)

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

Παράδειγμα 1 (login)

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

Παράδειγμα 2 (login)

Στο παρακάτω παράδειγμα, ο χρήστης που πραγματοποιεί σύνδεση, admin1@example.com είναι ένας διαχειριστής της υπηρεσίας Identity Cloud Service ο οποίος ορίστηκε ως ο αρχικός διαχειριστής του Essbase κατά την ανάπτυξη στοίβας του Essbase στο Oracle Cloud Infrastructure. Επειδή δεν ζητείται κωδικός πρόσβασης σε αυτό το παράδειγμα, ο διαχειριστής θα πρέπει να το εισαγάγει στη συνέχεια. Η διεύθυνση τοποθεσίας είναι το essbase_url από τις εξόδους των εργασιών που προκύπτουν από την ανάπτυξη στοίβας.

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

Σύνταξη (logout)

logout

Παράδειγμα (logout)

esscs logout

Για την εκτέλεση δεσμών ενεργειών υπολογισμού, πρέπει πρώτα να αποστείλετε τις δέσμες ενεργειών, ως αρχεία .csc, στον κατάλογο του κύβου. Μπορείτε να χρησιμοποιήσετε το CLI για την αποστολή αρχείων. Ανατρέξτε στην ενότητα Upload: Προσθήκη αρχείων κύβων.

Σύνταξη

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

Παράδειγμα

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

Μπορείτε επίσης να εκτελείτε δέσμες ενεργειών υπολογισμού χρησιμοποιώντας την επιλογή "Υπολογισμός" στο εργαλείο σχεδιασμού κύβων ή στο Smart View, τις "Εργασίες" στο περιβάλλον εργασίας web του Essbase ή στο REST API, ή την πρόταση εκτέλεσης υπολογισμού στην MaxL.

Σύνταξη

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

Παράδειγμα

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

Μπορείτε επίσης να εκτελέσετε εκκαθάριση δεδομένων χρησιμοποιώντας την επιλογή "Φόρτωση δεδομένων" στο εργαλείο σχεδίασης κύβων, τις "Εργασίες" στο περιβάλλον εργασίας web του Essbase ή στο REST API, ή με την εντολή επαναφορά τροποποίησης βάσης δεδομένων DBS-NAME στο MaxL.

Περιγραφή

Ένας διαχειριστής υπηρεσίας πρέπει να χρησιμοποιήσει αυτήν την εντολή για να δημιουργήσει και να αποθηκεύσει την τοπική σύνδεση, ώστε οι εντολές 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, είναι πιο αποδοτικό να ορίσετε συνδέσεις επιπέδου εφαρμογής ή καθολικές συνδέσεις και προελεύσεις δεδομένων στο περιβάλλον εργασίας web του Essbase. Αυτοί οι ορισμοί σας βοηθούν να "ανακτήσετε" εύκολα δεδομένα από την εξωτερική προέλευση. Αν δεν έχετε σύνδεση δικτύου ανάμεσα στο Essbase και την εξωτερική προέλευση δεδομένων, τότε μπορείτε να διοχετεύσετε στη ροή φορτώσεις δεδομένων ή δημιουργίες διαστάσεων χρησιμοποιώντας το εργαλείο CLI, δημιουργώντας πρώτα μια τοπική σύνδεση και κατόπιν δίνοντας την εντολή dataload ή dimbuild με την επιλογή ροής.

Σημειώσεις

Ύστερα από τη μετεγκατάσταση στην Έκδοση 21.4 ή σε νεότερη έκδοση, ο διαχειριστής υπηρεσίας πρέπει να δημιουργήσει ξανά τυχόν αποθηκευμένες τοπικές συνδέσεις που είχαν δημιουργηθεί με αυτήν την εντολή σε μια προηγούμενη έκδοση.

Παραδείγματα

Αυτή η εντολή απαιτεί ένα από τα ακόλουθα σύνολα επιλογών:

• Αρχείο δεδομένων και προαιρετικό αρχείο κανόνων

• Αρχείο κανόνων με όνομα χρήστη και κωδικό πρόσβασης

• Επιλογή ροής που αναφέρει μια αποθηκευμένη τοπική σύνδεση

Η πρόσβαση στη βάση δεδομένων προέλευσης πρέπει να είναι δυνατή εντός του δικτύου του client, επειδή δεν λειτουργούν με ενδιάμεσους server 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"

Μπορείτε επίσης να εκτελέσετε φόρτωση δεδομένων χρησιμοποιώντας το εργαλείο σχεδιασμού κύβων, τις "Εργασίες" στο περιβάλλον εργασίας web του Essbase ή στο REST API ή την πρόταση εισαγωγής δεδομένων στο MaxL.

Σύνταξη

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

Μπορείτε επίσης να διαχειριστείτε αρχεία στο εργαλείο σχεδιασμού κύβων, στο περιβάλλον εργασίας web του 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

Μπορείτε επίσης να αναπτύξετε κύβους χρησιμοποιώντας το εργαλείο σχεδιασμού κύβων ή με την επιλογή "Εισαγωγή" στην ενότητα "Εφαρμογές" στο περιβάλλον εργασίας web του 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

Μπορείτε επίσης να εκτελέσετε φόρτωση διαστάσεων χρησιμοποιώντας το εργαλείο σχεδιασμού κύβων, τις "Εργασίες" στο περιβάλλον εργασίας web του Essbase ή στο REST API ή την πρόταση εισαγωγής διαστάσεων στο MaxL.

Ίσως χρειαστεί να κάνετε λήψη αρχείων κειμένου, αρχείων κανόνων ή αρχείων δέσμης ενεργειών υπολογισμού από έναν κύβο, για να εργαστείτε με αυτά ή να τα αποστείλετε σε έναν άλλον κύβο. Για τη λήψη στοιχείων κύβων, χρειάζεστε τουλάχιστον δικαίωμα ενημέρωσης βάσης δεδομένων.

Σύνταξη

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

Μπορείτε επίσης να διαχειριστείτε αρχεία στο εργαλείο σχεδιασμού κύβων, το περιβάλλον εργασίας web του 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, ίσως χρειαστεί να πραγματοποιήσετε περαιτέρω ενέργειες για να επαναφέρετε τις μετεγκατεστημένες συνδέσεις στις εξωτερικές προελεύσεις. Για να το κάνετε αυτό, ανοίξτε τη σύνδεση και εισαγάγετε τον κωδικό πρόσβασης.

• Όταν τα διαμερίσματα βρίσκονται μεταξύ κύβων που μετεγκαθιστώνται, πρέπει να εισαγάγετε την προέλευση δεδομένων πριν από τον προορισμό δεδομένων. Διαφορετικά, ενδέχεται να μην επαναφερθούν οι ορισμοί των διαμερισμάτων.

  Οι λειτουργίες εισαγωγής Lifecycle Management (LCM) (και η εισαγωγή βοηθητικού προγράμματος μετεγκατάστασης) δεν υποστηρίζονται για τη μετεγκατάσταση σε ενοποιημένα διαμερίσματα. Τα ενοποιημένα διαμερίσματα πρέπει να δημιουργηθούν ξανά μη αυτόματα στον προορισμό.

• Η εισαγωγή LCM δεν μετεγκαθιστά διαπιστευτήρια ψευδωνύμου τοποθεσίας. Πρέπει να αντικαταστήσετε τα διαπιστευτήρια ψευδωνύμου τοποθεσίας, είτε αναδημιουργώντας ψευδώνυμα τοποθεσίας με χρήση MaxL είτε τροποποιώντας τα διαπιστευτήρια ψευδωνύμου τοποθεσίας στο XML που εξαγάγατε μέσω της εξαγωγής LCM.

Παράδειγμα

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

Τα στοιχεία κύβων μπορεί να περιλαμβάνουν αρχεία δεδομένων, βιβλία εργασίας, αρχεία κανόνων, αρχεία δεσμών ενεργειών υπολογισμού ή άλλα artifact. Τα στοιχεία κύβων περιλαμβάνουν οποιαδήποτε αρχεία είναι απαραίτητα για την εκτέλεση ενεργειών σε εφαρμογές και κύβους.

Για να εμφανίσετε τα αρχεία για έναν κύβο, χρειάζεστε τουλάχιστον άδεια πρόσβασης βάσης δεδομένων για την εφαρμογή. Δεν απαιτούνται ειδικά δικαιώματα για την εμφάνιση σε λίστα των αρχείων στον δικό σας κατάλογο χρήστη.

Σύνταξη

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

Παραδείγματα

esscs listfiles -t rul -a Sample -d Basic 

esscs listfiles -CP "/shared"

Μπορείτε επίσης να διαχειριστείτε αρχεία στο εργαλείο σχεδιασμού κύβων, στο περιβάλλον εργασίας web του 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

Για να εκτελέσετε εργασίες όπως φορτώσεις δεδομένων, δημιουργίες διαστάσεων, υπολογισμούς ή άλλες λειτουργίες, ενδέχεται να πρέπει να αποστείλετε αρχεία δεδομένων, αρχεία κανόνων, δέσμες ενεργειών υπολογισμού ή άλλα artifact στον κατάλογο του κύβου. Μπορείτε επίσης να αποστείλετε τα στοιχεία στον δικό σας κατάλογο χρήστη.

Για αποστολή αρχείων σε κύβο, χρειάζεστε τουλάχιστον το δικαίωμα «Διαχειριστής βάσης δεδομένων». Δεν απαιτούνται ειδικά δικαιώματα για αποστολή στον δικό σας κατάλογο χρήστη.

Σύνταξη

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

Μπορείτε επίσης να διαχειριστείτε αρχεία στο εργαλείο σχεδιασμού κύβων, το περιβάλλον εργασίας web του Essbase, ή το REST API.

Σύνταξη

version

Παράδειγμα

esscs version