shunanalyzeコマンドが動作するにあたっての条件を記述します。
以下に、集計条件ファイルの実行パラメタを示します。
注意
集計条件ファイルの内容は、CharacterCodeパラメタで指定したデータの文字コードで記述してください。
パラメタ名は行の先頭から記述してください。
パラメタ名 | 省略 | 説明 |
|---|---|---|
可 | 検索対象となる文字列の文字コードを指定します。 | |
可 | 入力ファイルタイプを指定します。 | |
可 | 出力ファイルタイプを指定します。本パラメタを省略した場合、CSVが指定されたとみなします。 | |
LCondition | 可 | 仮想項目機能を使う場合に、仮想項目定義を指定します。 |
不可 | グループ式を指定します。 | |
不可 | 集計式を指定します。 | |
可 | CSV形式で出力する場合に、グループ化に使用されていないグループ項目の値として、グループキーの代わりに出力される文字列を指定します。 | |
可 | 集計結果を取りまとめるルートタグ名を指定します。 | |
可 | 集計機能で利用するメモリサイズをメガバイト(MB)で指定します。 集計機能で利用するメモリサイズは、本パラメタで指定したサイズに加えデータ加工用にメモリを使用します。 | |
可 | 集計式に指定する数値演算式における空の扱いを指定します。 | |
可 | 集計結果の先頭にグループ式に指定された項目を出力する、または、出力しないを指定できます。 |
入力データをグループ化するためのグループ式を指定します。
1～1024バイトの範囲で指定してください。
図1.31 GConditionの定義
参照
グループ式の詳細については、“3.4 グループ式”を参照してください。
グループ式によって分類された各グループそれぞれに対する演算を、集計式に指定します。
1～65535バイトの範囲で指定してください。
図1.32 RConditionの定義
参照
集計式の詳細については、“3.5 集計式”を参照してください。
空白文字を含む文字列を指定する場合は、二重引用符(")で囲んで指定します。
二重引用符(")で括った文字列が空の場合(""と記述した場合)は、半角ハイフン（"-"）が指定されたとみなします。
注意
GStringパラメタに二重引用符（"）、および改行文字は指定できません。
集計機能で利用するメモリサイズをメガバイト(MB)で指定します。
集計処理実行時、指定サイズを超えるメモリが必要となる場合、analyze用動作環境ファイルのWorkFolderパラメタで指定した作業ディレクトリに、一時ファイルが作成されます。
本パラメタは集計機能で利用できるメモリ資源の最大サイズを指定してください。ただし、32ビット用Data Effectorの場合、プロセス空間に対して使用可能なメモリサイズよりも小さい値を指定してください。プロセス空間に対して使用可能なメモリサイズよりも大きい値を指定すると、エラーになります。以下に32ビット用Data Effectorの場合、MemorySizeパラメタに指定可能な最大値を示します。
OS | MemorySizeパラメタに指定可能な最大値 |
|---|---|
Windows | 3072MB |
Linux | 3072MB |
注意
Data Effectorで効率的にデータ加工処理を行うためには、本パラメタの指定を推奨します。本パラメタを省略して、analyze用動作環境ファイルのWorkFolderパラメタが指定されている場合、以下の状況が発生します。
メモリ不足が発生する場合がある。
集計対象のデータ量が少ない場合においても一時ファイルを必ず使用するため、集計時の処理時間が長くなる。
analyze用動作環境ファイルのParallelNumパラメタは使用できない。
集計処理で名前付きパイプは使用できない。
標準入力は使用できない。
プロセス空間に対して使用可能なメモリサイズは実行環境にも依存するため、上記の値より小さい値でも、プロセス空間に対して使用可能なメモリサイズの制限でエラーになる場合があります。
本パラメタに指定したサイズが、実行する環境の物理メモリサイズよりも大きい場合、実行する環境の物理メモリサイズが設定されます。このとき本コマンドは正常に終了し、以下の警告が出力されます。
shnde: WARNING: 02007: The memory size has exceeded the installing memory. Memory size = 2500[MB]; Installing memory size = 2007[MB]. (analyze) |
| 実行環境のメモリサイズ | ||
|---|---|---|---|
MemorySizeパラメタに指定したサイズより実行環境に搭載されたメモリサイズが小さい場合 (例：物理メモリサイズ256MB) | MemorySizeパラメタに指定したサイズより実行環境に搭載されたメモリサイズが大きい場合 (例：物理メモリサイズ7GB) | ||
利用メモリサイズ | MemorySizeパラメタに500を指定する | 物理メモリサイズで動作し、MemorySizeパラメタに指定したサイズが搭載メモリサイズを超えた旨のメッセージ(shnde: WARNING: 02007)が出力されます。 (例：256MBで動作します) | 指定メモリサイズ(500MB)で動作します。 |
MemorySizeパラメタに5000を指定する | プロセス空間のメモリサイズ制限でエラーになります。 | プロセス空間のメモリサイズ制限でエラーになります。 | |
MemorySizeパラメタに5000を指定する | 物理メモリサイズで動作し、MemorySizeパラメタに指定したサイズが搭載メモリサイズを超えた旨のメッセージ(shnde: WARNING: 02007)が出力されます。 (例：256MBで動作します) | 指定メモリサイズ(5000MB)で動作します。 | |
集計式に指定する数値演算式における空の扱いを指定します。
指定できる値は以下のいずれかです。
設定 | 意味 |
|---|---|
YES | 数値演算式における算術演算において、空を0とみなして演算します。 |
NO | 数値演算式における算術演算において、演算対象に空が含まれる場合、演算結果はすべて空を返します。 |
参照
数値演算式における空の扱いについては、“3.5.2 数値演算式における空の扱い”を参照してください。
集計結果の先頭にグループ式に指定された項目を出力する、または、出力しないを指定できます。
0: 集計結果の先頭に、グループ式に指定された項目を出力する。
1: 集計結果の先頭に、グループ式に指定された項目を出力しない。
本パラメタを省略した場合、0が指定されたものとみなします。
注意
本パラメタに1が指定され、かつ、Gstringパラメタが設定されている場合には、Gstringパラメタは有効になりません。
出力ファイルタイプがXMLで、本パラメタに1が指定された場合は、ラベルは省略可能です。
出力ファイルタイプがXMLで、本パラメタに1が指定された場合は、グループ項目タグは出力されません。
