--host=Jesses-MBP-2:26257 --insecure
-socket: /tmp/.s.PGSQL.26257
-logs: /Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data/logs
-temp dir: /Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data/cockroach-temp805054895
-external I/O path: /Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data/extern
-store[0]: path=/Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data
-storage engine: pebble
-status: initialized new cluster
-clusterID: 455ad71d-21d4-424a-87ad-8097b6b5b99f
-nodeID: 1
-~~~
-
-To connect to this cluster with a socket:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --url='postgres://root@?host=/tmp&port=26257'
-~~~
+{% include {{ page.version.version }}/sql/sql-examples.md %}
## See also
diff --git a/v22.2/cockroach-sql-binary.md b/v22.2/cockroach-sql-binary.md
new file mode 100644
index 00000000000..e3a860d31e1
--- /dev/null
+++ b/v22.2/cockroach-sql-binary.md
@@ -0,0 +1,210 @@
+---
+title: cockroach-sql
+summary: cockroach-sql is a client for executing SQL statements from an interactive shell or directly from the command line.
+toc: true
+docs_area: reference.cli
+---
+
+{% assign release = site.data.releases | where_exp: "release", "release.major_version == page.version.version" | last %}
+
+The `cockroach-sql` command is a client for executing SQL statements from an interactive shell or directly from the command line. To use this client, run `cockroach-sql` as described below.
+
+{{site.data.alerts.callout_info}}
+`cockroach-sql` is functionally equivalent to the [`cockroach sql` command](cockroach-sql.html).
+{{site.data.alerts.end}}
+
+To exit the interactive shell, enter **\q**, **quit**, **exit**, or **Ctrl+D**.
+
+The output of `cockroach-sql` when used non-interactively is part of a stable interface, and can be used programmatically, with the exception of informational output lines that begin with the hash symbol (`#`). Informational output can change from release to release, and should not be used programmatically.
+
+## Install `cockroach-sql`
+
+
+ Linux Mac Windows
+
+Download the binary and copy it into your `PATH`.
+
+
+
+{% include_cached copy-clipboard.html %}
+~~~ shell
+curl https://binaries.cockroachdb.com/cockroach-sql-{{ page.release_info.version }}.linux-amd64.tgz | tar -xz && sudo cp -i cockroach-sql-{{ page.release_info.version }}.linux-amd64/cockroach-sql /usr/local/bin/ && if [ ! -f /usr/local/bin/cockroach ]; then sudo ln -s /usr/local/bin/cockroach-sql /usr/local/bin/cockroach; fi
+~~~
+
+If you don't have an existing `cockroach` binary in `/usr/local/bin` this will create a symbolic link to `cockroach` so you can use the `cockroach sql` command.
+
+
+
+
+{% include_cached copy-clipboard.html %}
+~~~ shell
+curl https://binaries.cockroachdb.com/cockroach-sql-{{ r.version }}.darwin-10.9-amd64.tgz | tar -xz && sudo cp -i cockroach-sql-{{ r.version }}.darwin-10.9-amd64/cockroach-sql /usr/local/bin && if [ ! -f /usr/local/bin/cockroach ]; then sudo ln -s /usr/local/bin/cockroach-sql /usr/local/bin/cockroach; fi
+~~~
+
+If you don't have an existing `cockroach` binary in `/usr/local/bin` this will create a symbolic link to `cockroach` so you can use the `cockroach sql` command.
+
+
+
+
+Open a PowerShell terminal as an Administrator, then run the following command:
+
+{% include_cached copy-clipboard.html %}
+~~~ shell
+$ErrorActionPreference = "Stop"; [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12;$ProgressPreference = 'SilentlyContinue'; $null = New-Item -Type Directory -Force $env:appdata/cockroach; Invoke-WebRequest -Uri https://binaries.cockroachdb.com/cockroach-sql-{{ page.release_info.version }}.windows-6.2-amd64.zip -OutFile cockroach-sql.zip; Expand-Archive -Force -Path cockroach-sql.zip; Copy-Item -Force "cockroach-sql/cockroach-sql-{{ page.release_info.version }}.windows-6.2-amd64/cockroach-sql.exe" -Destination $env:appdata/cockroach; $Env:PATH += ";$env:appdata/cockroach"; if (!(Test-Path "$env:appdata/cockroach/cockroach.exe")) { New-Item -ItemType SymbolicLink -Path $env:appdata/cockroach/cockroach.exe -Target $env:appdata/cockroach/cockroach-sql.exe }
+~~~
+
+If you don't have an existing `cockroach` binary in `$env:appdata/cockroach/` this will create a symbolic link to `cockroach` so you can use the `cockroach sql` command.
+
+
+
+Or you can download the [binary from the releases page](../releases/{{ page.version.version }}.html) and install it manually.
+
+## Prerequisites
+
+The [role option of the user](create-role.html#role-options) logging in must be `LOGIN` or `SQLLOGIN`, which are granted by default. If the user's role option has been set to `NOLOGIN` or `NOSQLLOGIN`, the user cannot log in using the SQL CLI with any authentication method.
+
+## Synopsis
+
+Start the interactive SQL shell:
+
+~~~ shell
+$ cockroach-sql
+~~~
+
+Execute SQL from the command line:
+
+~~~ shell
+$ cockroach-sql -e=";" -e=""
+~~~
+~~~ shell
+$ echo ";" | cockroach-sql
+~~~
+~~~ shell
+$ cockroach-sql -f file-containing-statements.sql
+~~~
+
+Exit the interactive SQL shell:
+
+~~~ sql
+> \q
+~~~
+
+View help:
+
+~~~ shell
+$ cockroach-sql --help
+~~~
+
+## Flags
+
+The `sql` command supports the following types of flags:
+
+- [General Use](#general)
+- [Client Connection](#client-connection)
+- [Logging](#logging)
+
+### General
+
+- To start an interactive SQL shell, run `cockroach-sql` with all appropriate connection flags or use just the [`--url` flag](#sql-flag-url), which includes [connection details](connection-parameters.html#connect-using-a-url).
+- To execute SQL statements from the command line, use the [`--execute` flag](#sql-flag-execute).
+
+Flag | Description
+-----|------------
+`--database``` | Read SQL statements from ``.
+``` | Read SQL statements from ``.
+`--file `` | Read SQL statements from ``.
-row chick turtle
-1 🐥 🐢
-1 row
-~~~
-
-When piping output to another command or a file, `--format` defaults to `tsv`:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---execute="SELECT '🐥' AS chick, '🐢' AS turtle" > out.txt \
---user=maxroach \
---host=12.345.67.89 \
---database=critterdb
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cat out.txt
-~~~
-
-~~~
-1 row
-chick turtle
-🐥 🐢
-~~~
-
-However, you can explicitly set `--format` to another format, for example, `table`:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---format=table \
---execute="SELECT '🐥' AS chick, '🐢' AS turtle" > out.txt \
---user=maxroach \
---host=12.345.67.89 \
---database=critterdb
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cat out.txt
-~~~
-
-~~~
- chick | turtle
---------+---------
- 🐥 | 🐢
-(1 row)
-~~~
-
-### Show borders around the statement output within the SQL shell
-
-To display outside and inside borders in the statement output, set the `border` [SQL shell option](#client-side-options) to `3`.
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-\set border=3
-SELECT * FROM animals;
-~~~
-
-~~~
-+--------------------+----------+
-| id | name |
-+--------------------+----------+
-| 710907071259213825 | bobcat |
-+--------------------+----------+
-| 710907071259279361 | 🐢 |
-+--------------------+----------+
-| 710907071259312129 | barn owl |
-+--------------------+----------+
-~~~
-
-### Make the output of `SHOW` statements selectable
-
-To make it possible to select from the output of `SHOW` statements, set `--format` to `raw`:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---format=raw \
---user=maxroach \
---host=12.345.67.89 \
---database=critterdb
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> SHOW CREATE customers;
-~~~
-
-~~~
-# 2 columns
-# row 1
-## 14
-test.customers
-## 185
-CREATE TABLE customers (
- id INT NOT NULL,
- email STRING NULL,
- CONSTRAINT "primary" PRIMARY KEY (id ASC),
- UNIQUE INDEX customers_email_key (email ASC),
- FAMILY "primary" (id, email)
-)
-# 1 row
-~~~
-
-When `--format` is not set to `raw`, you can use the `display_format` [SQL shell option](#client-side-options) to change the output format within the interactive session:
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> \set display_format raw
-~~~
-
-~~~
-# 2 columns
-# row 1
-## 14
-test.customers
-## 185
-CREATE TABLE customers (
- id INT NOT NULL,
- email STRING NULL,
- CONSTRAINT "primary" PRIMARY KEY (id ASC),
- UNIQUE INDEX customers_email_key (email ASC),
- FAMILY "primary" (id, email)
-)
-# 1 row
-~~~
-
-### Execute SQL statements from a file
-
-In this example, we show and then execute the contents of a file containing SQL statements.
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cat statements.sql
-~~~
-
-~~~
-CREATE TABLE roaches (name STRING, country STRING);
-INSERT INTO roaches VALUES ('American Cockroach', 'United States'), ('Brownbanded Cockroach', 'United States');
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---user=maxroach \
---host=12.345.67.89 \
---database=critterdb \
--f statements.sql
-~~~
-
-~~~
-CREATE TABLE
-INSERT 2
-~~~
-
-### Run external commands from the SQL shell
-
-In this example, we use `\!` to look at the rows in a CSV file before creating a table and then using `\|` to insert those rows into the table.
-
-{{site.data.alerts.callout_info}}This example works only if the values in the CSV file are numbers. For values in other formats, use an online CSV-to-SQL converter or make your own import program.{{site.data.alerts.end}}
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> \! cat test.csv
-~~~
-
-~~~
-12, 13, 14
-10, 20, 30
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> CREATE TABLE csv (x INT, y INT, z INT);
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> \| IFS=","; while read a b c; do echo "insert into csv values ($a, $b, $c);"; done < test.csv;
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> SELECT * FROM csv;
-~~~
-
-~~~
- x | y | z
------+----+-----
- 12 | 13 | 14
- 10 | 20 | 30
-~~~
-
-In this example, we create a table and then use `\|` to programmatically insert values.
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> CREATE TABLE for_loop (x INT);
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> \| for ((i=0;i<10;++i)); do echo "INSERT INTO for_loop VALUES ($i);"; done
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> SELECT * FROM for_loop;
-~~~
-
-~~~
- x
------
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
-~~~
-
-### Edit SQL statements in an external editor
-
-In applications that use [GNU Readline](https://tiswww.case.edu/php/chet/readline/rltop.html) (such as [bash](https://www.gnu.org/software/bash/)), you can edit a long line in your preferred editor by typing `Ctrl-x Ctrl-e`. However, CockroachDB uses the BSD-licensed [libedit](https://thrysoee.dk/editline/), which does not include this functionality.
-
-If you would like to be able to edit the current line in an external editor by typing `C-x C-e` as in `bash`, do the following:
-
-1. Install the `vipe` program (from the [moreutils](https://joeyh.name/code/moreutils/) suite of tools).
-2. Edit your `~/.editrc` to add the following line, which takes advantage of the SQL client's ability to [run external commands](#run-external-commands-from-the-sql-shell):
-
- {% include_cached copy-clipboard.html %}
- ~~~
- cockroach:bind -s ^X^E '^A^K\\\| echo \"^Y\" | vipe\r'
- ~~~
-
-This tells libedit to translate `C-x C-e` into the following commands:
-
-1. Move to the beginning of the current line.
-2. Cut the whole line.
-3. Paste the line into your editor via `vipe`.
-4. Pass the edited file back to the SQL client when `vipe` exits.
-
-{{site.data.alerts.callout_info}}
-Future versions of the SQL client may opt to use a different back-end for reading input, in which case please refer to this page for additional updates.
-{{site.data.alerts.end}}
-
-### Allow potentially unsafe SQL statements
-
-The `--safe-updates` flag defaults to `true`. This prevents SQL statements that may have broad, undesired side-effects. For example, by default, we cannot use `DELETE` without a `WHERE` clause to delete all rows from a table:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure --execute="SELECT * FROM db1.t1"
-~~~
-
-~~~
- id | name
------+-------
- 1 | a
- 2 | b
- 3 | c
- 4 | d
- 5 | e
- 6 | f
- 7 | g
- 8 | h
- 9 | i
- 10 | j
------+-------
-(10 rows)
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure --execute="DELETE FROM db1.t1"
-~~~
-
-~~~
-Error: pq: rejected: DELETE without WHERE clause (sql_safe_updates = true)
-Failed running "sql"
-~~~
-
-However, to allow an "unsafe" statement, you can set `--safe-updates=false`:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure --safe-updates=false --execute="DELETE FROM db1.t1"
-~~~
-
-~~~
-DELETE 10
-~~~
-
-{{site.data.alerts.callout_info}}Potentially unsafe SQL statements can also be allowed/disallowed for an entire session via the sql_safe_updates session variable .{{site.data.alerts.end}}
-
-### Reveal the SQL statements sent implicitly by the command-line utility
-
-In this example, we use the `--execute` flag to execute statements from the command line and the `--echo-sql` flag to reveal SQL statements sent implicitly:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---execute="CREATE TABLE t1 (id INT PRIMARY KEY, name STRING)" \
---execute="INSERT INTO t1 VALUES (1, 'a'), (2, 'b'), (3, 'c')" \
---user=maxroach \
---host=12.345.67.89 \
---database=db1
---echo-sql
-~~~
-
-~~~
-# Server version: CockroachDB CCL f8f3c9317 (darwin amd64, built 2017/09/13 15:05:35, go1.8) (same version as client)
-# Cluster ID: 847a4ba5-c78a-465a-b1a0-59fae3aab520
-> SET sql_safe_updates = TRUE
-> CREATE TABLE t1 (id INT PRIMARY KEY, name STRING)
-CREATE TABLE
-> INSERT INTO t1 VALUES (1, 'a'), (2, 'b'), (3, 'c')
-INSERT 3
-~~~
-
-In this example, we start the interactive SQL shell and enable the `echo` shell option to reveal SQL statements sent implicitly:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---user=maxroach \
---host=12.345.67.89 \
---database=db1
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> \set echo
-~~~
-
-{% include_cached copy-clipboard.html %}
-~~~ sql
-> INSERT INTO db1.t1 VALUES (4, 'd'), (5, 'e'), (6, 'f');
-~~~
-
-~~~
-> INSERT INTO db1.t1 VALUES (4, 'd'), (5, 'e'), (6, 'f');
-INSERT 3
-
-Time: 2.426534ms
-
-> SHOW TRANSACTION STATUS
-> SHOW DATABASE
-~~~
-
-### Repeat a SQL statement
-
-Repeating SQL queries on a table can be useful for monitoring purposes. With the `--watch` flag, you can repeat the statements specified with a `--execute` or `-e` flag periodically, until a SQL error occurs or the process is terminated.
-
-For example, if you want to monitor the number of queries running on the current node, you can use `cockroach sql` with the `--watch` flag to query the node's `crdb_internal.node_statement_statistics` table for the query count:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --insecure \
---execute="SELECT SUM(count) FROM crdb_internal.node_statement_statistics" \
---watch 1m
-~~~
-
-~~~
- sum
--------
- 926
-(1 row)
- sum
---------
- 4227
-(1 row)
-^C
-~~~
-
-In this example, the statement is executed every minute. We let the process run for a couple minutes before terminating it with Ctrl+C.
-
-### Connect to a cluster listening for Unix domain socket connections
-
-To connect to a cluster that is running on the same machine as your client and is listening for [Unix domain socket](https://en.wikipedia.org/wiki/Unix_domain_socket) connections, [specify a Unix domain socket URI](connection-parameters.html#example-uri-for-a-unix-domain-socket) with the `--url` connection parameter.
-
-For example, suppose you start a single-node cluster with the following [`cockroach start-single-node`](cockroach-start-single-node.html) command:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach start-single-node --insecure --socket-dir=/tmp
-~~~
-
-~~~
-CockroachDB node starting at 2020-10-12 04:02:54.971369 +0000 UTC (took 1.3s)
-build: CCL v20.2.0 @ 2020/10/06 17:15:06 (go1.13.14)
-webui: http://Jesses-MBP-2:8080
-sql: postgresql://root@Jesses-MBP-2:26257?sslmode=disable
-RPC client flags: ./cockroach --host=Jesses-MBP-2:26257 --insecure
-socket: /tmp/.s.PGSQL.26257
-logs: /Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data/logs
-temp dir: /Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data/cockroach-temp805054895
-external I/O path: /Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data/extern
-store[0]: path=/Users/jesseseldess/Downloads/cockroach-v20.2.0-beta.4.darwin-10.9-amd64/cockroach-data
-storage engine: pebble
-status: initialized new cluster
-clusterID: 455ad71d-21d4-424a-87ad-8097b6b5b99f
-nodeID: 1
-~~~
-
-To connect to this cluster with a socket:
-
-{% include_cached copy-clipboard.html %}
-~~~ shell
-$ cockroach sql --url='postgres://root@?host=/tmp&port=26257'
-~~~
+{% include {{ page.version.version }}/sql/sql-examples.md %}
## See also