הפניה לפקודת CLI

לפני שתוכל ליצור פקודות CLI אחרות כלשהן ל-Essbase, עליך לבצע התחברות. אם דרוש חיבור מאובטח, כתובת ה-URL צריכה להתחיל ב-https.

תוכל לבצע איצות בדרכים הבאות תוך שימוש ב-CLI:

• השתמש ב-setpassword פעם אחת כדי שהסיסמה שלך תאוחסן עבור שילוב הלקוחות/משתמשים שלך. במושבי עבודה עוקבים תוכל להשתמש בפקודת login בלי שתתבקש להזין סיסמה.
• השתמש באפשרויות -user -password יחד עם הפקודה login (שים לב: הסיסמה מופיעה בחלון המעטפת כטקסט רגיל).
• השתמש רק באפשרות -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

אתה גם יכול להריץ תסריטי חישוב באמצעות האפשרות 'חשב' ב-Cube Designer או 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])}" 

אתה יכול לנקות נתונים גם באמצעות האפשרות 'טעינת נתונים' ב-Cube Designer, 'עבודות' בממשק האינטרנט של 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 ואילך, מנהלן השירות צריך ליצור מחדש את כל החיבורים שנשמרו באופן מקומי שנוצרו באמצעות פקודה זו במהדורה קודמת.

דוגמאות

פקודה זו דורשת אחד מסלי האפשרויות הבאים:

• קובץ נתונים וקובץ כללים אופציונלי

• קובץ כללים עם שם משתמש וסיסמה

• אפשרות הזרמה מפנה לחיבור מקומי שמור

מסד הנתונים מקור אמור להיות נגיש בתוך רשת הלקוח, כי לא כל מנהלי ההתקנים של מסדי נתונים יכולים לעבוד עם שרתי פרוקסי של Java.

לטעינת נתונים, עליך קודם לטעון את הנתונים ואת קובצי הכללים אל ספריית הקובייה. אפשר להשתמש ב-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"

אתה יכול גם לטעון נתונים באמצעות Cube Designer, 'עבודות' בבממשק האינטרנט של 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

אתה יכול לנהל קבצים גם ב-Cube Designer, בממשק האינטרנט של 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

אתה גם יכול לפרוס קוביות באמצעות Cube Designer, או על-ידי שימוש באפשרות 'יבוא' בחלק יישומים של ממשק האינטרנט של 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

אתה יכול גם לטעון ממדים באמצעות Cube Designer, 'עבודות' בבממשק האינטרנט של 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

אתה יכול לנהל קבצים גם ב-Cube Designer, בממשק האינטרנט של 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 הושלם, ייתכן שיהיה עליך לבצע פעולה נוספת כדי לשחזר חיבורים שהועברו למקורות חיצוניים. לשם כך, פתח את החיבור והזן את הסיסמה.

• כאשר קיימות מחיצות בין קוביות שעוברות הגירה, יש לייבא את מקור הנתונים לפני יעד הנתונים. אחרת, ייתכן שהגדרות המכירה לא ישוחזרו.

  פעולות יבוא של ניהול מחזור חיי מוצר (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"

אתה יכול לנהל קבצים גם ב-Cube Designer, בממשק האינטרנט של 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

אתה יכול לנהל קבצים גם ב-Cube Designer, בממשק האינטרנט של Essbase, או ב-REST API.

תחביר

version

דוגמה

esscs version