一般統計の取得
/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/statistics
指定されたデータベースの一般統計を返します。expandパラメータを使用するとその他の統計を取得できます。
リクエスト
- applicationName(required): string
アプリケーション名。
- databaseName(required): string
データベース名。
- expand: string
一般統計のみを表示するには(これがデフォルト)、
noneを使用します。使用可能なその他のオプションとしては、storage、runtimeおよびallがあります。デフォルト値:none指定可能な値:[ "none", "storage", "runtime", "all" ]
レスポンス
- application/json
- application/xml
200 レスポンス
OK
一般データベース統計が正常に返されました。拡張統計を取得するためのリンクが含まれています。
object- cacheHitRatio: number(double)
ハード・ディスクからの応答に対して、集約ストレージ・キャッシュから応答があったリクエスト数の比率。並列データ・ロードまたは並列計算操作を実行しているときは正確でなくなる可能性があります。
- currentCacheSize: number(double)
集約ストレージ・キャッシュの現在のサイズ。currentCacheSizeLimitも参照してください。
- currentCacheSizeLimit: number(double)
集約ストレージ・キャッシュが成長して到達する可能性のある最大サイズ(KB単位)。
- diskSpaceAllocatedForData: number(double)
集約ストレージ・キューブの場合は、デフォルト表領域内のすべてのディスク・ファイルによって使用されるスペースの合計。
- diskSpaceUsedByData: number(double)
集約ストレージ・キューブの場合は、デフォルト表領域のディスク・ファイル内で実際に使用中のスペースの合計(ファイル内の一部のスペースは空いている可能性がある)。
- hitRatioOnDataCache: number(double)
- hitRatioOnDataFileCache: number(double)
- hitRatioOnIndexCache: number(double)
- numberOfDataBlockReads: number(double)
- numberOfDataBlockWrites: number(double)
- numberOfIndexPageReads: number(double)
- numberOfIndexPageWrites: number(double)
- pageReadsSinceLastStartup: number(double)
集約ストレージ・キューブの場合は、アプリケーションが最後に起動された後にディスクから読み取られたデータ・ページの数。
- pageSize: number(double)
集約ストレージ・キューブの場合は、データ・ページのサイズ(KB単位)。
- pageWritesSinceLastStartup: number(double)
集約ストレージ・キューブの場合は、アプリケーションが最後に起動された後にディスクに書き込まれたデータ・ページの数。
- temporaryDiskSpaceAllocated: number(double)
集約ストレージ・キューブの場合は、一時表領域内のすべてのディスク・ファイルによって使用されるスペースの合計。
- temporaryDiskSpaceUsed: number(double)
集約ストレージ・キューブの場合は、一時表領域のディスク・ファイル内で実際に使用中のスペースの合計(ファイル内の一部のスペースは空いている可能性がある)。
object- aggregateDataSize: integer(int32)
集約ストレージ・キューブの場合は、集約セルによって占有されているディスク・スペースの合計。
- averageClusteringRatio: number(double)
ページ・ファイルの断片化の程度。1に近い値を指定すると、断片化の度合いが低くなります。0に近い値を指定すると、断片化の度合いが高くなり、計算および問合せのパフォーマンスに影響する可能性があります。
- blockDensity: number(double)
平均ブロック密度(現在ロードされているすべてのブロックを使用して計算される)
- blockSize: integer(int32)
- compressionRatio: number(double)
平均データ・ブロック圧縮率
- costOfQueryingIncrementalData: number(double)
集約ストレージ・キューブの場合は、増分データ・スライスの処理に費やした問合せ時間の割合の平均。これは、問合せパフォーマンスの向上のために複数のスライスをマージする必要があるかどうかの判断に役立ちます。
- dimensions: array dimensions
- existingLevelZeroBlocks: number(double)
キューブ内の非欠落リーフ(最下位レベル)ブロックの数。
- existingUpperLevelBlocks: number(double)
キューブ内の非欠落かつ非リーフ(上位レベル)のブロックの数。
- indexFileSize: integer(int64)
- inputLevelDataSize: integer(int32)
集約ストレージ・キューブの場合は、入力レベルのデータによって使用されているディスク・スペースの合計。
- maxKeyLengthBits: integer(int32)
集約ストレージ・キューブの場合は、各ディメンションによって使用されているすべてのビットの合計。たとえば、ディメンションに使用されているキーのビットが20で、最初の4ビットが年に使用されます。
- maxKeyLengthBytes: integer(int32)
集約ストレージ・キューブの場合は、セル当たりの、キーで使用されるバイトの数
- numberOfAggregateCells: integer(int32)
集約ストレージ・キューブの場合は、集約ビューに格納されるセルの数
- numberOfAggregateViews: integer(int32)
集約ストレージ・キューブの場合は、集約ビューの数(増分スライス上に自動的に構築されたものを含む)
- numberOfExistingBlocks: number(double)
既存のデータ・ブロックの合計数(最大数ではない)
- numberOfIncrementalAggregateCells: integer(int32)
集約ストレージ・キューブの場合は、増分スライスの集約ビューに格納されるセルの数
- numberOfIncrementalDataSlices: integer(int32)
集約ストレージ・キューブの場合は、増分データ・ロードからもたらされるデータ・スライスの数
- numberOfIncrementalInputCells: integer(int32)
集約ストレージ・キューブの場合は、増分データ・スライス内のレベル0セルの数
- numberOfInputLevelCells: integer(int32)
集約ストレージ・キューブの場合は、データベース内の既存のレベル0セルの数(増分スライスを含む)
- pageFileSize: integer(int64)
- percentageOfMaximumBlocksExisting: number(double)
- potentialNumberOfBlocks: number(double)
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/Sample_Dynamic/databases/Basic/statistics?expand=all" -H "accept: application/json" -u %User%:%Password%レスポンス本体の例
{
"general": {
"databaseStartTime": 1586308012000,
"databaseElapsedTime": "0:0:3:34",
"numberOfConnections": 1,
"numberOfDimensions": 10,
"loadStatus": "Loaded"
},
"storage": {
"maxKeyLengthBits": 0,
"maxKeyLengthBytes": 0,
"numberOfInputLevelCells": 0,
"numberOfIncrementalDataSlices": 0,
"numberOfIncrementalInputCells": 0,
"numberOfAggregateViews": 0,
"numberOfAggregateCells": 0,
"numberOfIncrementalAggregateCells": 0,
"costOfQueryingIncrementalData": 0,
"inputLevelDataSize": 0,
"aggregateDataSize": 0,
"numberOfExistingBlocks": 354,
"blockSize": 672,
"potentialNumberOfBlocks": 1900,
"existingLevelZeroBlocks": 354,
"existingUpperLevelBlocks": 0,
"blockDensity": 83.61904761904762,
"percentageOfMaximumBlocksExisting": 18.63157894736842,
"compressionRatio": 0.9943010752688172,
"averageClusteringRatio": 0.33334593787222777,
"pageFileSize": 294969,
"indexFileSize": 8216576
},
"runtime": {
"cacheHitRatio": 0,
"currentCacheSize": 0,
"currentCacheSizeLimit": 0,
"pageReadsSinceLastStartup": 0,
"pageWritesSinceLastStartup": 0,
"pageSize": 0,
"diskSpaceAllocatedForData": 0,
"diskSpaceUsedByData": 0,
"temporaryDiskSpaceAllocated": 0,
"temporaryDiskSpaceUsed": 0,
"hitRatioOnIndexCache": 0,
"hitRatioOnDataCache": 0,
"numberOfIndexPageReads": 0,
"numberOfIndexPageWrites": 0,
"numberOfDataBlockReads": 0,
"numberOfDataBlockWrites": 0,
"hitRatioOnDataFileCache": 0
}
}