Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/soheilpro/pgcmd
Non-interactive PostgreSQL query tool.
https://github.com/soheilpro/pgcmd
postgres postgresql psql
Last synced: 27 days ago
JSON representation
Non-interactive PostgreSQL query tool.
- Host: GitHub
- URL: https://github.com/soheilpro/pgcmd
- Owner: soheilpro
- License: mit
- Created: 2019-08-21T16:34:15.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-08T15:39:14.000Z (almost 2 years ago)
- Last Synced: 2024-09-28T18:05:03.839Z (about 1 month ago)
- Topics: postgres, postgresql, psql
- Language: JavaScript
- Homepage:
- Size: 15.6 KB
- Stars: 117
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pgcmd
Non-interactive PostgreSQL query tool.
By default, it outputs JSON which means that you can process and view the results with tools like [jq](https://stedolan.github.io/jq/manual) or [catj](https://github.com/soheilpro/catj).
## Install
```
npm install -g pgcmd
```
## Usage
```
pgcmd -h localhost \
-u postgres \
-p p@ssw0rd \
-d postgres \
'select * from pg_database where datname = $1' \
-m template0
```
If no script is specified, pgcmd reads from the standard input:
```
echo 'select * from pg_database where datname = $1' | pgcmd -m template0
```
Output:
```
[
{
"datname": "template0",
"datdba": 10,
"encoding": 6,
"datcollate": "en_US.utf8",
"datctype": "en_US.utf8",
"datistemplate": true,
"datallowconn": false,
"datconnlimit": -1,
"datlastsysoid": 13066,
"datfrozenxid": "562",
"datminmxid": "1",
"dattablespace": 1663,
"datacl": "{=c/postgres,postgres=CTc/postgres}"
}
]
```
It can also output CSV:
```
pgcmd 'select * from pg_database' --csv
```
Output:
```
datname,datdba,encoding,datcollate,datctype,datistemplate,datallowconn,datconnlimit,datlastsysoid,datfrozenxid,datminmxid,dattablespace,datacl
postgres,10,6,en_US.utf8,en_US.utf8,,1,-1,13066,562,1,1663,
template1,10,6,en_US.utf8,en_US.utf8,1,1,-1,13066,562,1,1663,"{=c/postgres,postgres=CTc/postgres}"
template0,10,6,en_US.utf8,en_US.utf8,1,,-1,13066,562,1,1663,"{=c/postgres,postgres=CTc/postgres}"
```
## Environment Variables
The following environment variables are supported:
- PGHOST
- PGPORT
- PGUSER
- PGPASSWORD
- PGDATABASE
## Version History
+ **1.2**
+ Removed the default timeout.
+ **1.1**
+ Added `--csv` output option.
+ Added support for Node 14. (Thanks [darky](https://github.com/darky))
+ Set exit code on errors. (Thanks [darky](https://github.com/darky))
+ **1.0**
+ Initial release.
## Author
**Soheil Rashidi**
+ http://soheilrashidi.com
+ http://twitter.com/soheilpro
+ http://github.com/soheilpro
## Copyright and License
Copyright 2020 Soheil Rashidi.
Licensed under the The MIT License (the "License");
you may not use this work except in compliance with the License.
You may obtain a copy of the License in the LICENSE file, or at:
http://www.opensource.org/licenses/mit-license.php
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.