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

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を指定し、認証に使用されます。