圧縮設定の取得
/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/settings/compression
指定されたデータベースの圧縮設定を返します。
リクエスト
- applicationName(required): string
アプリケーション名。
- databaseName(required): string
データベース名。
レスポンス
- application/json
- application/xml
200 レスポンス
OK
圧縮の設定を正常に取得しました。
object様々なディメンションを圧縮ディメンションとして仮定で使用した、集約ストレージ・キューブの圧縮統計の推定値。これらの推定値は、最良の圧縮ディメンションを選択するために役立ちます。
- averageBundleFill: number(double)
集約ストレージ・キューブのみに適用されます。圧縮ディメンション・バンドル当たりの値の平均数の推定値。バンドル当たりの値の平均数が大きい圧縮ディメンションを選ぶほど、キューブの圧縮率が高くなります。
- averageValueLength: number(double)
値の保管に必要なバイト数の平均の推定値。値保管に必要なバイト数の平均が小さいディメンションほど、キューブの圧縮率が高くなります。
- dimensionName: string
圧縮統計を推定するために、集約ストレージの圧縮ディメンションであると仮定するディメンションの名前。
- isCompression: boolean
集約ストレージの圧縮ディメンションであるかどうか。デフォルトでは、圧縮ディメンションは勘定科目ディメンションです。1つの集約ストレージ・キューブ内に存在できる圧縮ディメンションは1つのみです。
- level0MB: number(double)
圧縮済キューブのサイズの推定値(MB単位)。レベル0サイズの推定値が小さいディメンションを選ぶほど、圧縮率が高くなります。圧縮ディメンションがない(「なし」)シナリオを除き、すべての推定値は、すべてのページが圧縮されることが前提となっています。圧縮されていないページと異なり、圧縮されているページにはさらにオーバーヘッドが必要になるため、一部のディメンションのレベル0データベース・サイズの推定値は、「なし」の値より大きくなる可能性があります。
- storedLevel0Members: number(double)
保管されているレベル0メンバーの数。保管されているレベル0メンバーの数が多い集約ストレージ圧縮ディメンションは、適切に動作しません。動的に計算されるディメンションと同様で、一般的に、圧縮ディメンションからの上位レベルでの取得のほうが遅くなります。
400 レスポンス
不正なリクエスト
圧縮設定の取得に失敗しました。アプリケーション名またはデータベース名が正しくない可能性があります。
500 レスポンス
サーバーの内部エラーです。
例
次の例では、キューブの圧縮設定を取得する方法を示します。
この例では、cURLを使用して、Windowsシェル・スクリプトからREST APIにアクセスします。呼出し元ユーザーのIDおよびパスワードは変数であり、properties.bat内でその変数値が設定されています。
cURLコマンドを含むスクリプト
call properties.bat
curl -X GET "https://myserver.example.com:9001/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
}
]
}