19 MaxLクライアントを使用したEssbaseの管理

MaxLは、Essbase用のマルチ・ディメンショナル・データベース・アクセス言語です。

MaxLのスクリプトや文を実行するには、MaxLクライアントを使用してHTTPまたはHTTPS経由で文を発行する必要があります。

MaxLクライアント設定の前提条件

MaxLクライアントをダウンロードして使用する前に、これらのタスクを完了します。 MaxLのスクリプトや文を実行するには、パワー・ユーザーまたは管理者である必要があります。

MaxLクライアントの使用を準備するには:

EssbaseインスタンスのURLをサービス管理者から取得します。その基本形式は次のとおりです。
```
https://IP-address:port/essbase
```
WebブラウザまたはcURLを使用して、クライアント・ホストから検出URLに到達できることをテストします。検出URLは、サービス管理者から提供されたURLの最後に/agentを追加したものです。次に、cURLの例を示します:
```
curl https://192.0.2.1:443/essbase/agent --tlsv1.2
```
SSL証明書を設定します(ユーザーの組織に該当する場合)。
- 次のデプロイメント・タイプのいずれかを使用している場合は、信頼できるCAの署名済SSL証明書が含まれています。
  - Oracle Analytics Cloud
  - Oracle Analytics Cloud with Identity Cloud Service (IDCS) and Load Balancing
  - Cloud at Customer with Load Balancing
- Oracle Analytics CloudまたはCloud at Customer with LDAP (ロード・バランシングなし)を使用している場合は、自己署名付き証明書を使用します。
- Oracle Cloud InfrastructureにデプロイされたEssbaseを使用している場合は、「SSL証明書の設定」を参照してください。
証明書が信頼されているかどうかを確認するには、検出URLをWebブラウザに貼り付けます。 httpsが緑色になるか、「安全」というラベルが表示される場合は信頼されています。 httpsが赤色になるか、「安全でない」というラベルが表示される場合は信頼されていません。
証明書が信頼されていない(自己署名)の場合は、証明書をクライアント・トラスト・ストア(cacert.pem)にインポートします。
クライアントは提供されたca-bundle証明書ストアを使用してサーバーのデジタル証明書を確認します。 ca-bundleの場所は、環境変数を次のように指定することによって設定します。
API_CAINFO=CA証明書ファイルのパス;
パスを指定しない場合、Essbaseランタイム・クライアントはデフォルトのOpenSSLインストール場所からca-bundleの取得を試みます(LinuxおよびMacintoshに適用)。
Oracle Data VisualizationクライアントおよびMaxLクライアントにはca-bundle (cacert.pem)が含まれています。

ca-bundle (cacert.pem)が必要な場合はダウンロードすることもできます。次のサンプル・ソースがあります : https://curl.haxx.se/docs/caextract.html。

MaxLクライアントのダウンロードおよび使用

Essbase MaxLクライアントを使用すると、HTTPまたはHTTPS経由でMaxLを使用できるようになります。 MaxLは、キューブとアーティファクトを管理する言語ベースの管理インタフェースです。コンソールで指定された最新のクライアント・バージョンを使用していることを確認してください。以前にダウンロードした古いバージョンは適切に動作しない可能性があります。

MaxL文を実行するには、パワー・ユーザーまたは管理者である必要があります。 MaxL Clientをダウンロードする前に、「MaxLクライアントの設定の前提条件」を参照してください。

Oracle Identity Cloud ServiceのフェデレーテッドSSOユーザーの場合、MaxLまたはCLIを使用したログインはサポートされていません。フェデレーテッドSSOログインにはブラウザ・ウィンドウが必要です。ネイティブIdentity Cloud Serviceユーザーを作成し、かわりにそれを使用してMaxLまたはCLIを使用してログインします。

「Essbase webインタフェース」で「コンソール」をクリックします。
コンソールで、MaxLクライアントに移動します。
使用しているプラットフォームに適したMaxL Clientの横にある「ダウンロード」をクリックします。
圧縮ファイルEssbaseMaxlをローカル・ドライブに保存します。
圧縮ファイルの内容をフォルダに抽出します。
プロキシを使用している場合は、MaxL実行スクリプトのstartMAXL.batまたはstartMAXL.shに正しいプロキシを設定する必要があります。次の例はUNIXのstartMAXL.shの編集に適用可能で、指定されたプロキシ(proxy.example.com)を使用すること、ただし、例外リスト(127.0.0.1、localhostおよびsomething.example.com)にリストされている特定の宛先のプロキシは使用しないことがMaxLに指定されています。
```
export https_proxy=http://proxy.example.com
export no_proxy=127.0.0.1,localhost,something.example.com
```
Windowsの場合、startMAXL.batを同様に編集できますが、構文は異なります。
```
set proxy proxy-server="https://proxy.example.com" bypass-list="127.0.0.1;localhost;*.example.com"
```
Oracle Cloud InfrastructureにデプロイされたEssbaseを使用しており、自己署名証明書を使用している場合は、MaxL実行スクリプトでピア検証を無効にする必要があります。注意: これは、信頼できるCA証明書を入手できるまでの一時的な解決方法です。次に、bash (startMAXL.shの場合)の使用例を示します:
```
export API_DISABLE_PEER_VERIFICATION=1
```
startMAXLバッチまたはシェル・スクリプトを実行します。コマンド・プロンプトが開き、環境設定が完了し、MaxLクライアントが起動します。
MaxL login文に資格証明およびEssbase URLを指定してログインします。

次の例では、admin1@example.comにログインするユーザーは、Oracle Cloud InfrastructureでのEssbaseスタック・デプロイメント時に最初のEssbase管理者として設定されたIdentity Cloud Service管理者です。この例ではパスワードが入力されていないため、管理者は次にパスワードを入力するように求められます。 URLは、スタックdeploymentから生成されたジョブ出力のessbase_urlです。
```
login admin1@example.com on "https://192.0.2.1/essbase";
```
Essbaseと連携するようにプロビジョニングされたIdentity Cloud Serviceユーザーは、パワー・ユーザーまたは管理者としてプロビジョニングされているかぎり、MaxLにログインできます。
対話型のMaxL文を実行します。

例:
```
display database all;
```

MaxLの詳細は、「MaxL文リファレンス」を参照してください。