| Oracle OLAP DMLリファレンス 11g リリース1（11.1） E05732-02 |
|
 戻る |
 次へ |
STATDEPTHファンクションは、指定したディメンションについてOracle OLAPが保存しているステータス・リストの数を返します。ディメンションの現行のステータス・リストがスタックの最上部に置かれます。つまり、現行のステータス・リストが深さ1となります。
戻り値
INTEGER
構文
STATDEPTH (dimension)
引数
情報の取得対象となるディメンションの名前。
注意
ステータス・リスト・スタックとは
ディメンションのステータス・リスト・スタックは、PUSH文およびPOP文を実行する際に、Oracle OLAPがステータスを管理するために使用するディメンション・ステータスのスタックです。このリストの深さは、Oracle OLAPが実行した文の種類によって変化します。
アナリティック・ワークスペースの最初のアタッチ時は、各ディメンションの現行のステータスはALLとなり、各ディメンションのステータス・リスト・スタックの深さは1（つまり、スタックにあるステータス・リストは1つのみ）となります。
ディメンションのステータス・リスト・スタックの深さは、現行のステータスが何度変更されても（つまり、ディメンションに対してLIMITコマンドが何度実行されても）、1（現行のステータス・リスト）のままとなります。ただし、次の例外があります。
Oracle OLAPでディメンションに対してPUSH文が実行された場合。PUSH文の実行以降は、当該ディメンションに対してLIMITコマンドが実行されるたびに、そのディメンションのステータス・リスト・スタックにステータス・リストが追加されます。当該ディメンションに対してPOP文が実行されると、そのディメンションのステータス・リスト・スタックはクリアされます。そのディメンションのステータス・リスト・スタックは再び1に戻ります。
Oracle OLAPで、ディメンションのステータスを一時的に変更する文（CHGDIMSやTEMPSTATなど）が実行された場合。この場合、その文が有効な間のみステータス・リスト・スタックにステータス・リストが追加されます。追加されたステータス・リストは、文が無効になるとただちに削除されます。一時的なステータスが有効になっている間のみ、ステータス・リスト・スタックからこのステータス・リストにアクセスできます。
