tldr/pages/common/textql.md

29 lines
1.0 KiB
Markdown
Raw Normal View History

2021-11-01 22:32:54 +00:00
# textql
> Execute SQL against structured text like CSV or TSV files.
2021-11-01 22:32:54 +00:00
> More information: <https://github.com/dinedal/textql>.
- Print the lines in the specified CSV file that match an SQL query to `stdout`:
2021-11-01 22:32:54 +00:00
`textql -sql "{{SELECT * FROM filename}}" {{path/to/filename.csv}}`
- Query a TSV file:
2021-11-01 22:32:54 +00:00
`textql -dlm=tab -sql "{{SELECT * FROM filename}}" {{path/to/filename.tsv}}`
- Query file with header row:
`textql -dlm={{delimiter}} -header -sql "{{SELECT * FROM filename}}" {{path/to/filename.csv}}`
- Read data from `stdin`:
2021-11-01 22:32:54 +00:00
`cat {{path/to/file}} | textql -sql "{{SELECT * FROM stdin}}"`
- Join two files on a specified common column:
`textql -header -sql "SELECT * FROM {{path/to/file1}} JOIN {{file2}} ON {{path/to/file1}}.{{c1}} = {{file2}}.{{c1}} LIMIT {{10}}" -output-header {{path/to/file1.csv}} {{path/to/file2.csv}}`
2021-11-01 22:32:54 +00:00
- Format output using an output delimiter with an output header line:
`textql -output-dlm={{delimiter}} -output-header -sql "SELECT {{column}} AS {{alias}} FROM {{filename}}" {{path/to/filename.csv}}`