การอ้างอิงคำสั่ง CLI

คุณต้องล็อกอินก่อนที่จะออกคำสั่ง CLI อื่นๆ ไปยัง Essbase หากจำเป็นต้องใช้การเชื่อมต่อที่มีการรักษาความปลอดภัย URL ต้องเริ่มต้นด้วย https

คุณสามารถตรวจสอบสิทธิ์โดยใช้ CLI ด้วยวิธีต่อไปนี้

• ใช้ setpassword ทันทีเพื่อให้มีการจัดเก็บรหัสผ่านสำหรับค่าผสมของไคลเอนต์/ผู้ใช้ของคุณ ในเซสชันถัดไป คุณสามารถใช้คำสั่ง login ได้โดยไม่ต้องแสดงพรอมต์ให้ป้อนรหัสผ่าน
• ใช้ตัวเลือก -user และ -password พร้อมกับคำสั่ง login (ข้อควรระวัง: รหัสผ่านจะปรากฏในวินโดว์ shell เป็น cleartext)
• ใช้เฉพาะตัวเลือก -user พร้อมกับคำสั่ง login คุณจะได้รับพรอมต์ให้ป้อนรหัสผ่าน ซึ่งเป็นรหัสผ่านแบบซ่อน

หากคุณเป็นผู้ใช้ SSO การรวมศูนย์ ใน Oracle Identity Cloud Service ระบบจะไม่รองรับการล็อกอินโดยใช้ 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 เป็นผู้ดูแลระบบ Identity Cloud Service ที่ได้รับการตั้งค่าเป็นผู้ดูแลระบบ Essbase เริ่มต้นในระหว่างการใช้งานสแต็ค Essbase ใน Oracle Cloud Infrastructure เนื่องจากไม่ได้ป้อนรหัสผ่านในตัวอย่างนี้ ระบบจะพรอมต์ให้ผู้ดูแลระบบป้อนรหัสผ่านต่อไป URL คือ essbase_url จากเอาต์พุตงานที่เป็นผลจากสแต็ค การใช้งาน

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

รูปแบบคำสั่ง (ล็อกเอาต์)

logout

ตัวอย่าง (ล็อกเอาต์)

esscs logout

ก่อนที่จะรันสคริปต์การคำนวณ คุณจะต้องอัปโหลดสคริปต์เป็นไฟล์ .csc ไปยังไดเรคทอรีของลูกบาศก์ก่อน คุณสามารถใช้ CLI เพื่ออัปโหลดไฟล์ โปรดดู อัปโหลด: เพิ่มไฟล์ลูกบาศก์

รูปแบบคำสั่ง

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

ตัวอย่าง

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

นอกจากนี้ คุณยังสามารถรันสคริปต์การคำนวณโดยใช้ตัวเลือก คำนวณ ในเครื่องมือออกแบบลูกบาศก์หรือ Smart View, งานในเว็บอินเตอร์เฟซ 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])}" 

นอกจากนี้ คุณยังสามารถล้างข้อมูลโดยใช้ตัวเลือก โหลดข้อมูล ในเครื่องมือออกแบบลูกบาศก์ งานในเว็บอินเตอร์เฟซ Essbase หรือ REST API หรือ การรีเซ็ต DBS-NAME ของการแก้ไขฐานข้อมูลใน MaxL

คำอธิบาย

ผู้ดูแลบริการต้องใช้คำสั่งนี้เพื่อสร้างและบันทึกการเชื่อมต่อในระบบก่อน ผู้อื่นจึงจะสามารถใช้คำสั่ง dataload หรือ dimbuild ของ CLI ด้วยตัวเลือกการสตรีม นอกจากนี้ คุณยังต้องตั้งค่าตัวแปรแวดล้อม 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 พร้อมตัวเลือกการสตรีม

หมายเหตุ

หลังจากย้ายไปที่รีลีส 21.4 หรือสูงกว่า ผู้ดูแลบริการจะต้องสร้างการเชื่อมต่อในระบบที่สร้างด้วยคำสั่งนี้ในรีลีสก่อนหน้าใหม่

