Query Database (集約ストレージ)

機械翻訳について

Query Database (集約ストレージ)

非集約ストレージ・バージョンはここをクリックしてください

データベースの現在の状態に関する詳細情報を取得します。

最低限必要な権限: 読込み。

この文では、データベースを起動する必要があります。

構文

「図qrydb_as.gifの説明」

query databaseを使用して、次の方法でデータベース情報を問い合せることができます:

キーワード

get active alias_table

文を発行するユーザーのアクティブな別名表を表示します。

get attribute_info

指定した属性メンバーの属性メンバー、ディメンションおよび名前情報を取得します。

get attribute_spec

データベースの現在の属性指定を表示します。これらの指定には、属性メンバー名のフォーマット、属性計算ディメンション・メンバー名、ブールおよび日付メンバー名、数値範囲の指定が含まれます。

get cube_size_info

入力データ・サイズ、集計データ・サイズおよび追跡された問合せ数に関する情報を表示します(問合せトラッキングが有効な場合)。

この文は、次の表に示す出力を返します:

表3-19 Cube_Size_Info MaxL出力列の取得

列名	内容
input_data_size_cells	キューブ内の入力レベル・セルの数。
input_data_size_bytes	入力レベル・データで使用されるバイト数(概算)。
aggregate_data_size_cells	キューブ内のすべての集約ビューのセルの合計数。
aggregate_data_size_bytes	集計セルで使用されるバイト数(概算)。
kernel_queries_tracked	問合せトラッキングが最後に有効化されたか、問合せトラッキング情報がリセットされてから実行されたカーネル問合せの数。
total_query_cost	問合せトラッキング情報が最後にリセットされてから実行されたすべての問合せの合計コスト。
query_tracking_enabled	Values: TrueまたはFalse。集約ストレージ・データベースのユーザー取得統計が収集されているかどうかを示します。統計は、問合せベースのビューを最適化するために、次のMaxL文で使用できます: query database <dbs-name>リストexisting_views execute aggregate process execute aggregate selection 問合せトラッキングはデフォルトで無効になっています。

get dbstats dimension

ディメンションに関する情報を取得します。

index_typeフィールドの値は数値で、次のように変換されます:

0               Dense
1               Sparse
3               None (database is aggregate storage)

get dbstats data_block

データ・ブロックに関する情報を取得します。返される情報は、集約ストレージ・データベースとはほとんど関係がありません。

get member_info <MEMBER-NAME>

特定のメンバーに関する情報を取得します。

出力

unary_typeフィールドの値は数値で、次のように変換されます:

0               Add
1               Subtract
2               Multiply
3               Divide
4               Percent
5               NoRollUp

member_tag_typeのフィールド値は、次のように変換されます:

0               SkipNone
16384           SkipMissing
32768           SkipZero
49152           SkipBoth
1               BalFirst
2               BalLast
4               TwoPass
8               Average
64              Expense

バリエーションが可能です。フィールド値は、最初の4つのスキップ値のいずれかと、最後の5つの値のany/all/noneで構成されます。次に例を示します。

0               SkipNone
77              SkipNone, BalFirst, TwoPass, Average, Expense
16385           SkipMissing and BalFirst

最初の4つのスキップ値はベース値で、1、2、4、8および64の組合せで追加されます。

statusのフィールド値は16進数で、次のように変換されます:

0               Normal
1               Never Share
2               Label
4               Refer Share
8               Refer Share (with different name)
16              Implicit share
32              Virtual Member (stored)
64              Virtual Member (not stored)
2048            Attribute
32768           Referred

get opg_state of member_data

アウトラインのナビゲーション情報(親、子、兄弟など)、固定長の情報(行集計記号や子の数など)およびテキスト文字列(メンバー名や別名など)を表示します。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of member_name_namespace

メンバー名と内部メンバー識別子が一致する情報を表示します(データベースごとに1つのセクションであるため、すべてのディメンションの情報は同じです)。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of member_formula

ディメンションのすべての式を表示します。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of member_UDA

ディメンションのすべてのユーザー定義属性(UDA)を表示します。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of member_UDA_namespace

UDAを内部メンバー識別子と照合する情報を表示します。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of attribute_to_base_member_association

ディメンションの各基本メンバーに関連付けられている属性メンバーを識別する情報を表示します。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of member_comment

ディメンションのすべてのメンバー・コメントを表示します。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

get opg_state of member_alias_namespace

メンバーの別名と内部メンバー識別子を一致させる情報を表示します(別名表ごとに1つのセクションであるため、すべてのディメンションの情報は同じです)。

出力の説明は、「アウトライン・ページング・ディメンション統計」を参照してください。

list aggregate_storage runtime_info

集約ストレージ・データベースに関する実行時統計を表示します。この文によって返される出力の詳細は、「集約ストレージ・ランタイム統計」を参照してください。

