MaxLデータ定義言語の使用

キーワードは、MaxLの語彙を構成している予約語です。これには、動詞やアーティファクトのほか、ステートメントを構成するために必要なその他の単語が含まれます。MaxLでのキーワードは、データには無関係です。逆に言えば、その他のMaxLトークン(名前など)はすべて定義する必要があります。

MaxLパーサーでは、『Oracle Essbaseテクニカル・リファレンス』のMaxLのトピックに図示されているように、MaxLキーワードやその他のトークンが文法的に正しい順序で配置されていることが要求されます。

図150は、『Oracle Essbaseテクニカル・リファレンス』にあるサンプルの構文図を示しています。この図にある小文字の単語のみがキーワードを表しています。他の要素は、名前のプレースホルダか、またはユーザーによって指定される値です。

図 150. MaxL構文図の例: Alter Filter

MaxLでの名前は、データベースや、ユーザー、アプリケーション、フィルタなどのデータベース・アーティファクトを一意に識別するために使用されます。

      .
,
;
:
% 
$
"
'
*
+
-
=
<
>
[
]
{
}
(
)
?
!
 /
 \
|
 ~
`
#
&
@
^
   

      Orange
Orange22
_Orange
   

      Orange County(because the name contains a space)
22Orange (because the name begins with a number)
variable (because the name is a MaxL keyword)
   

      Sample.Basic
   

      sample.basic.filter3
   

                     create user 
                     Fiona
                      identified by 'password';
                  

                     alter user Fiona add to group 
                     Managers
                     ;
                  

                     drop replicated partition Samppart.Company from Sampeast.East at 
                     EastHost
                     ;
                  

                     create application 
                     '&New App'
                     ;
                  

                     display database 
                     '&New App'.testdb
                     ;
                  

                     drop calculation 
                     Sample.basic.'alloc.csc'
                     ;
                  

                     display filter row 
                     sample.basic.filter1
                     ;
                  

                     drop function 
                     sample.'@COVARIANCE'
                     ;
                  

                     create function 
                     '@JSUM'
                      as 'CalcFnc.sum'; 
                  

                     drop location alias 
                     Main.Sales.EasternDB
                     ;
                  

                     grant 
                     designer
                      on database Sample.basic to Fiona;
                  

                     alter system add variable 
                     Current_month
                     ; 
alter system set variable 
                     Current_month
                      July;
                  

                     alter database AP.main1 add disk volume 
                     G
                     ;
alter database AP.main1 set disk volume 
                     G
                      partition_size 200mb;
display disk volume 
                     sample.basic.C
                     ;
                  

文字列は、MaxLステートメント内で、コメント、メンバー式、計算スクリプトおよびファイル参照のテキストを表すために使用されます。文字列は、任意の有効な文字で始めることができます。名前と同様に、空白または特殊文字を含む文字列は一重引用符で囲む必要があります。

有効な特殊文字のリストについては、名前のルールを参照してください。

表163は、文字列であるステートメント要素の例を示しています:

                     create user Fiona identified by 
                     sunflower
                     ;
                  

                     alter group Financial comment 
                     'Reports due July 31'
                     ;
                  

                     create filter sample.basic.filt1 read on 'Sales,
                     @ATTRIBUTE(Bottle)
                     '; 
create or replace replicated partition sampeast.east area 
                     '@IDESC(East), @IDESC(Qtr1)'
                      to samppart.company mapped globally '("Eastern Region")' to '(East)';
                  

                     execute calculation
 
                     '"Variance"=@VAR(Actual, Budget);
  "Variance %"=@VARPER(Actual, Budget);'
                     
on Sample.basic;
                  

                     spool on to 
                     '/homes/fiona/out.txt'
                     ;
                  

数値は、MaxLステートメント内で、Essbase内の特定のデータベース設定を変更するために使用します。たとえば、キャッシュやバッファのサイズを変更したり、ユーザーがパスワードの変更を求められるまでの経過日数などのシステム全体にわたる間隔を設定することができます。数値の設定を変更する場合、正の整数、正の実数および0を使用できます。小数点および科学記号を使用できます。

例:

      1000 
2.2 
645e-2
   

サイズの設定の場合は、数値の後に単位を付ける必要があります。数値と単位の間のスペースはオプションです。単位では大文字と小文字が区別されず、B/b (バイト)、KB/kb (キロバイト)、MB/mb (メガバイト)、GB/gb (ギガバイト)およびTB/tb (テラバイト)を含めることができます。単位を指定しない場合は、バイトと見なされます。

例:

      1000 b 
5.5GB 
645e-2 mb 
145 KB 
2,000e-3TB
   

図 151. データ・ファイルのキャッシュ・サイズを変更するMaxLステートメント

例:

      alter database Sample.Basic set data_file_cache_size 32768KB;
   

図 152. ユーザーにアプリケーション権限を付与するMaxLステートメント

例:

      grant designer on application Sample to Fiona;
   

図 153. 保管される計算を作成するMaxLステートメント

例:

         create calculation sample.basic.varcalc
'"Variance"=@VAR(Actual, Budget);
"Variance %"=@VARPER(Actual, Budget);'
;
      

例:

      essmsh
   

         essmsh -l Admin password
...
49 - User logged in: [Admin].
      

         essmsh -a Admin password Sample.Basic 
...
login $1 $2;

49 - User logged in: [admin].

alter database $3.$4 enable aggregate_missing;

72 - Database altered: ['sample'.'basic'].
      

この例では、$1、$2、$3および$4は定位置パラメータ変数であり、呼出し時にessmshの後に入力された引数が入力された順に表します。

ファイル名のみを指定すると、MaxLシェルは、そのファイルが現在のディレクトリ(オペレーティング・システムのコマンド・プロンプトが、essmshが呼び出された時点で格納されているディレクトリ)内にあると見なします。次の呼出しの例では、ファイルmaxlscript.mshはC:\の中に存在する必要があります。

      C:\> essmsh maxlscript.msh
   

MaxLスクリプトが現在のディレクトリ内に存在しない場合は、MaxLスクリプトへのパスを指定します。絶対パスまたは相対パスを使用できます。

例:

      $ essmsh ../Oracle/Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/test.msh
   

UNIXシェルでは、ファイル読取りエラーを防ぐために、パスを一重引用符で囲んでください。

Windowsコマンド・プロンプトでは、スクリプトへのパスにスペースが含まれている場合、ファイル読取りエラーを防ぐために、パス全体とファイル名を二重引用符で囲む必要があります。

         program.sh | essmsh -i
      

シェル・スクリプトprogram.shは、出力としてMaxLステートメントを生成する場合があります。シェル・スクリプト出力はessmsh -iにパイプされ、その出力が入力として使用されます。これにより、スクリプトの効果的な同時実行が可能になります。

      echo login admin password on localhost; display privilege user;|essmsh -i
   

      if [ $(echo "display application;" | 
essmsh -l admin password -i 2>&1 | 
awk '/Records returned/ {print $7}' ) != "[0]." ]
then
   print "This test requires that there be no applications."
   print "Quitting."
   exit 2
fi
   

DBAの場合、単一のスクリプトから多数の操作を実行するのではなく、自動化した個々のタスクをいくつかのMaxLスクリプトに保存する場合があります。あるMaxLスクリプトを別のMaxLスクリプトから参照する方法がわかっている場合、個々のピースをつなぎ合わせるのは簡単です。

             msh <scriptfile>;
      

出力をファイルにスプールして、MaxLセッションおよび関連メッセージのすべてまたはその一部のログ・ファイルを作成できます。

MaxLステートメントとその出力は、spoolコマンドを対話式セッションまたはスクリプトのいずれかで発行したときに、出力ファイルに記録されます。ただし、MaxLシェルのコマンドと出力は、対話式セッション中にスプールする場合のみ記録されます。MaxLシェルのコマンドと出力は、スクリプト・セッションから作成されたログ・ファイルでは無視されます。さらに、オペレーティング・システム・コマンドを含めた可能性のある出力は、対話式とスクリプトの両方のセッションのログ・ファイルで無視されます。

オペレーティング・システムのコマンドは、MaxLセッションから直接発行できます。オペレーティング・システムの出力は、MaxLシェル出力の一部になります。オペレーティング・システムは、コマンドの実行を終了したときに、制御をessmshに戻します。

         shell date;
      

         shell esscmd ‘../scripts/test.scr’;
      

MaxLシェルでは、コンピュータの名前、ユーザー名またはパスワードなどの、変更される可能性のあるデータや頻繁に参照されるデータのプレースホルダとして、変数を使用できます。変数は、MaxLスクリプトで、対話式セッション中に使用できます。MaxLスクリプトで変数を使用すると、ユーザー、データベースまたはホストごとにカスタマイズしたスクリプトを作成する必要がなくなります。変数は、環境変数(たとえば、Essbaseインストール・ディレクトリを参照先とする$ESSBASEPATH)、定位置パラメータ(たとえば、$1、$2、など)、およびローカルで定義したシェル変数である場合があります。変数は、参照するときは常に$(ドル符号)で開始します。

MaxLシェルでの変数の使用の詳細は、『Oracle Essbaseテクニカル・リファレンス』を参照してください。