46 DBMS_CUBE_LOG
DBMS_CUBE_LOG
には、キューブおよびキューブ・ディメンションのログを作成および管理するためのサブプログラムが含まれています。
参照:
ビジネス・インテリジェンス・アプリケーションおよび分析アプリケーションをサポートするOLAPオプションの使用の詳細は、『Oracle OLAPユーザーズ・ガイド』のOracle Database内のOLAPテクノロジに関する項を参照してください。
この章のトピックは、次のとおりです:
46.1 DBMS_CUBE_LOGの使用方法
DBMS_CUBE_LOG
は、長時間実行されているプロセスの進行状況を追跡し、その結果を使用してパフォーマンスの特徴をプロファイルできるようにする、複数のログを管理します。
これらのログから、リレーショナル・ソース表で不適切に構造化された階層、ロードに失敗するレコードまたは完了に時間がかかりすぎるデータ更新など、キューブの作成中やメンテナンス中に発生する可能性がある問題を診断して、問題の解決に役立つ情報が得られます。また、キューブに問い合せる際のパフォーマンスの問題の診断にも役立ちます。
Analytic Workspace Managerでは、デフォルトの名前とタイプを使用して、ログが自動的に作成されます。また、Analytic Workspace Managerを閉じるとログが無効になります。同じログをAnalytic Workspace Managerの外部で使用するには、まずログを有効にする必要があります。または、Analytic Workspace Managerの外部で使用するための別のログを作成し、管理することもできます。
この項では、次の項目について説明します。
46.1.1 DBMS_CUBE_LOG - ロギング・タイプ
複数のログが使用でき、それぞれが特定のタイプのメッセージの格納に特化しています。すべてのログを使用することもでき、特に重要と思われるログのみを使用することもできます。
ログとコンテンツについてはこの項の後半で説明します。
DBMS_CUBE_LOG
は、各ログ・タイプに2進整数を戻すファンクションを提供します。他のDBMS_CUBE_LOG
プロシージャおよびファンクションの引数値の整数のかわりにこれらのファンクションを使用すると、より読みやすいコードを作成できます。次の説明を参照してください。
46.1.2 DBMS_CUBE_LOG - ロギング・ターゲット
TABLE_CREATE
プロシージャは、ログを格納するデータベース表を作成します。ENABLE
プロシージャを使用すると、宛先またはロギング・レベルでの変更で追加のターゲットを作成できます。たとえば、キューブ操作ログのターゲットを表とディスク・ファイルの両方に指定できます。
使用可能なターゲットは次のとおりです。
-
ディスク・ファイル
-
LOB
-
データベース表
-
トレース・ファイル
複数のターゲットを作成する方法の詳細は、「ENABLEプロシージャ」を参照してください。
DBMS_CUBE_LOG
は、各ターゲット・タイプに2進整数を戻すファンクションを提供します。他のDBMS_CUBE_LOG
プロシージャおよびファンクションの引数値の整数のかわりにこれらのファンクションを使用すると、より読みやすいコードを作成できます。次の説明を参照してください。
46.1.3 DBMS_CUBE_LOG - 冗長性レベル
ログに記録する情報量を決定できます。ジョブを翌日まで実行しておく場合は、新しい作成の成功を監視するときよりも詳細の数を減らすことができます。冗長性レベルは次から選択できます。各レベルは前のレベルより冗長性が高くなります。
-
LOWEST
: キューブ・ディメンションおよびキューブの作成に使用された各コマンドのステータス、スレーブ・プロセスの使用およびサマリー・レコードをログに記録します。これは、基本のロギング・レベルです。 -
LOW
: SQLインポート、集計および更新の記録の開始および終了などOLAPエンジンからのメッセージをログに記録します。 -
MEDIUM
: Analytic Workspace Managerによって使用されるレベルでメッセージをログに記録します。 -
HIGH
: コンポジットの長さ、パーティション化の詳細、オブジェクト・サイズおよび集計ワークリストなどのチューニング情報を提供するメッセージをログに記録します。このレベルは、Oracleフィールドサービスによる使用を目的としています。 -
HIGHEST
: デバッグ・メッセージおよび通常トレース・ファイルに送信されるその他の情報をログに記録します。このレベルは、Oracleサポート・サービスによる使用を目的としています。
DBMS_CUBE_LOG
は、各冗長性レベルに2進整数を戻すファンクションを提供します。他のDBMS_CUBE_LOG
プロシージャおよびファンクションの引数値の整数のかわりにこれらのファンクションを使用すると、より読みやすいコードを作成できます。次の説明を参照してください。
46.1.5 DBMS_CUBE_LOG - キューブ・ログの作成
データベース表にロギング情報を格納するには、TABLE_CREATEプロシージャを使用して表を作成する必要があります。キューブ作成ログは常に表に格納されます。ENABLEプロシージャは、その他のログのその他のターゲット・タイプを作成します。
キューブ作成ログを作成するには、次のようにします。
-
TABLE_CREATE
プロシージャを実行します。
次のコマンドは、CUBE_BUILD_LOG
というデフォルト名でキューブ作成ログを作成します。
EXECUTE dbms_cube_log.table_create(dbms_cube_log.type_build);
データベース表ターゲットでキューブ・ディメンション・コンパイル・ログ、キューブ操作ログまたはキューブ拒否レコード・ログを作成するには:
-
TABLE_CREATE
プロシージャを実行して表を作成します。 -
ENABLE
プロシージャを実行してロギングを開始します。
これらのコマンドは、CUBE_OPERATIONS_LOG
というデフォルト名とデフォルトの冗長性レベルでキューブ操作表を作成し、有効にします。
EXECUTE dbms_cube_log.table_create(dbms_cube_log.type_operations); EXECUTE dbms_cube_log.enable(dbms_cube_log.type_operations);
トレース・ファイル、ディスク・ファイルまたはLOBターゲットでキューブ・ディメンション・コンパイル・ログ、キューブ操作ログまたはキューブ拒否レコード・ログを作成するには、次のようにします。
-
ENABLE
プロシージャを実行します。
このコマンドは、キューブ拒否レコード・ログを有効にし、冗長性をLOWESTレベルに設定し、出力をWORK_DIR
データベース・ディレクトリにあるrejects.log
という名前のディスク・ファイルに送ります。
EXECUTE dbms_cube_log.enable(dbms_cube_log.type_rejected_records, - dbms_cube_log.target_file, dbms_cube_log.level_lowest, - 'WORK_DIR/rejects.log');
46.1.6 DBMS_CUBE_LOG - キューブ作成ログ
キューブ作成ログからは、作成中の実行内容に関する情報が得られます。このログを使用して、作成により予測どおりの結果が得られたかどうか、得られなかった場合は、その理由を確認できます。
キューブ作成ログの内容は、作成中は継続的に更新されます。作成の進行状況を評価し、完了する時間を推測するために、いつでもログに問い合せることができます。
キューブ作成ログのデフォルト名は、CUBE_BUILD_LOG
です。次の表に内容を示します。
ノート:
キューブ作成ログを管理するには、TABLE_CREATE
およびVERSION
プロシージャのみを使用します。
列 | データ・タイプ | NULL | 説明 |
---|---|---|---|
|
|
-- |
作成に対する一意の順序番号。パラレル作成では、スレーブ・プロセスに対して同じ番号が使用されます。 |
|
|
-- |
パラレル作成時のスレーブ・プロセスのカウンタ: 0(ゼロ)はマスター・プロセス、1は1番目のスレーブ、2は2番目のスレーブのように示されます。 |
|
|
-- |
コマンドの現在のステータス: |
|
|
-- |
|
|
|
-- |
処理されるキューブまたはキューブ・ディメンションの名前。 |
|
|
-- |
オブジェクトのタイプ: |
|
|
-- |
XML文書のように構造化された、コマンドに関する情報。追加の情報がない場合( |
|
|
-- |
作成オブジェクトを含むアナリティック・ワークスペースの名前。 |
|
|
アナリティック・ワークスペースおよびすべての作成オブジェクトの所有者。 |
|
|
|
-- |
処理されるパーティションの名前。現在の操作がパーティションに対応していない場合は |
|
|
-- |
作成を識別する、ユーザー定義の文字列。 |
|
|
-- |
表に行が追加される日時。 |
|
|
-- |
キューブ作成スクリプト。 |
|
|
-- |
作成元: |
|
|
-- |
コマンドのネストの深度。たとえば、 |
|
|
-- |
処理されるサブオブジェクト(キューブの集計ルールを継承しないメジャーなど)の名前。 |
|
|
-- |
現行のコマンドに関連付けられているリフレッシュ・メソッド( |
|
|
-- |
現在は使用されていません。 |
|
|
-- |
現行のプロセスでのコマンドの順序番号で、異なるオブジェクトに対する同じコマンドを区別するために使用できます。たとえば、 |
|
|
-- |
現在は使用されていません。 |
|
|
-- |
特定のコマンドについてすべての行の順序番号を識別します。たとえば、特定のコマンドは4行で表され、最初の行のステータスは |
46.1.7 DBMS_CUBE_LOG - キューブ・ディメンション・コンパイル・ログ
キューブの解を求める場合、OLAPではディメンション階層が有効であることを確認するためにチェックします。この検証中に発生したエラーは、キューブ・ディメンション・コンパイル・ログに書き込まれます。
チェックは次のような内容です。
-
循環性: 階層は、ディメンション・メンバーの間の親子関係で定義されます。循環性は、ディメンション・メンバーがそれ自体の祖先または子孫に指定されたときに発生します。
-
階層タイプ: 階層はレベルに基づくことも値に基づくこともできます。キューブ・マテリアライズド・ビューのようにレベルに基づく階層のみが有効であるようにキューブを定義することができます。
-
レベル・オプション: レベルに基づく階層は、規則的、不規則またはスキップ・レベルが可能です。時間ディメンションのように規則的な階層のみが有効であるようにディメンションを定義することができます。
キューブ・ディメンション・コンパイル・ログのデフォルト名は、CUBE_DIMENSION_COMPILE
です。次の表に内容を示します。
列 | データ・タイプ | NULL | 説明 |
---|---|---|---|
|
|
-- |
現在の操作の識別子 |
|
|
-- |
キューブ作成ログの順序番号 |
|
|
|
レポートされているエラーの番号 |
|
|
-- |
エラーに関連付けられたエラー・メッセージ |
|
|
-- |
コンパイルされているディメンションの名前 |
|
|
-- |
障害があるディメンション・メンバー |
|
|
-- |
|
|
|
-- |
エラーに関連する最初の階層 |
|
|
-- |
エラーに関連する2番目の階層 |
|
|
-- |
エラーに関する詳細 |
46.1.8 DBMS_CUBE_LOG - キューブ操作ログ
キューブ操作ログには、すべてのOLAPエンジン・イベントに関するメッセージおよびデバッグ情報が含まれています。現在の操作を非常に詳細なレベルで追跡できます。SQL_ID
列を使用すると、キューブ操作ログをV$SQL
、V$SESSION
およびV$SESSION_LONGOPS
などの動的パフォーマンス・ビューと結合して、I/O待機やCPUなどその他のデータベース操作のコンテキストでキューブ操作を確認できます。
キューブ操作ログのデフォルト名は、CUBE_OPERATIONS_LOG
です。次の表に内容を示します。
列 | データ・タイプ | NULL | 説明 |
---|---|---|---|
|
|
|
インスタンスの識別子 |
|
|
|
セッションの識別子 |
|
|
|
セッション・シリアル番号 |
|
|
|
ユーザーの識別子 |
|
|
-- |
実行中のSQL文の識別子。 |
|
|
-- |
ジョブの識別子 |
|
|
-- |
現在の操作の識別子 |
|
|
-- |
親の操作の識別子 |
|
|
-- |
キューブ作成ログの順序番号 |
|
|
|
レコードがキューブ操作ログに追加された時間。 |
|
|
|
|
|
|
-- |
レコードのネストの深度。たとえば、レベル0は操作およびサブ操作が、他の操作およびサブ操作内にネストされていないことを示しています。 |
|
|
|
AGGREGATE、ROWSOURCEまたはSQLIMPORTなどの現在の操作。 |
|
|
-- |
LoadingまたはImportなどの現在のサブ操作。 |
|
|
|
START、TRACE、COMPLETEDまたは |
|
|
|
ROWS LOADED、AVE_ROW_LENおよびPAGEPOOLSIZEなどのレコードの名前。 |
|
|
-- |
|
|
|
-- |
|
46.1.9 DBMS_CUBE_LOG - キューブ拒否レコード・ログ
キューブ拒否レコード・ログには、ローダー・ジョブおよび予測された形式に適合しなかったために拒否されたレコードのサマリーが含まれています。
ソース表の単一の行には、複数のフィールドのエラーが含まれている場合があります。各フィールドがエラーをログに生成し、結果として同じROWID4の複数の行が作成されます。
SOURCE_ROW
列に作成されます。
キューブ拒否レコード・ログのデフォルト名は、CUBE_REJECTED_RECORDS
です。次の表に内容を示します。
列 | データ・タイプ | NULL | 説明 |
---|---|---|---|
|
|
-- |
現在の操作の識別子 |
|
|
-- |
キューブ作成ログの順序番号 |
|
|
|
レコードによって起動されるエラー数 |
|
|
-- |
エラーに関連付けられたエラー・メッセージ |
|
|
-- |
入力レコード数 |
|
|
-- |
ソース表の行のROWID。ソースがビューまたは問合せの場合はNULL |
46.2 DBMS_CUBE_LOGサブプログラムの要約
この表は、DBMS_CUBE_LOG
のサブプログラムについて説明しています。
表46-1 DBMS_CUBE_LOGサブプログラム
サブプログラム | 説明 |
---|---|
様々なログ・タイプのデフォルトの表名を戻します。 |
|
セッションの継続中ロギングをオフにします。 |
|
セッションの継続中ロギングをオンにし、ロギングを追加出力タイプにリダイレクトしてログの冗長性レベルを変更します。 |
|
バッファされたすべてのメッセージを強制的にログに書き込みます。 |
|
特定のログのレベルと場所の現在の設定を戻します。 |
|
すべてのアクティブなログの説明を取得します。 |
|
ロギングの様々な要素を制御するオプションの現在の値を戻します。 |
|
冗長性レベルHIGHの整数値を戻します。 |
|
冗長性レベルHIGHESTの整数値を戻します。 |
|
冗長性レベルLOWの整数値を戻します。 |
|
冗長性レベルLOWESTの整数値を戻します。 |
|
冗長性レベルMEDIUMの整数値を戻します。 |
|
すべてのロギングを入力文字列で指定された値に設定します。 |
|
ロギングの様々な要素を制御するオプションを設定します。 |
|
OLAPログのターゲット表を作成します。 |
|
ディスク・ファイル・ターゲットの整数値を戻します。 |
|
LOBターゲットの整数値を戻します。 |
|
データベース表ターゲットの整数値を戻します。 |
|
トレース・ファイル・ターゲットの整数値を戻します。 |
|
キューブ作成ログの整数値を戻します。 |
|
キューブ・ディメンション・コンパイル・ログの整数値を戻します。 |
|
キューブ操作ログの整数値を戻します。 |
|
キューブ拒否レコード・ログの整数値を戻します。 |
|
特定のログ表のバージョン番号または特定のログ・タイプの現在のバージョン番号を戻します。 |
46.2.1 DEFAULT_NAMEファンクション
このファンクションは、様々なログ・タイプのデフォルトの表名を戻します。
構文
DBMS_CUBE_LOG.DEFAULT_NAME ( LOG_TYPE IN BINARY_INTEGER DEFAULT TYPE_OPERATIONS) RETURN VARCHAR2;
パラメータ
表46-2 DEFAULT_NAMEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
「ロギング・タイプ」を参照してください。 |
戻り値
指定されたログ・タイプのデフォルトの表名。
例
この例は、キューブ操作ログのデフォルト名を戻します。
SELECT dbms_cube_log.default_name FROM dual; DEFAULT_NAME ------------------------------ CUBE_OPERATIONS_LOG
次の例は、キューブ拒否レコード・ログのデフォルト名を戻します。
select dbms_cube_log.default_name(dbms_cube_log.type_rejected_records) - "Default Name" from dual; Default Name ------------------------- CUBE_REJECTED_RECORDS
46.2.2 DISABLEプロシージャ
このプロシージャは、ENABLE
プロシージャで再度明示的にロギングがオンにされた場合を除き、セッションの継続中ロギングをオフにします。
構文
DBMS_CUBE_LOG.DISABLE ( LOG_TYPE IN BINARY_INTEGER DEFAULT, LOG_TARGET IN BINARY_INTEGER DEFAULT);
パラメータ
表46-3 DISABLEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
ノート: このプロシージャでキューブ作成ログを無効にすることはできません。 詳細は、ロギング・タイプを参照してください。 |
|
ロギング・レコードの次のいずれかの宛先です。
「ロギング・ターゲット」を参照してください |
例
このコマンドは、ディメンション・コンパイル・エラー・ログ表を無効にします。
EXECUTE dbms_cube_log.disable(dbms_cube_log.type_dimension_compile);
46.2.3 ENABLEプロシージャ
このプロシージャは、セッションの継続中またはDISABLE
プロシージャを使用してオフにされるまで、ロギングをオンにします。
ENABLE
プロシージャでも、ロギングを追加出力タイプに送り、ログの詳細の量を変更できます。ログ・タイプは、各ログ・ターゲットに対して有効にできます。たとえば、キューブ操作ログを異なる冗長性レベルでトレース・ファイル、表およびファイルに対して有効にできますが、キューブ操作ログを同時に2つのファイルに対して有効にすることはできません。
このプロシージャはログの形式もチェックして、必要に応じて更新します。
構文
DBMS_CUBE_LOG.ENABLE ( LOG_TYPE IN BINARY_INTEGER DEFAULT NULL, LOG_TARGET IN BINARY_INTEGER DEFAULT NULL, LOG_LEVEL IN BINARY_INTEGER DEFAULT NULL); DBMS_CUBE_LOG.ENABLE ( LOG_TYPE IN BINARY_INTEGER DEFAULT NULL, LOG_TARGET IN BINARY_INTEGER DEFAULT NULL, LOG_LEVEL IN BINARY_INTEGER DEFAULT NULL, LOG_LOCATION IN VARCHAR2 DEFAULT NULL); DBMS_CUBE_LOG.ENABLE ( LOG_TYPE IN BINARY_INTEGER DEFAULT NULL, LOG_TARGET IN BINARY_INTEGER DEFAULT NULL, LOG_LEVEL IN BINARY_INTEGER DEFAULT NULL, LOG_LOCATION IN/OUT CLOB );
パラメータ
表46-4 ENABLEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
ノート: このプロシージャでキューブ作成ログを無効にすることはできません。 詳細は、ロギング・タイプを参照してください。 |
|
ロギング・レコードの次のいずれかの宛先です。
詳細は、ロギング・ターゲットを参照してください |
|
次の冗長性レベルのいずれかです。各レベルでは前のレベルに新しいタイプのメッセージが追加されます。
「冗長性レベル」を参照してください。 |
|
ログの完全なID( |
例
次のコマンドはすべてのキューブ・ログを有効にします。
EXECUTE dbms_cube_log.enable;
次のPL/SQLプロシージャはログ・レベルをLEVEL_LOWEST
に設定します。
BEGIN dbms_cube_log.disable(dbms_cube_log.type_rejected_records); dbms_cube_log.enable(dbms_cube_log.type_rejected_records, dbms_cube_log.target_table, dbms_cube_log.level_lowest); END; /
46.2.4 FLUSHプロシージャ
このプロシージャは、バッファされたすべてのメッセージを強制的にログに書き込みます。
バッファはセッションを通じて自動的にフラッシュされますが、ログを表示する前に手動でフラッシュすることですべてのメッセージを確実に表示できます。
構文
DBMS_CUBE_LOG.FLUSH ( );
例
次の例ではすべてのログのバッファをフラッシュします。
EXECUTE dbms_cube_log.flush;
46.2.5 GET_LOGプロシージャ
このプロシージャは、特定のログのレベルと場所の現在の設定を戻します。
構文
DBMS_CUBE_LOG.GET_LOG ( LOG_TYPE IN BINARY_INTEGER DEFAULT TYPE_OPERATIONS, LOG_TARGET IN BINARY_INTEGER DEFAULT TARGET_TABLE, LOG_LEVEL OUT BINARY_INTEGER, LOG_LOCATION OUT VARCHAR2 );
パラメータ
表46-5 GET_LOGプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
詳細は、ロギング・タイプを参照してください。 |
|
ロギング・レコードの次のいずれかの宛先です。
詳細は、ロギング・ターゲットを参照してください |
|
次の冗長性レベルのいずれかです。各レベルでは前のレベルに新しいタイプのメッセージが追加されます。
詳細は、冗長性レベルを参照してください。 |
|
ログの完全なID( |
使用上のノート
log_type
がアクティブでない場合は、log_level
およびlog_location
はNULLです。DBMS_CUBE_LOG.ENABLE
を使用して、ログをアクティブにします。
例
このPL/SQLプロシージャを使用すると、キューブ拒否レコード・ログに関する情報が得られます。
SET serverout ON format wrapped DECLARE myloglevel binary_integer; mylogtarget varchar2(128); BEGIN dbms_cube_log.get_log(dbms_cube_log.type_rejected_records, dbms_cube_log.target_table, myloglevel, mylogtarget); dbms_output.put_line('Log Level: ' || myloglevel); dbms_output.put_line('Log Target: ' || mylogtarget); END; /
このプロシージャは、次のような結果を生成します。
Log Level: 5 Log Target: GLOBAL.CUBE_REJECTED_RECORDS
46.2.6 GET_LOG_SPECファンクション
このファンクションは、すべてのアクティブなキューブ操作ログ、キューブ拒否レコード・ログおよびキューブ・ディメンション・コンパイル・ログの説明を取得します。
構文
DBMS_CUBE_LOG.GET_LOG_SPEC ( ) RETURN VARCHAR2;
戻り値
すべてのアクティブなログのタイプおよびターゲット。
使用上のノート
このファンクションの出力は、SET_LOG_SPEC
への入力に使用できます。
例
次の例は、キューブ操作ログ、キューブ拒否レコード・ログおよびキューブ・ディメンション・コンパイル・ログがアクティブであることを示しています。キューブ操作ログは、セッション・トレース・ファイルに格納され、その他のログは表に格納されています。
SELECT dbms_cube_log.get_log_spec FROM dual; GET_LOG_SPEC -------------------------------------------------------------------------------- OPERATIONS(TABLE, TRACE) REJECTED_RECORDS(TABLE[DEBUG])
46.2.7 GET_PARAMETERファンクション
このファンクションは、ロギングの様々な要素を制御するオプションの現在の値を戻します。これらのオプションを設定するには、SET_PARAMETER
ファンクションを使用します。
構文
DBMS_CUBE_LOG.GET_PARAMETER ( LOG_TYPE IN BINARY_INTEGER, LOG_PARAMETER IN BINARY_INTEGER ) RETURN BINARY_INTEGER;
パラメータ
表46-6 GET_PARAMETERファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
詳細は、ロギング・タイプを参照してください。 |
|
次のオプションのいずれかです。
「SET_PARAMETERプロシージャ」を参照してください。 |
戻り値
指定されたlog_parameter
の値。
例
この例は、ロギングが停止する前にキューブ拒否レコード・ログにあるエラーの現在の最大数を示しています。このパラメータは以前はSET_PARAMETER
プロシージャで設定されました。
SELECT dbms_cube_log.get_parameter(dbms_cube_log.type_rejected_records, 1) - "Maximum Records" FROM dual; Maximum Records --------------- 100
46.2.8 LEVEL_HIGHファンクション
このファンクションは、冗長性レベルHIGHの整数値を戻します。
構文
DBMS_CUBE_LOG.LEVEL_HIGH () RETURN BINARY_INTEGER;
戻り値
4
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。「冗長性レベル」を参照してください。
例
このコマンドは、キューブ操作表の冗長性レベルをHIGHに設定します。
EXECUTE dbms_cube_log.enable(dbms_cube_log.type_operations, - dbms_cube_log.target_table, dbms_cube_log.level_high);
46.2.9 LEVEL_HIGHESTファンクション
このファンクションは、冗長性レベルHIGHESTの整数値を戻します。
構文
DBMS_CUBE_LOG.LEVEL_HIGHEST () RETURN BINARY_INTEGER;
戻り値
5
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、冗長性レベルを参照してください。
例
このコマンドは、キューブ操作表の冗長性レベルをHIGHESTに設定します。
EXECUTE dbms_cube_log.enable(dbms_cube_log.type_operations, - dbms_cube_log.target_table, dbms_cube_log.level_highest);
46.2.10 LEVEL_LOWファンクション
このファンクションは、冗長性レベルLOWの整数値を戻します。
構文
DBMS_CUBE_LOG.LEVEL_LOW () RETURN BINARY_INTEGER;
戻り値
2
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、冗長性レベルを参照してください。
例
このコマンドは、キューブ操作表の冗長性レベルをLOWに設定します。
EXECUTE dbms_cube_log.enable(dbms_cube_log.type_operations, - dbms_cube_log.target_table, dbms_cube_log.level_low);
46.2.11 LEVEL_LOWESTファンクション
このファンクションは、冗長性レベルLOWESTの整数値を戻します。このレベルは、キューブ・ディメンションおよびキューブの作成に使用された各コマンドのステータス、スレーブ・プロセスの使用およびサマリー・レコードをログに記録します。
構文
DBMS_CUBE_LOG.LEVEL_LOWEST () RETURN BINARY_INTEGER;
戻り値
1
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、冗長性レベルを参照してください。
例
このコマンドは、キューブ操作表の冗長性レベルをLOWESTに設定します。
EXECUTE dbms_cube_log.enable(dbms_cube_log.type_operations, - dbms_cube_log.target_table, dbms_cube_log.level_lowest);
46.2.12 LEVEL_MEDIUMファンクション
このファンクションは、冗長性レベルMEDIUMの整数値を戻します。
構文
DBMS_CUBE_LOG.LEVEL_MEDIUM () RETURN BINARY_INTEGER;
戻り値
3
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、冗長性レベルを参照してください。
例
このコマンドは、キューブ操作表の冗長性レベルをMEDIUMに設定します。
EXECUTE dbms_cube_log.enable(dbms_cube_log.type_operations, - dbms_cube_log.target_table, dbms_cube_log.level_medium);
46.2.13 SET_LOG_SPECプロシージャ
このプロシージャは、すべてのロギングを入力文字列で指定された値に設定します。
構文
DBMS_CUBE_LOG.SET_LOG_SPEC ( LOG_SPEC IN VARCHAR2 );
パラメータ
表46-7 SET_LOG_SPECプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
|
使用上のノート
GET_LOG_SPEC
ファンクションは、SET_LOG_SPEC
に適切に書式設定された文字列を戻します。
例
このPL/SQLプロシージャは、すべてのログを無効にし、無効化されたことを検証してから、キューブ操作ログとキューブ拒否レコード・ログをアクティブにします。
BEGIN dbms_cube_log.disable; dbms_output.put_line('Cube Logs: ' || dbms_cube_log.get_log_spec); dbms_cube_log.set_log_spec('OPERATIONS(TRACE) REJECTED_RECORDS(TABLE)'); dbms_output.put_line('Cube Logs: ' || dbms_cube_log.get_log_spec); END; /
プロシージャからの出力は、DISABLE
ファンクションがすべてのログを非アクティブ化したこと、およびSET_LOG_SPEC
ファンクションが2つのログをアクティブ化したことを検証します。
Cube Logs: Cube Logs: OPERATIONS(TRACE) REJECTED_RECORDS(TABLE)
46.2.14 SET_PARAMETERプロシージャ
このプロシージャは、ロギングの様々な要素を制御するオプションを設定します。
これらのオプションの現在の値を取得するには、GET_PARAMETER
ファンクションを使用します。
構文
DBMS_CUBE_LOG.SET_PARAMETER ( LOG_TYPE IN BINARY_INTEGER, LOG_PARAMETER IN BINARY_INTEGER, VALUE IN BINARY_INTEGER );
パラメータ
表46-8 SET_PARAMETERプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
詳細は、ロギング・タイプを参照してください。 |
|
次のパラメータのいずれかです。
|
|
|
例
このPL/SQLプロシージャは、2つのパラメータを設定してから、GET_PARAMETER
ファンクションを使用して設定を表示します。
BEGIN dbms_cube_log.set_parameter(dbms_cube_log.type_rejected_records, 1, 150); dbms_cube_log.set_parameter(dbms_cube_log.type_rejected_records, 2, 5); dbms_output.put_line('Max rejected records: ' || dbms_cube_log.get_parameter(dbms_cube_log.type_rejected_records, 1)); dbms_output.put_line('Buffer time: ' || dbms_cube_log.get_parameter(dbms_cube_log.type_rejected_records, 2) || ' seconds'); END; /
プロシージャは、次の情報を表示します。
Max rejected records: 150 Buffer time: 5 seconds
46.2.15 TABLE_CREATEプロシージャ
このプロシージャは、OLAPログのターゲット表を作成します。このプロシージャを使用するには、CREATE TABLE
権限が必要です。
TABLE_CREATE
も既存のログ表を現行バージョンにアップグレードして、データを保持します。
構文
DBMS_CUBE_LOG.TABLE_CREATE ( LOG_TYPE IN BINARY_INTEGER DEFAULT, TBLNAME IN VARCHAR2 DEFAULT );
パラメータ
表46-9 TABLE_CREATEプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
詳細は、ロギング・タイプを参照してください。 |
|
ログの表名。これらはデフォルト名です。
|
例
この例は、CUBE_OPERATIONS_LOG
という名前のキューブ操作ログを作成します。
EXECUTE dbms_cube_log.table_create;
この例は、CUBE_REJECTED_RECORDS
という名前のキューブ拒否レコード・ログを作成します。
EXECUTE dbms_cube_log.table_create(dbms_cube_log.type_rejected_records);
次の例は、MY_BUILD_LOG
という名前のキューブ作成ログを作成します。
EXECUTE dbms_cube_log.table_create - (dbms_cube_log.type_build, 'MY_BUILD_LOG');
46.2.16 TARGET_FILEファンクション
このファンクションは、DBMS_CUBE_LOG
サブプログラムにあるファイル・ターゲットの整数値を戻します。
構文
DBMS_CUBE_LOG.TARGET_FILE () RETURN BINARY_INTEGER;
戻り値
3
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。「ロギング・ターゲット」を参照してください。
例
このコマンドは、キューブ操作ログ・ファイルを無効にします。
EXECUTE dbms_cube_log.disable - (dbms_cube_log.type_operations, dbms_cube_log.target_file);
46.2.17 TARGET_LOBファンクション
このファンクションは、LOBターゲットの整数値を戻します。
構文
DBMS_CUBE_LOG.TARGET_LOB () RETURN BINARY_INTEGER;
戻り値
4
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_LEVEL
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、ロギング・ターゲットを参照してください。
例
このコマンドは、キューブ操作ログLOBを無効にします。
EXECUTE dbms_cube_log.disable - (dbms_cube_log.type_operations, dbms_cube_log.target_lob);
46.2.18 TARGET_TABLEファンクション
このファンクションは、表ターゲットの整数値を戻します。
構文
DBMS_CUBE_LOG.TARGET_TABLE () RETURN BINARY_INTEGER;
戻り値
1
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_TARGET
パラメータに相当する2進整数のかわりにこのファンクションを使用します。「ロギング・ターゲット」を参照してください。
例
このコマンドは、キューブ操作ログ表を無効にします。
EXECUTE dbms_cube_log.disable - (dbms_cube_log.type_operations, dbms_cube_log.target_table);
46.2.19 TARGET_TRACEファンクション
このファンクションは、トレース・ファイル・ターゲットの整数値を戻します。
構文
DBMS_CUBE_LOG.TARGET_TRACE () RETURN BINARY_INTEGER;
戻り値
2
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_TARGET
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、ロギング・ターゲットを参照してください。
例
このコマンドは、キューブ操作ログ・トレース・ファイルを無効にします。
EXECUTE dbms_cube_log.disable - (dbms_cube_log.type_operations, dbms_cube_log.target_trace);
46.2.20 TYPE_BUILDファンクション
このファンクションは、キューブ作成ログの整数値を戻します。
構文
DBMS_CUBE_LOG.TYPE_BUILD () RETURN BINARY_INTEGER;
戻り値
4
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_TYPE
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、ロギング・タイプを参照してください。
例
この問合せは、キューブ作成ログのデフォルト名を戻します。
SELECT dbms_cube_log.default_name(dbms_cube_log.type_build) "Log Name" - FROM dual; Log Name ------------------------- CUBE_BUILD_LOG
46.2.21 TYPE_DIMENSION_COMPILEファンクション
このファンクションは、キューブ・ディメンション・コンパイル・ログの整数値を戻します。
構文
DBMS_CUBE_LOG.TYPE_DIMENSION_COMPILE () RETURN BINARY_INTEGER;
戻り値
3
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_TYPE
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、ロギング・タイプを参照してください。
例
この問合せは、キューブ・ディメンション・コンパイル・ログのデフォルト名を戻します。
SELECT dbms_cube_log.default_name(dbms_cube_log.type_dimension_compile) - "Log Name" FROM dual; Log Name ------------------------- CUBE_DIMENSION_COMPILE
46.2.22 TYPE_OPERATIONSファンクション
このファンクションは、キューブ操作ログの整数値を戻します。
構文
DBMS_CUBE_LOG.TYPE_OPERATIONS () RETURN BINARY_INTEGER;
戻り値
1
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_TYPE
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、ロギング・タイプを参照してください。
例
この問合せは、キューブ・ディメンション・コンパイル・ログのデフォルト名を戻します。
SELECT dbms_cube_log.default_name(dbms_cube_log.type_operations) "Log Name" - FROM dual; Log Name ------------------------- CUBE_OPERATIONS_LOG
46.2.23 TYPE_REJECTED_RECORDSファンクション
このファンクションは、キューブ拒否レコード・ログの整数値を戻します。
構文
DBMS_CUBE_LOG.TYPE_REJECTED_RECORDS () RETURN BINARY_INTEGER;
戻り値
2
使用上のノート
DBMS_CUBE_LOG
サブプログラムのLOG_TYPE
パラメータに相当する2進整数のかわりにこのファンクションを使用します。詳細は、ロギング・タイプを参照してください。
例
この問合せは、キューブ拒否レコード・ログのデフォルト名を戻します。
SELECT dbms_cube_log.default_name(dbms_cube_log.type_rejected_records) - "Log Name" FROM dual; Log Name ------------------------- CUBE_REJECTED_RECORDS
46.2.24 VERSIONファンクション
このファンクションは、特定のログ表のバージョン番号または特定のログ・タイプの現在のバージョン番号を戻します。
構文
DBMS_CUBE_LOG.VERSION ( LOG_TYPE IN BINARY_INTEGER DEFAULT 1, TBLNAME IN VARCHAR2 DEFAULT NULL) RETURN BINARY_INTEGER;
パラメータ
表46-10 VERSIONファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
次のログ・タイプのいずれかです。
詳細は、ロギング・タイプを参照してください。 |
|
バージョンが戻されるログ表の名前。 |
戻り値
バージョン番号
例
この例は、キューブ操作ログの現在のバージョンを戻します。
SELECT dbms_cube_log.version FROM dual; VERSION ---------- 2
この例は、CUBE_REJECTED_RECORDS
という名前の既存のキューブ拒否レコード・ログのバージョン番号を戻します。
SELECT dbms_cube_log.version(dbms_cube_log.type_rejected_records, - 'CUBE_REJECTED_RECORDS') version FROM dual; VERSION ---------- 2