Map
(since EVL 1.0)
Map input columns to output ones.
- Map
-
is to be used in EVS job structure definition file.
<f_in>and<f_out>are either input and output file or flow name. - evl map
-
is intended for standalone usage, i.e. to be invoked from command line and reading records from standard input and writing to standard output.
EVD, EVM and EVS are EVL definition files, for details see evl-evd(5), evl-evm(5) and evl-evs(5).
Synopsis
Map <f_in> <f_out> (<evd_in>|-D <inline_evd>) (<evd_out>|-d <inline_evd>) <evm> [-x|--text-input] [-y|--text-output] [-o <f_out>] [--output<n>=<f_out>]... [--outputs=<varname>] [--reject <f_out>] [--reject<n>=<f_out>]... [--rejects=<varname>] evl map (<evd_in>|-D <inline_evd>) (<evd_out>|-d <inline_evd>) <evm> [-x|--text-input] [-y|--text-output] [-o <f_out>] [--output<n>=<f_out>]... [--outputs=<varname>] [--reject=<f_out>] [--reject<n>=<f_out>]... [--rejects=<varname>] [-v|--verbose] evl map ( --help | --usage | --version )
Options
- -D, --input-definition=<inline_evd>
-
either this option or the file
<evd_in>must be presented. Example: ‘-D 'id int, user_id string'’ - -d, --output-definition=<inline_evd>
-
either this option or the file
<evd_out>must be presented. Example: ‘-d 'user_sum long'’ - -o, --output=<f_out>
-
when ‘output()’ function is used in the mapping, out structure is forwarded into
<f_out> - --output<n>=<f_out>
-
when function ‘output(<n>)’ is used in mapping, where
<n>is an integer from 4 to 16, out structure is forwarded into<f_out> - --outputs=<varname>
-
specifies an array ‘${<varname>[@]}’ which contains filenames to be used for ‘output(N)’ functions in mapping. Example: for ‘--outputs=OUTFILE’, ‘${OUTFILE[120]}’ is the filename used for ‘output(120)’
- --reject=<f_out>
-
when ‘reject()’ function is used in the mapping, input record is rejected into
<f_out> - --reject<n>=<f_out>
-
when function ‘reject(<n>)’ is used in mapping, where
<n>is an integer from 4 to 16, input record is rejected into<f_out> - --rejects=<varname>
-
specifies an array ‘${<varname>[@]}’ which contains filenames to be used for ‘reject(N)’ functions in mapping. Example: for ‘--rejects=REJECTS’, ‘${REJECTS[1000]}’ is the filename used for ‘reject(1000)’
- -x, --text-input
-
suppose the input as text, not binary
- -y, --text-output
-
write the output as text, not binary
Standard options:
- --help
-
print this help and exit
- --usage
-
print short usage information and exit
- -v, --verbose
-
print to stderr info/debug messages of the component
- --version
-
print version and exit