A PostgreSQL Command line, in general, is a software program. We execute a command line on a command line interface (CLI) to interact directly with data on a database. Although a Graphical User Interface (GUI) provides a much better user experience, PostgreSQL CLI acts vital when managing applications or operating systems with greater control, reliability, and conventionality.

PostgreSQL is an RDBMS (Relational Database Management System) that allows effortless and secured data collection. Today, PostgreSQL is used as the primary data storage repository (as a data warehouse) for many websites, mobile and analytics applications. And, you would have noticed (when you were installing the PostgreSQL database server) some tools that offer data professionals with a high understanding of SQL a seamless way to manage databases in PostgreSQL using command lines.

The tools are known as an interactive terminal program — psql and pgAdmin.

  1. psql: A terminal-based front-end to PostgreSQL database server.
  2. pgAdmin: A web-based front-end to PostgreSQL database server.

We can use psql (terminal or command line) and pgAdmin connection tool to connect our PostgreSQL database and manage it, too.

This tutorial article will explain how to use the interactive terminal programs to connect and manage your PostgreSQL database in the Command Line Interface.

What is PostgreSQL?

PostgreSQL is an open-source relational database management system (RDBMS). PostgreSQL, with its top-of-the-class performance optimization and advanced datatypes features, has made a name for itself in the data community. Thanks to its feature-rich suite experience, robust and reliable performance, PostgreSQL has become the preferred choice, ranking as the 4th most popular database management system worldwide.

PostgreSQL operates flawlessly with all major operating systems like Linux, Windows, and Mac OS. The fact that PostgreSQL offers multi-application interoperability, the platform provides its users with an advantage to manage their databases with a high degree of control and flexibility.

Some key features of PostgreSQL are as follows:

  • It’s open-source, hence free: PostgreSQL is an open-source RDBMS which makes it suitable for a young team of developers. Moreover, it’s easy to download and compatible with all major operating systems.
  • It’s known for its diverse user base: Apple, Cisco, Etsy, Facebook, Instagram, Red Hat, Skype, Spotify, and Yahoo all have one thing in common, all leverage PostgreSQL for their everyday database needs. 
  • It’s highly reliable and compatible with multiple data types: PostgreSQL’s write-ahead logging makes it a highly fault-tolerant database. Moreover, high compatibility with multiple data types makes its use cases synonymous with today’s data professionals’ pain points, making it the de-facto solution.

And, it’s secure too: PostgreSQL offers a robust access control system and follows all major security compliance frameworks. To include a few, PostgreSQL is LDAP, GSSAPI, SSPI, etc. compliant. Learn more.

How to Connect to a Database in PostgreSQL Command line (CLI)

Now, to get started with psql Connect to database command line you, first have to install PostgreSQL, After installing PostgreSQL, launch psql and enter the following command in the Postgresql CLI.

psql -h <hostname> -p <port> -U <username> -d <database>

Replace <hostname>, <port>, <username>, and <database> with your specific values.

  • -h: Specifies the host where the PostgreSQL server is running. Use localhost if it’s on the same machine.
  • -p: Specifies the port number. The default is 5432.
  • -U: Specifies the username you want to connect with.
  • -d: Specifies the name of the database to connect to.


psql -h localhost -p 5432 -U myusername -d mydatabase

You’ll be prompted to enter a password if the PostgreSQL server requires it.

How to Create a Database

To create a database using the PostgreSQL CLI, use the following command:

CREATE DATABASE database_name;



List All Databases

To get a list of all the databases using the PostgreSQL CLI, enter the \l prompt.

postgres=# \l
PostgreSQL CLI: List all Databases
Image Source

If you wish to get information for a particular database, enter the \l prompt in the PostgreSQL CLI, followed by the database name.

postgres=# \l books_db

postgres=# \l
                                  List of databases
   Name    |  Owner   | Encoding |          Collate    |          Ctype       |  
 books_db | postgres | UTF8     | English_Ireland.1252 | English_Ireland.1252 |

Additonally, using \l+ prompt will display additional information such as the size and the tablespace in the database.

PostgreSQL CLI: l+ prompt
Image Source

