177ddaca30
I've talked to at least a few teams that are directly querying the database over gsql and scraping its output. To mirror our gerrit stream-events output gsql can now produce its records as JSON objects, making them more suitable for machine consumption. Change-Id: Ib2812b60a5d77824a48d511c50f6d8c2b23c4190 Signed-off-by: Shawn O. Pearce <sop@google.com>
63 lines
1.4 KiB
Plaintext
63 lines
1.4 KiB
Plaintext
gerrit gsql
|
|
===========
|
|
|
|
NAME
|
|
----
|
|
gerrit gsql - Administrative interface to active database
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'ssh' -p <port> <host> 'gerrit gsql' \
|
|
[\--format \{PRETTY | JSON\}] \
|
|
[\-c QUERY]
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Provides interactive query support directly against the underlying
|
|
SQL database used by the host Gerrit server. All SQL statements
|
|
are supported, including SELECT, UPDATE, INSERT, DELETE and ALTER.
|
|
|
|
OPTIONS
|
|
-------
|
|
\--format::
|
|
Set the format records are output in. In PRETTY (the
|
|
default) records are displayed in a tabular output suitable
|
|
for reading by a human on a sufficiently wide terminal.
|
|
In JSON mode records are output as JSON objects using the
|
|
column names as the property names, one object per line.
|
|
|
|
-c::
|
|
Execute the single query statement supplied, and then exit.
|
|
|
|
ACCESS
|
|
------
|
|
Caller must be a member of the privileged 'Administrators' group.
|
|
|
|
SCRIPTING
|
|
---------
|
|
Intended for interactive use only, unless format is JSON.
|
|
|
|
EXAMPLES
|
|
--------
|
|
To manually correct a user's SSH user name:
|
|
|
|
====
|
|
$ ssh -p 29418 review.example.com gerrit gsql
|
|
Welcome to Gerrit Code Review v2.0.25
|
|
(PostgreSQL 8.3.8)
|
|
|
|
Type '\h' for help. Type '\r' to clear the buffer.
|
|
|
|
gerrit> update accounts set ssh_user_name = 'alice' where account_id=1;
|
|
UPDATE 1; 1 ms
|
|
gerrit> \q
|
|
Bye
|
|
|
|
$ ssh -p 29418 review.example.com gerrit flush-caches --cache sshkeys --cache accounts
|
|
====
|
|
|
|
GERRIT
|
|
------
|
|
Part of link:index.html[Gerrit Code Review]
|