4D v16.3LOG FILE TO JSON |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v16.3
LOG FILE TO JSON
LOG FILE TO JSON
LOG FILE TO JSONコマンドはカレントログファイル、または指定されたログファイルを、JSONフォーマットで保存します。 ログ (バイナリーファイル) がJSON形式で保存されると、その中身はデータベース管理者あるいはあらゆるユーザーによって読み出しや解釈が可能となり、それにより例えばデータベースイベントの解析などが可能になります。 destFolderPath 引数には、JSONファイルを保存したいフォルダーのパスを渡します。ファイル名は JournalExport.json となります。 デフォルトでは、書き出されるJSONファイルの最大サイズは10MBとなっています。ファイルがこのサイズに到達すると、ファイルは閉じられ新しいファイルが作成されます。それぞれのJSONファイルのサイズを制限する事で、ファイルを解析する際のメモリ要求を抑える事ができます。maxSize 引数に値を(バイト単位で)設定する事で書き出されるファイルの最大サイズを変更する事ができます。0を渡すとデフォルトサイズにリセットします。負の値を渡すとサイズの上限を撤廃できます。
デフォルトで、logPath 引数が省略されている場合、コマンドはカレントログファイルを保存します。特定のログファイルを書き出したい場合、そのパスを logPath 引数に渡します。ログファイルは ".journal" 拡張子を持つファイルでなければなりません。アーカイブされたログファイル(.4bl)を書き出したい場合、RESTORE コマンドを使用して事前に変換する必要があります。空の文字列("")を渡す事で標準のファイルを開くダイアログボックスを表示する事ができ、書き出すログファイルをユーザーに選択させることができます。選択されたログファイルのパスはDocumentシステム変数に返されます。
注: コマンドがカレントログファイルを保存する際、データベースはロックされません。ファイルがディスクに書き込まれている間に新しいオペレーションを実行する事も可能です。ただしこれらのオペレーションは保存されるファイルには含まれません。 カレントログファイルを書き出す際、fieldAtt 引数は、フィールドが書き出された属性の中でどのように表現されるかを定義します。番号 (デフォルト)、あるいは名前で表現されます。"Backup and Restore" 定数テーマ内にある、以下の定数のうちのいずれかを渡す事ができます:
注: 外部ログファイルを書き出す場合、フィールドは常に番号によって表現されます。 保存されたJOSNファイルはログに記録された全てのオペレーションを、JSONオブジェクト配列形式で格納します。それぞれのオブジェクトにはオペレーションをあらわす複数のプロパティが含まれます。例: [ 注: fieldAtt引数にField attribute with name定数を渡した場合、"fields"オブジェクトは以下のようになります: ... 実際に含まれるプロパティの実際の一覧は、オペレーションのタイプ(レコード作成、レコード削除、レコード編集、Blob作成、等)によって異なります。主なプロパティは以下の通りです:
カレントのログファイルをJSON形式で保存したい場合を考えます: LOG FILE TO JSON("c:\\4Dv15\\ExportLogs") 特定のログファイルをJSON形式で書き出して、それにフィールド名も含めたい場合を考えます: LOG FILE TO JSON("c:\\4Dv15\\ExportLogs";0;"c:\\4Dv15\\Backup\\old_myDB.journal";Field attribute with name) LOG FILE TO JSONコマンドは、OKシステム変数とDocumentシステム変数の値を変更します。JSONファイルが正常に保存されていた場合、OK変数は1に設定され、Document変数にはログファイルのパス名が格納されます。logPath引数に""(空の文字列)を渡し、ユーザーがファイル選択ダイアログボックスをキャンセルした場合、OK変数は0に設定され、Document変数には空の文字列が渡されます。ユーザーが不正なファイルを選択した場合、OK変数は0に設定され、Document変数には不正なファイルのパスが格納されます。
参照
|
プロパティ
プロダクト: 4D 履歴
初出: 4D v15 R4 ARTICLE USAGE
ランゲージリファレンス ( 4D v16) |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||