list aggregate_storage group_id_info

一般会計キューブに関連するグループIDとそのタイムスタンプに関する情報を表示します。

ノート:

この文法は、一般会計キューブに適用され、一般会計以外の集約ストレージ・データベースには適用されません。通常の集約ストレージ・データベースの場合、この表は空になります。

このMaxL文法は、以前のリリースのEssbase MaxLクライアントでは無効です。

この文は、次の出力を返します:

表3-20 Aggregate_storage group_id_info MaxL出力列のリスト

列名	内容
group_id	配賦グループを作成した開始配賦コマンドに基づく配賦グループID。数値は符号なし64ビット整数です。
transaction_id	内部で使用される集約ストレージ・トランザクションID。数値は符号なし64ビット整数です。
state	グループIDの状態を説明する文字列。たとえば: BeginAllocation Done、Allocation In Progress、Allocation Done、EndAllocation In Progress。
time_last_used	グループIDが最後に使用された日時。この値は、グループIDが作成された時間、またはこのグループIDを使用して配賦またはカスタム計算が最後に実行された時間です。値は文字列です。
time_expired	グループIDがタイムアウト(期限切れ)になる日時。値は文字列です。
期限切れ	グループIDがタイムアウトしたかどうかを示します。グループIDの有効期限が切れている場合は、次回の割り当て開始コマンドの実行時にグループIDがロールバックされます。値はbooleanです。

この文によって返される出力の詳細は、「集約ストレージ・グループID情報の出力」を参照してください。

list aggregate_storage slice_info

データ・スライスおよびビューに関する情報を表示します。一部の情報は一般会計キューブにのみ適用されます(一般会計以外の集約ストレージ・データベースには適用されません)。

ノート:

小さい増分スライスの集約ビューは、プライマリ・スライス(スライス番号0)より少なくなる場合があります。セル数が100,000未満の増分スライスには、集約ビューは作成されません。ただし、増分スライスが100,000セルより大きく、プライマリ・スライスより大きい場合は、常にプライマリ・スライスと同じ集約ビューが使用されます。

このMaxL文法は、以前のリリースのEssbase MaxLクライアントでは無効です。

この文は、次の出力を返します:

表3-21 Aggregate_storage slice_info MaxL出力列のリスト

列名	内容
transaction_id	(一般会計キューブにのみ適用) このスライスおよびビューが属するトランザクションのID。 GLグループIDごとに1つの取引IDがあります。数値は符号なし64ビット整数です。対応するグループIDを検索するには、次のMaxLコマンドを使用します: `query database app.db list aggregate_storage group_id_info;` 一般会計以外の集約ストレージ・データベースの場合、この数値は常に0です。
slice_id	データ・スライスのID番号。数値は符号なし32ビット整数です。
slice_tag	(一般会計キューブにのみ適用) 割当てまたはカスタム計算が割当ての開始/終了の範囲内で行われた場合、この数値は、このデータ・スライスを作成した割当てのrule_idです。数値は符号なし64ビット整数です。一般会計以外の集約ストレージ・データベースの場合、この数値は常に0です。
view_id	0は入力ビューを示し、それ以外の場合、ビューは集約ビューです。数値は符号なし64ビット整数です。特定の集約ビューのレベルをリストするには、次のMaxLコマンドを使用します: `query database app.db list existing_views;`
size_cells	スライスの指定されたビューのセル数。数値は符号なし64ビット整数です。
size_kb	スライスの指定されたビューのサイズ(KB )。数値は符号なし64ビット整数です。

この文によって返される出力の詳細は、「集約ストレージ・スライス情報の出力」を参照してください。

list aggregate_storage uncommitted_transaction_info

一般会計キューブに関連するコミットされていないトランザクションに関する情報を表示します。

ノート:

このMaxL文法は、以前のリリースのEssbase MaxLクライアントでは無効です。

この文は、次の出力を返します:

表3-22集約ストレージのコミットされていないトランザクション情報のMaxL出力列

列名	説明
unc_transactions	コミットされていない既存のユーザー・トランザクションの数。
unc_data_slices	コミットされていないトランザクションで使用されるデータ・スライスの数。
unc_input_data_size_cells	コミットされていないトランザクションで使用される入力セルの数。
unc_aggregate_views	コミットされていないトランザクションで使用される集約ビューの数。
unc_aggregate_data_size_cells	コミットされていないトランザクションで使用される集計セルの数。
unc_input_data_size_kb	コミットされていない入力レベル・データによって使用される合計ディスク領域。
unc_aggregate_data_size_kb	コミットされていない集計セルによって占有されている合計ディスク領域。

この文によって返される出力の詳細は、「集約ストレージのコミットされていないトランザクション情報の出力」を参照してください。

