Loads data in a comma-separated values (CSV) or tab-separated values (TSV) file. This loads the header information in the first line of the CSV or TSV file and uses it as a field name.
- Path to the file from which you want to load the data. Using a wildcard (
*) in the file name, you can load all files containing a specific string pattern in the file name at once. For example, if you enter
PATH, you can load all files, such as "allow-ip.csv", "allow-user.csv", "allow-url.csv" at once. To load a file, the Logpresso daemon must have the read permission to the file.
- Character set (default: utf-8). This option is case-insensitive. Use the preferred MIME name or aliases registered in the following document as
- Maximum number of records to load (default: unlimited).
- Maximum number of columns to load (default: 10,000). If the maximum number of columns is exceeded, use the
restoption to define the processing method.
- Number of records to skip (default:
- Boolean option to process the column data exceeding the maximum number specified by the
f). See usage #3 and #4.
t: Puts data beyond the maximum number of columns specified by the
maxcoloption in the _rest field.
f: Discards the rest of the columns beyond the maximum number of columns specified by the
- Compliance with RFC4180 (https://tools.ietf.org/html/rfc4180) (default:
f). See Usage #5 to #8.
t: Strictly parses to conform RFC 4180 as the same as when you open the CSV file with Microsoft Excel. This option cannot be used when
f: Flexibly parses the CSV file.
- Option to use tab character as a separator (default:
t: Uses tab character as a separator. This is useful for processing tab-separated values (TSV) files.
f: Uses comma (
,) as a separator.
# Download: https://raw.githubusercontent.com/logpresso/dataset/main/wp-nginx.csv | csvfile /opt/logpresso/wp-nginx.csv
Read 20 records after skipping the header line of
csvfile limit=20 offset=1 /opt/logpresso/wp-nginx.csv
Read only 4 columns in the
csvfile maxcol=4 /opt/logpresso/wp-nginx.csv
Read only 4 columns from the
/opt/logpresso/wp-nginx.csvand assign the rest to the _rest field.
csvfile maxcol=4 rest=t /opt/logpresso/wp-nginx.csv
Data with a white space between the separator and the column. Compare the results of each query example.
strict=t, if there is a whitespace between the separator and the column, the double quotes (
") are recognized as a character and are not parsed as intended.
# Download: https://raw.githubusercontent.com/logpresso/dataset/main/csvfile-strict-option-test-1.csv | csvfile strict=t /opt/logpresso/csvfile-strict-option-test-1.csv
strict=f, if the pair of double quotes (
"") is matched, only the strings inside the pair of quotes are recognized as columns, so it is parsed as intended.
csvfile strict=f /opt/logpresso/csvfile-strict-option-test-1.csv
Data without a white space between the separator and the column.
Regardless of the
strictvalue, there is no whitespace between the separator and the column, so it is parsed as intended.
# Download: https://raw.githubusercontent.com/logpresso/dataset/main/csvfile-strict-option-test-2.csv | csvfile strict=t /opt/logpresso/csvfile-strict-option-test-2.csv csvfile strict=f /opt/logpresso/csvfile-strict-option-test-2.csv
Data in which double quote characters (") are escaped with a backslash (
strict=t, the command recognizes the escape character (
\) as a general character, so if you use
\"when writing double quotes (
") in a column enclosed in a pair of double quotes (
" "), it is not parsed as intended.
# Download: https://raw.githubusercontent.com/logpresso/dataset/main/csvfile-strict-option-test-3.csv | csvfile strict=t /opt/logpresso/csvfile-strict-option-test-3.csv
strict=f, two consecutive double quotes (
"") and an escaped double quote (
\") are parsed as a double quote within the column as intended.
csvfile strict=f /opt/logpresso/csvfile-strict-option-test-1.csv csvfile strict=f /opt/logpresso/csvfile-strict-option-test-3.csv