diff options
Diffstat (limited to 'contrib/format-ltsv/README.md')
-rw-r--r-- | contrib/format-ltsv/README.md | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/contrib/format-ltsv/README.md b/contrib/format-ltsv/README.md new file mode 100644 index 000000000..05916b08c --- /dev/null +++ b/contrib/format-ltsv/README.md @@ -0,0 +1,38 @@ +# Drill LTSV files Plugin + +Drill LTSV storage plugin allows you to perform interactive analysis using SQL against LTSV files. + +For more information about LTSV, please see [LTSV (Labeled Tab-separated Values)](http://ltsv.org/). + +## Example of Querying an LTSV File + +### About the Data + +Each line in the LTSV file has the following structure: + +``` +time:<value> TAB host:<value> TAB forwardedfor:<value> TAB req:<value> TAB status:<value> TAB size:<value> TAB referer:<value> TAB ua:<value> TAB reqtime:<value> TAB apptime:<value> TAB vhost:<value> NEWLINE +``` + +For example, + +``` +time:30/Nov/2016:00:55:08 +0900<TAB>host:xxx.xxx.xxx.xxx<TAB>forwardedfor:-<TAB>req:GET /v1/xxx HTTP/1.1<TAB>status:200<TAB>size:4968<TAB>referer:-<TAB>ua:Java/1.8.0_131<TAB>reqtime:2.532<TAB>apptime:2.532<TAB>vhost:api.example.com +time:30/Nov/2016:00:56:37 +0900<TAB>host:xxx.xxx.xxx.xxx<TAB>forwardedfor:-<TAB>req:GET /v1/yyy HTTP/1.1<TAB>status:200<TAB>size:412<TAB>referer:-<TAB>ua:Java/1.8.0_201<TAB>reqtime:3.580<TAB>apptime:3.580<TAB>vhost:api.example.com +``` + +The Drill dfs storage plugin definition includes an LTSV format that requires a file to have an `.ltsv` extension. + +### Query the Data + +Issue a SELECT statement to get the second row in the file. + +``` +0: jdbc:drill:zk=local> SELECT * FROM dfs.`/tmp/sample.ltsv` WHERE reqtime > 3.0; ++-----------------------------+------------------+---------------+-----------------------+---------+-------+----------+-----------------+----------+----------+------------------+ +| time | host | forwardedfor | req | status | size | referer | ua | reqtime | apptime | vhost | ++-----------------------------+------------------+---------------+-----------------------+---------+-------+----------+-----------------+----------+----------+------------------+ +| 30/Nov/2016:00:56:37 +0900 | xxx.xxx.xxx.xxx | - | GET /v1/yyy HTTP/1.1 | 200 | 412 | - | Java/1.8.0_201 | 3.580 | 3.580 | api.example.com | ++-----------------------------+------------------+---------------+-----------------------+---------+-------+----------+-----------------+----------+----------+------------------+ +1 row selected (6.074 seconds) +``` |