圧縮設定の取得
/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/settings/compression
指定されたデータベースの圧縮設定を返します。
要求
- applicationName: string
アプリケーション名
- databaseName: string
データベース名
レスポンス
- application/json
- application/xml
200 レスポンス
OK
圧縮設定が正常に取得されました。
object
異なるディメンションが圧縮ディメンションとして仮定的に使用される、集約ストレージ・キューブの推定圧縮統計。 これらの見積りは、最適な圧縮ディメンションの選択に役立ちます。
- averageBundleFill(optional): number(double)
集約ストレージ・キューブにのみ適用されます。 圧縮ディメンション・バンドル当たりの推定平均値数。 平均バンドル充填率が高い圧縮ディメンションを選択すると、キューブの圧縮率が向上します。
- averageValueLength(optional): number(double)
値の格納に必要な推定平均バイト数。 平均値の長さが短いディメンションほど、キューブの圧縮率が向上します。
- dimensionName(optional): string
圧縮統計を見積もるために、ディメンション名は集約ストレージ圧縮ディメンションと仮定的にみなされます。
- isCompression(optional): boolean
これが集約ストレージ圧縮ディメンションかどうか。 デフォルトでは、圧縮ディメンションは勘定科目ディメンションです。 集約ストレージ・キューブには、圧縮ディメンションを1つのみ含めることができます。
- level0MB(optional): number(double)
圧縮されたキューブの推定サイズ(メガバイト)。 予想されるlevel-0サイズが小さい場合は、このディメンションを選択すると圧縮率が向上することを示します。 圧縮ディメンションがないシナリオ(なし)を除き、すべての見積りではすべてのページが圧縮されているとみなされます。 圧縮されたページには、圧縮されていないページには追加のオーバーヘッドが必要なため、一部のディメンションの見積りlevel-0データベース・サイズはなしの値より大きくなる場合があります。
- storedLevel0Members(optional): number(double)
保管されているレベル0のメンバーの数。 多数のストアド・レベル0メンバーを含む集約ストレージ圧縮ディメンションは、最適に実行されません。 動的に計算されるディメンションと同様に、圧縮ディメンションからの上位レベルの取得は一般的に遅くなります。
400 レスポンス
不正なリクエスト
圧縮設定の取得に失敗しました。 アプリケーション名またはデータベース名が正しくない可能性があります。
500 レスポンス
内部サーバー・エラー。
例
次の例は、cURLを使用してWindowsシェル・スクリプトからREST APIにアクセスし、キューブの圧縮設定を取得する方法を示しています。
コール元のユーザーIDおよびパスワードは、properties.bat
で値が設定される変数です。
cURLコマンドを含むスクリプト
call properties.bat
curl -X GET "https://192.0.2.1:443/essbase/rest/v1/applications/ASOSamp/databases/Basic/settings/compression"
-H "accept: application/json"
-u %User%:%Password
レスポンス本体の例
{
"compression": [
{
"dimensionName": "<No Compression Dimension>",
"isCompression": false,
"storedLevel0Members": 0,
"averageBundleFill": 1,
"averageValueLength": 8,
"level0MB": 19.071334838867188
},
{
"dimensionName": "Measures",
"isCompression": true,
"storedLevel0Members": 5,
"averageBundleFill": 4.011231448054553,
"averageValueLength": 2.418,
"level0MB": 6.448018309020995
},
{
"dimensionName": "Years",
"isCompression": false,
"storedLevel0Members": 2,
"averageBundleFill": 1.0060362173038229,
"averageValueLength": 2.22,
"level0MB": 16.863827831268313
},
{
"dimensionName": "Time",
"isCompression": false,
"storedLevel0Members": 12,
"averageBundleFill": 1.0836081053886284,
"averageValueLength": 2.23,
"level0MB": 15.857951142338342
},
{
"dimensionName": "Transaction Type",
"isCompression": false,
"storedLevel0Members": 3,
"averageBundleFill": 1.002004008016032,
"averageValueLength": 2.22,
"level0MB": 16.921041835784912
},
{
"dimensionName": "Payment Type",
"isCompression": false,
"storedLevel0Members": 4,
"averageBundleFill": 1.0111223458038423,
"averageValueLength": 2.22,
"level0MB": 16.79231032562256
},
{
"dimensionName": "Promotions",
"isCompression": false,
"storedLevel0Members": 5,
"averageBundleFill": 1.0015022533800702,
"averageValueLength": 2.22,
"level0MB": 16.928193586349487
},
{
"dimensionName": "Age",
"isCompression": false,
"storedLevel0Members": 9,
"averageBundleFill": 1.0167768174885612,
"averageValueLength": 2.22,
"level0MB": 16.713641069412233
},
{
"dimensionName": "Income Level",
"isCompression": false,
"storedLevel0Members": 6,
"averageBundleFill": 1.010611419909045,
"averageValueLength": 2.22,
"level0MB": 16.799462076187133
},
{
"dimensionName": "Products",
"isCompression": false,
"storedLevel0Members": 25,
"averageBundleFill": 1.0429341213280028,
"averageValueLength": 2.232,
"level0MB": 16.375124876022337
},
{
"dimensionName": "Stores",
"isCompression": false,
"storedLevel0Members": 239,
"averageBundleFill": 1,
"averageValueLength": 2.22,
"level0MB": 16.949648838043213
},
{
"dimensionName": "Geography",
"isCompression": false,
"storedLevel0Members": 9398,
"averageBundleFill": 1.0310164103445314,
"averageValueLength": 2.23,
"level0MB": 16.531271430015565
}
]
}