Command to Switch Databases

You remain connected to the default postgres database, to switch the database, enter the following command in the PostgreSQL CLI:

\c database_name


\c books_db
PostgreSQL CLI: switching database
Image Source

How to List Database Tables

If you want to list all the tables of a database, use the \dt command. For example, in the database tutorials_db, you can see the following tables:

PostgreSQL CLI: database tables
Image Source

How to describe a Table?

psql also has a command that helps you to describe the table.

\d <table-name>

// example
\d tutorials
PostgreSQL CLI: describe a table

How to Rename a Table?

You can change the name of a table by using the following PostgreSQL Command Line:

ALTER TABLE table_name RENAME TO new_table_name;

How to Delete a Database

To delete a database, use the DROP DATABASE command.

DROP DATABASE database_name;

You will get an error if you try to delete a database that does not exist; use IF EXISTS to get a notice.

PostgreSQL Command Line: Deleting a Database

How to Quit psql?

You can quit the PostgreSQL CLI using the \q command.

Connect Using pgAdmin in PostgreSQL Command line

Used as a graphical tool in PostgreSQL to manage databases, pgAdmin is a web-based front-end to PostgreSQL database server. To access the database using pgAdmin, first, you will need to install and configure the latest version of your browser and create a new pgAdmin user account. An email and a password are required to authenticate access.

python /usr/lib/python2.7/site-packages/pgadmin4-web/setup.py

After the authentication process is complete, you can access the phAdmin 4 interface using the command line given below:




Now, use the email and password created previously to authenticate the user. Now, the user interface will load and now you would need to navigate as shown in the image below. (Servers>Create>Server)

PostgreSQL Command line | pgAdmin Connect to Database Command Line

Under the “Create – Server” section, the General and Connection tabs will now be used to enter values such as server name and user credentials for the database.

PostgreSQL Command line | pgAdmin Connect to Database Command Line

Now that the connection to your database has been established, the following interface will provide an overview of the user’s databases. You can execute queries by clicking on Tools > Query Tool or by pressing ALT + Shift + Q.

PostgreSQL Command line | pgAdmin Connect to Database Command Line


Let’s conclude. Through this PostgreSQL command line tutorial article, we provided two ways to connect to the database command line. First, by using the psql method, and second, by using the pgAdmin method. And if you need to learn more on the subject, either of these two articles can help.

  1. Documentation for pgAdmin and psql connect to database command line in PostgreSQL 8.4
  2. Documentation for pgAdmin and psql connect to database command line in PostgreSQL 9.1

Here are some essential reads for a deeper dive into PostgreSQL functionalities:

  1. PostgreSQL date_part: Syntax & 7 Use Cases Simplified
  2. PostgreSQL SELECT Statement: Syntax & Example Queries | A 101 Guide
  3. PostgreSQL TRIM() Function: Syntax & Practical Examples | A 101 Guide

On that note, extracting and managing complex data, from a diverse set of data sources can be a challenging task and this is where Hevo can help!

Hevo Data offers a faster way to move data from Databases or SaaS applications into your Data Warehouse to be visualized in a BI tool. Hevo is fully automated and hence does not require you to code.

Visit our Website to Explore Hevo

Hevo Data will automate your data transfer process, hence allowing you to focus on other aspects of your business like Analytics, Customer Management, etc. Hevo is the only real-time ELT No-code Data Pipeline platform that cost-effectively automates data pipelines that are flexible to your needs. With integration with 150+ Data Sources (40+ free sources), we help you not only export data from sources & load data to the destinations but also transform & enrich your data, & make it analysis-ready.

Want to take Hevo for a spin? Sign Up for a 14-day free trial and experience the feature-rich Hevo suite first hand

You can also have a look at our unbeatable pricing that will help you choose the right plan for your business needs!

Yash Arora
Former Content Manager, Hevo Data

Yash is a Content Marketing professinal with experience in data-driven marketing campaigns. He has expertise in strategic thinking, integrated marketing, and customer acquisition. She has driven growth for startups and established brands through comprehensive marketing communications, and digital strategies.

No-code Data Pipeline For Your Data Warehouse