db2fmtlog – ログ・ファイル情報をフォーマットして表示するコマンド
db2fmtlog ツールでトランザクション・ログ・ファイルから情報を抽出して表示します。 バージョン 11.5.6以降、ツールはこれらのログ・ファイル内のログ・レコードも表示します。
さまざまなタイプの情報を表示または推論することができます。次にその情報の一例を挙げます。
- ログ・ファイルが暗号化または圧縮されているかどうか。
- ログ・ファイルが関連付けられているログ・チェーン。
- ログ・ファイル内のログ・レコードの範囲。
- スタンバイ・データベースの読み取り (ROS) で有効化された HADR スタンバイ・データベースで適用されている場合に適用専用ウィンドウをトリガーするログ・ファイル内のログ・レコード。
- 抽出ログ・ファイルの内容。
重要:
- このコマンドによって表示されるすべてのログ・レコードが取り上げられているわけではありません。 文書化されている Db2® ログ・レコードについては、 Db2 ログ・レコードを参照してください。
- サマリー・レポートの出力の解釈はユーザーの責任で行います。 IBM® は、既に文書化されている情報以外の情報は提供しません。
許可
すべてのユーザーがこのコマンドを実行できますが、アーカイブ・ログ・ファイルに対する読み取り許可が必要です。必要な接続
なしコマンド構文
コマンド・パラメーター
- log_file_number_start
- フォーマット対象のログ・ファイルの数値 ID を指定します。 例えば、ログ・ファイル S0000017.LOG の数値 ID は 17 です。
log_file_number_endパラメータも指定されている場合は、log_file_number_startはフォーマットログファイル範囲の最初の数値識別子を表します。 - log_file_number_end
- フォーマット対象ログ・ファイルの範囲の最後の数値 ID を指定します。
log_file_number_endの値は、log_file_number_start以上でなければなりません。 - 形式オプション
- オプションが指定されていない場合、ログ・ファイルからの基本的な情報が表示されます。 暗号化されたログ・ファイルに鍵ストアのパスワード情報の指定が必要なのは、鍵ストアのパスワードがスタッシュされていない場合のみです。
- -summaryfile summary_file_name
- それぞれのログ・レコードによって 1 行の出力が生成される短いサマリー・レポートを指定します。
- フィルター・オプション
- ログ・レコードの出力が、フィルター条件と一致する内容のみになるように調整します。
- -xlog
- 従来型のログ・ファイルではなく、抽出ログ・ファイルにフォーマットするよう指定します。 抽出ログファイル名は、
X<#######>.METAの形式です。ここで、#######は、ファイルの数値識別子を表す7桁の数字です。 - -lsnrange
- ログ・ファイルの LFS、LSN、および LSO 値の範囲のリストを表示します。
- -replayonlywindow
- スタンバイ・データベースの読み取りが有効になっている HADR スタンバイ・データベースでログを適用する場合に適用専用ウィンドウをトリガーできる各ログ・レコードを表示します。
ログ・ファイルが暗号化されている場合、 暗号化解除が可能な環境でこのツールを実行する必要があります。 この要件には、 ネイティブ暗号化ライブラリーへのアクセスが含まれ、スタッシュされた鍵ストアのパスワード・ファイルが使用可能であるか、有効な鍵ストア・パスワード・オプションが指定されていることが必要です。
- -kspassword keystore_password
- 鍵ストアを開くためのパスワードを指定します。
- -kspassarg fd:file_descriptor | ファイル名:filepath
- 鍵ストア・パスワード引数を指定します。 file_descriptor パラメーターは、使用するパスワードが含まれている、読み取り可能なオープン状態のファイルまたはパイプを示すファイル記述子を指定します。 filepath パラメーターは、使用するパスワードが入っているファイルのパスを指定します。
例
- Example 1
- 以下の例は、オプションを指定せずにフォーマット暗号化ログ・ファイルS0000003.LOGを示しています。
$ db2fmtlog 3 Log File S0000003.LOG: Extent Number 3 Format Version 14 Architecture Level Version V:11 R:1 M:3 F:3 I:0 SB:0 Encrypted Yes Compression Mode OFF Number of Pages 4 Partition 0 Log Stream 0 Database Seed 3136515636 Log File Chain ID 0 Master Key Label DB2_SYSGEN_db2admin1_ENCDB_2018-02-06-17.37.48_35002821 Previous Extent ID 2018-02-06-22.39.38.000000 GMT Current Extent ID 2018-02-06-22.39.39.000000 GMT Database log ID 2018-02-06-22.37.49.000000 GMT Topology Life ID 2018-02-06-22.37.49.000000 GMT First LFS/LSN 4173/000000000003F5AF Last LFS/LSN 4185/000000000003F637 LSO range 44933825 to 44950128 |------|------------------------------------------------------------------------ | PAGE | Page number: 0 | | Byte count = 4076 | | First index = 0 | | Page header flags = 0x0010 | | - SQLPG_PHF_END_OF_FLUSH | | Page lso = 44937900 |------|------------------------------------------------------------------------ | LREC | 18653 0004E339 0000000001AD I:DPS:FILEREG_STARTED |------|------------------------------------------------------------------------ | LREC | Record LSO = 44933825 | | LFS = 18653 | | LSN = 000000000004E339 | | Record Size = 0x002E = 46 | | Record Type = 0x69 = Info Only | | Log Header Flags = 0x2010 | | Record TID = 0000000001AD | | Back Pointer LSO = 0 | | Originator Code = 0x0C = DPS | | Function ID = 0x0B = 11 : SQLP_LREC_ID_FILEREG_STARTED |------|------------------------------------------------------------------------ | LREC | 18654 00056339 000000000199 N:DMS:INSREC_DP 2:8 |------|------------------------------------------------------------------------ | LREC | Record LSO = 44933871 | | LFS = 18654 | | LSN = 0000000000056339 | | Record Size = 0x005A = 90 | | Record Type = 0x4E = Normal | | Log Header Flags = 0x0000 | | Record TID = 000000000199 | | Back Pointer LSO = 0 | | Originator Code = 0x01 = Data File Manager | | Function ID = 0xA2 = 162 : INSREC_DP | | PoolID = 2 ObjectID = 8 |------|------------------------------------------------------------------------ | LREC | 18654 0005633A 000000000199 Commit SE 2021-05-12-22.24.34 GMT |------|------------------------------------------------------------------------ | LREC | Record LSO = 44933961 | | LFS = 18654 | | LSN = 000000000005633A | | Record Size = 0x0030 = 48 | | Record Type = 0x84 = Commit SE | | Log Header Flags = 0x2000 | | Record TID = 000000000199 | | Back Pointer LSO = 44933871 | | Time Stamp = 0x609C55A2 = 1620858274 = 2021-05-12-22.24.34 GMT | | Nanoseconds = 1 - Example 2
- 以下の例は、他のオプションを指定せずにフォーマットされた、未暗号化抽出ログ・ファイル
X0000011.METAを示しています。 抽出ログ・ファイルは同じ数値 ID を持つ従来型ログ・ファイルのカプセル化なので、印字されるのは従来型ログ・ファイルの名前になります。$$ db2fmtlog -xlog 11 Log File S0000011.LOG: Extent Number 11 Format Version 14 Architecture Level Version V:11 R:5 M:4 F:0 I:0 SB:0 Encrypted No Compression Mode OFF Number of Pages 1 Partition 0 Log Stream 0 Database Seed 3830086524 Log File Chain ID 3 Previous Extent ID 2020-05-06-23.21.37.000000 GMT Current Extent ID 2020-05-06-23.21.38.000000 GMT Database log ID 2020-05-06-21.23.05.000000 GMT Topology Life ID 2020-05-06-21.23.05.000000 GMT First LFS/LSN 11093/000000000004487F Last LFS/LSN 11095/0000000000044881 LSO range 49531553 to 49535628 - Example 3
- 次の例は、
-lsnrangeオプションでS0000009.LOGフォーマット暗号化ログファイルS0000003.LOGを示しています。$ db2fmtlog -lsnrange 3-9 S0000003.LOG: First LFS/LSN 4173/000003F5AF Last LFS/LSN 4185/000003F637 LSO range 44884913 to 44901216 S0000004.LOG: First LFS/LSN 4185/000003F638 Last LFS/LSN 4200/000003F6E9 LSO range 44901217 to 44917520 S0000005.LOG: First LFS/LSN 4200/000003F6EA Last LFS/LSN 4218/000003F76F LSO range 44917521 to 44933824 S0000006.LOG: First LFS/LSN 4218/000003F770 Last LFS/LSN 4236/000003F795 LSO range 44933825 to 44946052 S0000007.LOG: First LFS/LSN 4237/000003F796 Last LFS/LSN 4237/000003F796 LSO range 44950129 to 44954204 S0000008.LOG: First LFS/LSN 4238/000003F797 Last LFS/LSN 4238/000003F797 LSO range 44966433 to 44970508 S0000009.LOG: First LFS/LSN 4239/000003F798 Last LFS/LSN 4247/000003F81A LSO range 44982737 to 44999040 - Example 4
- 次の例は、暗号化されていないログファイルS0000004.LOGが
-replayonlywindowオプションにフォーマットされたことを示しています。 ls の出力を入力として使用するには、コマンド形式「ls *.LOG | db2fmtlog -replayonlywindow-」の末尾に「-」が必要です。$ ls S0000004.LOG | db2fmtlog -replayonlywindow - |------|------------------------------------------------------------------------ | LREC | 4812 0003F9E6 000000000197 |------|------------------------------------------------------------------------ | LREC | Record LSO = 53456514 | | Record TID = 000000000197 | | Action = DDL |------|------------------------------------------------------------------------ | LREC | 4812 0003F9E7 000000000197 |------|------------------------------------------------------------------------ | LREC | Record LSO = 53456942 | | Record TID = 000000000197 | | DDL Statement = create table t5ba.t1 (a int, b long varchar) in t1 |------|------------------------------------------------------------------------ | LREC | 4828 0003FA6F 0000000001CF |------|------------------------------------------------------------------------ | LREC | Record LSO = 53467006 | | Record TID = 0000000001CF | | Action = LOAD |------|------------------------------------------------------------------------ | LREC | 4832 0003FA76 0000000001D0 |------|------------------------------------------------------------------------ | LREC | Record LSO = 53473142 | | Record TID = 0000000001D0 | | Action = LOAD |------|------------------------------------------------------------------------ | LREC | 4839 0003FAD5 0000000001E9 |------|------------------------------------------------------------------------ | LREC | Record LSO = 53489660 | | Record TID = 0000000001E9 | | Action = DDL - Example 5
- 次の例は、
-replayonlywindowオプションを使用しているが、キーストアパスワードがない（そして、隠されたキーストアパスワードファイルが利用できない）暗号化ログファイルのフォーマットを示しています。 エラーが発生すると、db2fmtlogコマンドは現在のログ・ファイルをスキップし、次のログ・ファイルで処理を再開します。$ db2fmtlog -replayonlywindow 4 Could not retrieve DEK for log file "S0000004.LOG". Reason code: -2141452066, sqlcode: -1728. Processing will resume in the next log file. - Example 6
- 以下の例は、キーストア・パスワードを指定し
-replayonlywindowオプションを使う暗号化ログ・ファイルのフォーマット方法を示しています。$ db2fmtlog -replayonlywindow 4 -kspassword This8Is0Password |------|------------------------------------------------------------------------ | LREC | 4193 0003F6AB 000000000171 |------|------------------------------------------------------------------------ | LREC | Record LSO = 44911967 | | Record TID = 000000000171 | | Action = DDL - Example 7
- 以下の例は、フィルターとサマリー・ファイルのフォーマット方法を示しています。 次のコマンドを実行します。
フィルターの出力は次のとおりです。db2fmtlog 30595 -filter OBJECT=0:264 -summaryfile sum
サマリー・ファイルの出力は次のとおりです。Log File S0030595.LOG: Extent Number 30595 Format Version 14 Architecture Level Version V:11 R:5 M:7 F:0 I:0 SB:0 Encrypted No Compression Mode OFF Number of Pages 4 Partition 0 Log Stream 0 Database Seed 1756970922 Log File Chain ID 0 Previous Extent ID 2021-03-21-18.25.40.000000 GMT Current Extent ID 2021-03-21-18.25.41.000000 GMT Database log ID 2021-03-18-07.21.57.000000 GMT Topology Life ID 2021-03-18-07.21.57.000000 GMT First LFS/LSN 103544/0000000000460B12 Last LFS/LSN 103546/0000000000460BA0 LSO range 547830705 to 547847008 |------|------------------------------------------------------------------------ | LREC | Record LSO = 547830721 | | LFS = 103545 | | LSN = 0000000000460B12 | | Record Size = 0x0081 = 129 | | Record Type = 0x4E = Normal | | Log Header Flags = 0x0000 | | Record TID = 000000009532 | | Back Pointer LSO = 547830556 | | Originator Code = 0x02 = Index Manager | | Function ID = 0x65 = 101 : ADDKEY_DP | | PoolID = 0 ObjectID = 264 Index Object Type = 0x1 | | Parent PoolID = 0 Parent ObjectID = 264 | | Index Root Page = 0x00000002 = 2 |------|------------------------------------------------------------------------ | LREC | Record LSO = 547830922 | | LFS = 103545 | | LSN = 0000000000460B14 | | Record Size = 0x00A5 = 165 | | Record Type = 0x4E = Normal | | Log Header Flags = 0x0000 | | Record TID = 000000009532 | | Back Pointer LSO = 547830721 | | Originator Code = 0x01 = Data File Manager | | Function ID = 0xA2 = 162 : INSREC_DP | | PoolID = 0 ObjectID = 264 |------|------------------------------------------------------------------------ | LREC | Record LSO = 547831087 | | LFS = 103545 | | LSN = 0000000000460B15 | | Record Size = 0x0081 = 129 | | Record Type = 0x4E = Normal | | Log Header Flags = 0x0000 | | Record TID = 000000009532 | | Back Pointer LSO = 547830922 | | Originator Code = 0x02 = Index Manager | | Function ID = 0x65 = 101 : ADDKEY_DP | | PoolID = 0 ObjectID = 264 Index Object Type = 0x1 | | Parent PoolID = 0 Parent ObjectID = 264 | | Index Root Page = 0x00000002 = 2 |------|------------------------------------------------------------------------ | LREC | Record LSO = 547831216 | | LFS = 103545 | | LSN = 0000000000460B16 | | Record Size = 0x00A6 = 166 | | Record Type = 0x52 = Redo | | Log Header Flags = 0x0000 | | Record TID = 000000009532 | | Back Pointer LSO = 547831087 | | Originator Code = 0x02 = Index Manager | | Function ID = 0x79 = 121 : SQLI_LRT_UPDKEY | | PoolID = 0 ObjectID = 264 Index Object Type = 0x1 | | Parent PoolID = 0 Parent ObjectID = 264 | | Index Root Page = 0x00000002 = 2LFS LSN TID Log Record Type Object Log Record Data |------|------------------------------------------------------------------------ | LREC | 103545 00460B12 000000009532 N:IXM:ADDKEY_DP 0:264 RtIPg=2 | LREC | 103545 00460B14 000000009532 N:DMS:INSREC_DP 0:264 | LREC | 103545 00460B15 000000009532 N:IXM:ADDKEY_DP 0:264 RtIPg=2 | LREC | 103545 00460B16 000000009532 R:IXM:UPDKEY 0:264 RtIPg=2