STATDEPTH

STATDEPTH ファンクションは、指定したディメンションについてOracle OLAPが保存しているステータス・リストの数を返します。ディメンションの現行のステータス・リストがスタックの最上部に置かれます(現行のステータス・リストが深さ1となります)。

戻り値

INTEGER

構文

STATDEPTH (dimension)

パラメータ

dimension: 情報の取得対象となるディメンションの名前。

使用上の注意

ステータス・リスト・スタックとは

ディメンションのステータス・リスト・スタックは、PUSH文およびPOP文を実行する際に、Oracle OLAPがステータスを管理するために使用するディメンション・ステータスのスタックです。このリストの深さは、Oracle OLAPが実行した文の種類によって変化します。

アナリティック・ワークスペースの最初のアタッチ時は、各ディメンションの現行のステータスはALLとなり、各ディメンションのステータス・リスト・スタックの深さは1(つまり、スタックにあるステータス・リストは1つのみ)となります。
ディメンションのステータス・リスト・スタックの深さは、現行のステータスが何度変更されても(つまり、ディメンションに対してLIMITコマンドが何度実行されても)、1(現行のステータス・リスト)のままとなります。ただし、次の例外があります。
- Oracle OLAPでディメンションに対してPUSH文が実行された場合。PUSH文の実行以降は、当該ディメンションに対してLIMITコマンドが実行されるたびに、そのディメンションのステータス・リスト・スタックにステータス・リストが追加されます。当該ディメンションに対してPOP文が実行されると、そのディメンションのステータス・リスト・スタックはクリアされます。そのディメンションのステータス・リスト・スタックは再び1に戻ります。
- Oracle OLAPで、ディメンションのステータスを一時的に変更する文(CHGDIMSやTEMPSTATなど)が実行された場合。この場合、その文が有効な間のみステータス・リスト・スタックにステータス・リストが追加され、その後ただちに削除されます。一時的なステータスが有効になっている間のみ、ステータス・リスト・スタックからこのステータス・リストにアクセスできます。