コマンドラインパラメータの紹介

oblogminerを使用する際、さまざまなコマンドラインパラメータを設定することで、oblogminerのさまざまな機能を実現できます。oblogminerがサポートするコマンドラインパラメータは以下の表のとおりです。詳細な使用方法については、使用例を参照してください。

説明

1. パラメータタイプが文字列のパラメータを設定する際は、引用符を付ける必要があります。

2. -C/--column-cond はJSON形式で設定する必要があります。指定しない場合、フィルタリングは行われません。フィルタ条件を設定すると、一致しないテーブルデータは出力されませんが、対応するテーブルのDDLはフィルタリングされずに出力されます。設定例は以下のとおりです：

   [
     {
       "database_name":"db1",
       "table_name":"tbl1",
       "column_cond":[
         {
           "col1":"val1",
           "col2":"val2"
         },
         {
           "col3":null
         }
       ]
     }
   ]
   

   上記の設定例における各項目の意味は以下のとおりです。database_name、table_name、column_cond をすべて設定する必要があります。

   • database_name は、分析対象のデータベース名を指定するために使用されます。

   • table_name は、分析対象のテーブル名を指定するために使用されます。

   • column_cond は、database_name.table_name に対応する列レベルの条件を指定するために使用されます。

   -C/--column-cond を設定する際には、以下の点にも注意してください：

   • -C/--column-cond の設定は配列形式である必要があります。英字の角括弧（[]）で囲みます。各テーブルのフィルタ条件はJSONオブジェクトである必要があります。

   • すべてのキーと値は文字列データであるため、引用符を付ける必要があります。列の値がNULLの場合、valueは null に設定する必要があります。

   • column_cond フィールドは配列形式である必要があります。各オブジェクト（object）は「かつ条件」の一組であり、オブジェクト間は「または条件」となります。上記の設定例では、db1.tbl1 内の col1 列の値が val1 かつ col2 列の値が val2、または col3 列の値が null のレコードの変更を出力することを指定しています。

   • コマンドラインでこのパラメータを指定する場合、パラメータ内の引用符をエスケープする必要があります。つまり、" は \" に置き換える必要があります。

3. -o/--output は、データファイルの出力ディレクトリを設定します。ローカルディレクトリまたは OSS を設定でき、ディレクトリが空であることを確認する必要があります。

   • ローカルファイルシステムでは、パスを file:// で始めて指定でき、パスは絶対パスでなければなりません。例：file:///data/1/logminer_output/。

   • OSS に設定する場合、パスは oss:// で始まり、形式は oss://$PATH/$FILENAME/?host=$HOST&access_id=$ACCESS_ID&access_key=$ACCESSKEY のようになります。

     • $PATH はバケット内のファイルパスを指定し、ファイルが存在するディレクトリを表します。

     • $FILENAME はファイル名を指定し、アクセスする具体的なファイルを表します。

     • $HOST は OSS サービスのホスト名または CDN 加速のドメイン名、つまりアクセスする OSS サービスのアドレスを指定します。

     • $ACCESS_ID は OSS サービスへのアクセスに必要な Access Key ID を指定し、認証に使用されます。

     • $ACCESSKEY は OSS サービスへのアクセスに必要な Access Key Secret を指定し、認証に使用されます。