From 5c5042a6c46059d2fb66ee12617017d8ae970ef0 Mon Sep 17 00:00:00 2001
From: Anay Nayak <anaynayak@users.noreply.github.com>
Date: Tue, 2 Nov 2021 04:02:54 +0530
Subject: [PATCH] textql: add page (#7154)

---
 pages/common/textql.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/common/textql.md

diff --git a/pages/common/textql.md b/pages/common/textql.md
new file mode 100644
index 000000000..6dcd30518
--- /dev/null
+++ b/pages/common/textql.md
@@ -0,0 +1,28 @@
+# textql
+
+> Execute SQL against structured text like csv or tsv files.
+> More information: <https://github.com/dinedal/textql>.
+
+- Print the lines in the specified `.csv` file that match a SQL query to stdout:
+
+`textql -sql "{{SELECT * FROM filename}}" {{path/to/filename.csv}}`
+
+- Query `.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 {{file1}} JOIN {{file2}} ON {{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}}`