データベースへの接続から切断までのアクセス情報を出力したトレースです。データベースへの接続ごとに出力されます。
拡張データベースアクセストレースは,次のように利用できます。
なお,出力するイベントの種類や,トレースファイルの最大容量などは,Cosminexus DABroker Libraryの[環境設定ユティリティ],またはCosminexus DABroker Library動作環境定義ファイルで定義しておきます。Cosminexus DABroker Libraryの動作環境の設定については,Windowsの場合は「11.2.1(3) Cosminexus DABroker Libraryの動作環境の設定」,UNIXの場合は「11.2.2(4) Cosminexus DABroker Libraryの動作環境の設定」を参照してください。Cosminexus DABroker Library動作環境定義ファイルの詳細については,マニュアル「Cosminexus アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「17.2 Cosminexus DABroker Library動作環境定義ファイル」を参照してください。
拡張データベースアクセストレースのファイル出力形式を次に示します。斜体は可変の情報です。拡張データベースアクセストレースは,次の2種類の情報で構成されます。
個々のトレース情報は,出力項目を示すタイトル行の下に出力されます。
*-------------------------------------------------------* |
*-------------------------------------------------------* |
拡張データベースアクセストレースの出力項目について,次の表に示します。斜体は可変の情報です。
表F-2 拡張データベースアクセストレースの出力項目
項目 | 内容 | |
---|---|---|
ヘッダ情報 | ||
DRV | Cosminexus DABroker Libraryのデータベースアクセスドライバの種別に従い,次の識別子が出力されます。
| |
Date:YYYY/MM/DD hh:mm:ss.nnnnnn | ファイル作成日時(YYYY/MM/DD hh:mm:ss.nnnnnn)が出力されます。
| |
DABroker Connect ID:AAAAA(BBBBB) | データベース接続識別子が出力されます。 | |
Process ID:CCCCC | 実行プロセスIDが出力されます。 | |
UserID:DDDDD | 接続ユーザIDが出力されます。 Cosminexus DABroker LibraryでORACLEのOS認証機能を使用した場合は,「OS authority」となります。 | |
Client Name:EEEEE | J2EEアプリケーション名称が出力されます。名称が設定されていない場合は空白になります。 | |
(DB別出力情報) | 接続データベースによって異なる情報が出力されます。 | |
HiRDBの場合 |
| |
Oracleの場合 |
| |
Lang Mode:GGGGG | 実行言語モードが出力されます。 | |
個々のトレース情報 | ||
THREAD-ID | 実行スレッドIDが出力されます。 | |
CID | カーソル番号が出力されます。 | |
EVT | Cosminexus DABroker Libraryがデータベースに要求した処理内容を示す文字列が出力されます。データベースアクセストレースおよび拡張データベースアクセストレースの内容が含まれます。 Cosminexus DABroker Libraryの[環境設定ユティリティ]またはCosminexus DABroker Library動作環境定義ファイルで設定された内容のイベントが出力されます。なお,すべてのイベントを出力しない設定にしている場合は,ヘッダだけが出力されます。なお,何か一つでもイベントを出力する設定にしている場合は,GET_DIAGイベントは必ず出力されます。 出力されるイベントを次に示します。
| |
START-TIME | アクセス開始日時(YYYY/MM/DD hh:mm:ss.nnnnnn)が出力されます。
| |
END-TIME | アクセス終了日時(YYYY/MM/DD hh:mm:ss.nnnnnn)が出力されます。
| |
RETCODE | データベースから返されるリターンコードが出力されます。 | |
BLOCKCNT | FETCH時の行取得件数が出力されます。 | |
(Windows QueryPerformance Counter) | Windowsの場合に,高分解パフォーマンス情報が表示されます。 | |
HiRDB_CONNECTION_ID | コネクションID(aaaa:bbbb:cccc)が出力されます。
| |
(SQL)SS…SS | クライアントから要求のあったSQLの内容が出力されます。この項目は,必要に応じて出力されます。 |
拡張データベースアクセストレースのファイルは,次のディレクトリに作成されます。
拡張データベースアクセストレースのファイル名称は,次の規則に従います。斜体は可変の情報です。
spdb_XXXXXXXX_YYYYYYYY_HHHHHHHHHHHHHHHH_<接続データベース名称>ZZZZZ.IIIIII
ファイル名称中の文字列について次に示します。
表F-3 拡張データベーストレースのファイル名称の規則
項目 | 意味 |
---|---|
XXXXXXXX | 実行プロセスIDが設定されます。 |
YYYYYYYY | データベース接続識別子が設定されます。 |
HHHHHHHHHHHHHHHH_ | 実行プロセスごとにユニークな接続識別子が設定されます。 |
<接続データベース名称> | 接続データベース名称です。指定したデータベース種別によって,次のどれかが設定されます。
|
ZZZZZ | 識別順序番号が設定されます。 同じ実行プロセスIDで,かつ同じデータベース接続識別子のファイルがある場合に,00000から32767までの番号を付加します。 |
IIIIII | ファイル拡張子が設定されます。
|