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

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の場合、値は null として設定する必要があります。

   • column_cond フィールドは配列形式であり、各オブジェクトは「かつ」条件の一組であり、オブジェクト間は「または」条件となります。上記の設定例では、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を指定し、認証に使用されます。