list aggregate_storage compression_info

異なるディメンションが圧縮ディメンションとして仮定的に使用されている場合に、集約ストレージ・データベースの推定圧縮を表示します。これらの見積りは、圧縮ディメンションとして使用する最適なディメンションの選択に役立ちます。

集約ストレージ・データベースでは、圧縮ディメンションによってデータベース圧縮が可能になります。圧縮ディメンションに適しているのは、データ圧縮を最適化し、取得パフォーマンスを維持するディメンションです。次の表は、アウトラインを大幅に変更せずに圧縮ディメンションとして選択できない場合でも、すべての非属性ディメンションのデータを示しています。圧縮ディメンションの要件の詳細は、「集約ストレージ・データベースの圧縮ディメンションの理解」を参照してください。

この文は、次の出力を返します:

表3-23集約ストレージ圧縮情報MaxL出力列

列名	内容
dimension_name	データベース内の各ディメンション名。圧縮ディメンションとみなされます。
is_compression	ディメンションが集約ストレージ圧縮ディメンションかどうかを示します。 (集約ストレージ・データベースには、圧縮ディメンションを1つのみ含めることができます。)
stored_level0_members	ディメンション内のリーフ・レベル・メンバーの数。ディメンション内の多数のストアドlevel-0メンバーは、圧縮ディメンションと同様に実行されない可能性があることを示します。
average_bundle_fill	圧縮ディメンション・バンドル当たりの推定平均値数。平均バンドルの入力がより高い圧縮ディメンションを選択するということは、データベースがより適切に圧縮されることを意味します。
average_value_length	値の格納に必要な推定平均バイト数。平均値の長さがより小さいディメンションでは、データベースの圧縮効率が高くなります。
level0_mb	圧縮されたデータベースの推定サイズ(キロバイト)。予想されるlevel-0サイズが小さい場合は、このディメンションを選択すると圧縮率が向上することを示します。圧縮ディメンション(None)がないシナリオを除き、すべての見積りはすべてのページが圧縮されていることを前提としています。圧縮されたページには、圧縮されていないページには追加のオーバーヘッドが必要なため、一部のディメンションの見積りlevel-0データベース・サイズは、Noneの値より大きくなる場合があります。

list alias_table

データベースに定義されている別名表のリストを取得します。

list alias_names in alias_table

別名表に定義されている別名をリストします。別名表には、メンバー名の別名のセットが含まれ、データベース・アウトラインに格納されます。この文法を使用して、指定した表に定義されている別名のリストを表示します。

list existing_views

すべての集約ビューに関する情報を表示します。集約ビューは、各ディメンション内のメンバーのレベルに基づく集約セルのコレクションです。

オプションの「query_dataに基づく」句を使用すると、戻される問合せコスト情報は、実際のユーザー問合せの収集コストに基づきます。この句を使用しない場合、デフォルトの想定では、可能性のあるすべての問合せが同じ確率で実行されます。

「query_dataに基づく」句を使用するには、まず問合せトラッキングを有効にする必要があります。問合せトラッキングを有効にするには、alter database <dbs-name>を使用して問合せトラッキングを有効にします。

list ... file information

正確な索引およびデータ・ファイル情報を取得します。索引およびデータ・ファイルの名前、カウント、サイズおよび合計を提供し、各ファイルがEssbaseによって現在開かれているかどうかを示します。ファイル・サイズ情報は正確です。 NTFSボリューム上に存在するインデックス・ファイルとデータファイルに対してWindowsオペレーティング・システムが提供するファイル・サイズ情報は、正確でない場合があります。

list load_buffers

集約ストレージ・データベースに存在するデータ・ロード・バッファのリストおよび説明を表示します。「集約ストレージ・データ・ロード・バッファの使用」を参照してください。

list aso_level_info

アウトラインの実際のディメンションごとに集計レベル数を表示します。集約レベル数は、集約ストレージ・データベースに存在する実際のディメンション(関連する属性ディメンションを含む)の集約レベルの合計数です。

dump|force_dump existing views...

このデータベースの既存のビューを集計スクリプトに保存します。このアクションには、最低限の実行権限(「実行」)が必要です。

指定したスクリプト名がすでに存在する場合は、force_dumpキーワードを使用して上書きできます。存在しない場合は、ファイル名がすでに存在するとエラーが返されます。

「query_dataに基づく」句を使用する場合、保存されるビューの選択は、以前に収集された問合せトラッキング・データに基づきます。このオプションを使用するには、問合せトラッキングを有効にしておく必要があります。問合せトラッキングの詳細は、execute aggregate selectionのbased on query_dataの説明を参照してください。

例

query database ASOsamp.Sample list load_buffers;

ASOsamp.Sampleに存在するデータ・ロード・バッファのリストと説明を表示します。