ตัวอย่าง

คำสั่งนี้ต้องใช้หนึ่งในชุดของตัวเลือกต่อไปนี้

• ไฟล์ข้อมูลและไฟล์กฎที่เลือกระบุได้

• ไฟล์กฎที่มีชื่อผู้ใช้และรหัสผ่าน

• ตัวเลือกสตรีมที่อ้างอิงการเชื่อมต่อในระบบที่บันทึกไว้

ฐานข้อมูลที่มาต้องสามารถเข้าใช้ได้ภายในเน็ตเวิร์กของไคลเอนต์ เนื่องจากไม่ใช่ไดรเวอร์ฐานข้อมูลทั้งหมดที่สามารถทำงานร่วมกับพร็อกซี่จาวาได้

ในการโหลดข้อมูล คุณต้องอัปโหลดไฟล์การโหลดข้อมูลและไฟล์กฎไปยังไดเรคทอรีของลูกบาศก์ก่อน คุณสามารถใช้ CLI เพื่ออัปโหลดไฟล์ โปรดดู อัปโหลด: เพิ่มไฟล์ลูกบาศก์

รูปแบบคำสั่ง

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"

นอกจากนี้ คุณยังสามารถโหลดข้อมูลโดยใช้เครื่องมือออกแบบลูกบาศก์, งานต่างๆ ใน เว็บอินเตอร์เฟซ 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

นอกจากนี้คุณสามารถจัดการไฟล์ในเครื่องมือออกแบบลูกบาศก์, เว็บอินเตอร์เฟซ 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

นอกจากนี้ คุณยังสามารถใช้งานลูกบาศก์โดยใช้เครื่องมือออกแบบลูกบาศก์ หรือโดยใช้ตัวเลือกอิมปอร์ตในส่วนแอปพลิเคชัน ของ เว็บอินเตอร์เฟซ Essbase

คุณต้องอัปโหลดไฟล์รุ่นไดเมนชันและไฟล์กฎไปยัง Essbase ก่อนที่จะโหลดไดเมนชันได้ คุณสามารถใช้ CLI เพื่ออัปโหลดไฟล์ โปรดดู อัปโหลด: เพิ่มไฟล์ลูกบาศก์

รูปแบบคำสั่ง

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

นอกจากนี้ คุณยังสามารถโหลดไดเมนชันโดยใช้เครื่องมือออกแบบลูกบาศก์, งานต่างๆ ใน เว็บอินเตอร์เฟซ 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

นอกจากนี้คุณสามารถจัดการไฟล์ในเครื่องมือออกแบบลูกบาศก์, เว็บอินเตอร์เฟซ 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

อาร์ติแฟคต์ลูกบาศก์อาจรวมถึงไฟล์ข้อมูล เวิร์กบุค ไฟล์กฎ ไฟล์สคริปต์การคำนวณ หรืออาร์ติแฟคต์อื่นๆ อาร์ติแฟคต์ลูกบาศก์ได้แก่ ไฟล์ต้องใช้เพื่อดำเนินการในแอปพลิเคชันและลูกบาศก์

ในการแสดงไฟล์สำหรับลูกบาศก์ คุณต้องมีสิทธิ์ของการเข้าใช้ฐานข้อมูลสำหรับแอปพลิเคชันเป็นอย่างน้อย ไม่ต้องมีสิทธิ์พิเศษในการแสดงไฟล์ต่างๆ จากไดเรคทอรีผู้ใช้ของคุณ

รูปแบบคำสั่ง

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

ตัวอย่าง

esscs listfiles -t rul -a Sample -d Basic 

esscs listfiles -CP "/shared"

นอกจากนี้คุณสามารถจัดการไฟล์ในเครื่องมือออกแบบลูกบาศก์, เว็บอินเตอร์เฟซ 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

นอกจากนี้คุณสามารถจัดการไฟล์ในเครื่องมือออกแบบลูกบาศก์, เว็บอินเตอร์เฟซ Essbase หรือ REST API ได้ด้วย

รูปแบบคำสั่ง

version

ตัวอย่าง

esscs version