واجهة أوامر CLI

قبل أن تتمكن من إصدار أوامر واجهة سطر الأوامر إلى Essbase، عليك تسجيل الدخول. إذا لزم توفير اتصال آمن، فيجب أن يبدأ عنوان URL ببروتوكول https.

يمكنك المصادقة بالطرق التالية مستخدمًا CLI:

• استخدم أمر setpassword مرة واحدة لتخزين كلمة السر الخاصة بتوليفة العميل/المستخدم. وفي جلسات العمل اللاحقة، يمكنك استخدام أمر login بدون أن يتم توجيهك إلى إدخال كلمة سر.
• استخدم الخيارين -user و-password مع أمر login (تنبيه: تظهر كلمة السر في نافذة شل على شكل نص فارغ).
• لا تستخدم الخيار -user إلا مع أمر login. سيتم توجيهك إلى إدخال كلمة السر التي تكون مخفية.

إذا كنت مستخدم تسجيل دخول موحد في Oracle Identity Cloud Service، فإن تسجيل الدخول باستخدام MaxL أو CLI غير مدعوم. يتطلب تسجيل الدخول الموحد نافذة متصفح. قم بإنشاء مستخدم Identity Cloud Service أصلي، واستخدمه بدلاً من تسجيل الدخول باستخدام MaxL أو واجهة سطر الأوامر.

الصياغة (أمر 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. لأنه لم يتم إدخال كلمة السر في هذا المثال، فسيتم طلبها من المسؤول بعد ذلك. عنوان URL هو 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

يمكنك أيضًا تشغيل اسكربتات العمليات الحسابية باستخدام خيار "العملية الحسابية" في 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 مع خيار الدفق. يجب عليك أيضًا تعيين متغير البيئة 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، يمكنك دفق عمليات تحميل البيانات أو نُسخ الأبعاد باستخدام واجهة سطر الأوامر، من خلال استخدام هذا الأمر أولاً لإنشاء اتصال محلي ثم إصدار تحميل البيانات أو أمر dimbuild بخيار دفق.

ملاحظات

بعد الترحيل إلى الإصدار 21.4 أو أعلى، على مسؤول الخدمة إعادة تكوين أي اتصالات محلية محفوظة تم تكوينها باستخدام هذا الأمر في إصدار سابق.

أمثلة

يتطلب هذا الأمر إحدى مجموعات الخيارات التالية:

• ملف البيانات وملف القاعدة الاختياري

• ملف القاعدة مع اسم المستخدم وكلمة السر

• خيار الدفق Stream يشير إلى اتصال محلي محفوظ

يجب أن يمكن الوصول إلى قاعدة البيانات المصدر في شبكة العميل، لأنه لا يمكن لكل برامج تشغيل قواعد البيانات العمل مع وكلاء 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"

يمكنك أيضًا تحميل البيانات باستخدام 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 في تحميل الملفات. يرجى الاطلاع على أمر 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

يمكنك أيضًا تحميل الأبعاد باستخدام 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، بتصدير كل التطبيقات إلى الدليل المحلي الحالي الذي تم استدعاء أمر واجهة سطر الأوامر منه.

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