snippetbashTip

textql — Execute SQL against structured text like CSV or TSV files. More information: <https://github.com/din

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandtextexecuteagainstclisqlstructuredtextql

Problem

How to use the textql command: Execute SQL against structured text like CSV or TSV files. More information: <https://github.com/dinedal/textql#usage>.

Solution

textql — Execute SQL against structured text like CSV or TSV files. More information: <https://github.com/dinedal/textql#usage>.

Print the lines in the specified CSV file that match an SQL query to stdout:

textql -sql "{{SELECT * FROM filename}}" {{path/to/filename.csv}}

Query a TSV file:

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:

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}}

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}}

Code Snippets

Print the lines in the specified CSV file that match an SQL query to `stdout`

textql -sql "{{SELECT * FROM filename}}" {{path/to/filename.csv}}

Query a TSV file

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`

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}}

Context

tldr-pages: common/textql

Revisions (0)

No revisions yet.