log_tool

OceanBaseデータベースのclogログは、従来のデータベースのredoログに似ています。clogログは、トランザクションのコミット時にトランザクションデータを永続化する役割を担っています。トランザクションデータとは、データベースに対するトランザクションの変更履歴です。log_toolは、clogファイルを解析して出力するために使用されます。本記事では、log_toolの使用方法について説明します。

log_toolは、旧バージョンのclog_toolであり、OceanBaseデータベースV4.x系で適応アップデートが行われました。一部のコマンド形式が変更され、一部の機能が削除されました。

log_toolコマンド

現在、log_toolはob_adminツールに統合されており、ob_admin コマンドを実行することでlog_toolを呼び出すことができます。 以下の表にlog_toolの一般的なコマンドを示します。

dump_log

ob_admin log_tool dump_log <clog_file_name>

コードの使用方法：

• dump_log コマンドを使用して、指定されたclogファイルとアーカイブファイルを解析し、出力します。複数のファイルを解析する場合は、ファイル名をスペースで区切る必要があります。

• ここで、clog_file_name は指定されたclogファイル名です。clog_file_name にはファイルパスを含めることができます。例えば：

  • 単一のclogファイルを解析して出力します。ここで解析対象のclogファイル名は 101 であり、このファイルは現在のディレクトリに存在するため、以下のコマンドを実行してこのファイルを解析し出力します。

    ob_admin log_tool dump_log 101
    

  • 複数のclogファイルを解析して出力します。ここで解析対象のclogファイル名は 101 と 103 であり、これらの2つのファイルはどちらも現在のディレクトリに存在するため、以下のコマンドを実行してこれら2つのファイルを解析し出力します。

    ob_admin log_tool dump_log 101 103
    

  • 複数の連続したclogファイルを解析して出力します。ここで解析対象のclogファイル名は 101、102、103 および 104 であり、これらのファイルはすべて現在のディレクトリに存在するため、以下のコマンドを実行してこれらのファイルを解析し出力します。

    ob_admin log_tool dump_log {101..104}
    

dump_filter

ob_admin log_tool dump_filter '<filter_name>' <clog_file_name>

コードの使用方法：

• dump_filter を使用して、フィルター条件に基づいてclogファイル内のトランザクション関連内容を出力します。

• <clog_file_name> の使用方法の詳細については、dump_logを参照してください。

• 現在、filter_name の値は以下のとおりです：

  フィルタ条件名	説明
  tablet_id	テーブル識別子
  tx_id	トランザクション識別子

  filter_name は単独で使用することも、組み合わせて使用することもできます。複数の条件でフィルタリングする場合は、条件名を英字のセミコロン (;) で区切る必要があります。例えば：

  • tablet_id が123、clogファイル名が 101 であり、現在のディレクトリに存在する場合、以下のコマンドを実行してこのファイルを解析し出力します。

    ob_admin log_tool dump_filter 'tablet_id=123' 101
    

  • tablet_id が 123、tx_id が 26058724 であり、解析対象のclogファイルが 101 であり、現在のディレクトリに存在する場合、以下のコマンドを実行してこのファイルを解析し出力します。

    ob_admin log_tool dump_filter 'tablet_id=123;tx_id=26058724' 101
    

stat

ob_admin log_tool stat <clog_file_name>

コードの使用方法：

• stat コマンドを使用して、指定されたclogファイルの統計情報を取得します。これには、ログファイルサイズ、ログレコード数、トランザクション数などの情報が含まれます。

  説明

  clog_toolは、環境変数 CLOG_TOOL_BREAK_ON_FAIL を使用して、解析プロセス中に直接終了するか、エラーを無視して続行するかを制御できます。CLOG_TOOL_BREAK_ON_FAIL の値がtrueの場合、直接終了します。CLOG_TOOL_BREAK_ON_FAIL の値がfalseの場合、エラーを無視して解析を続行します。

• <clog_file_name> の使用方法の詳細については、dump_logを参照してください。