USE

Changes the database on which queries run. SHOW USE points to the database that most recently is used with the USE command. RESET USE resets the used database. This means that if the database is not specified in the SQL, the objects are searched in the current database.

Syntax

USE database

Examples

Suppose there are two databases, dev and pdb. Let there be two tables t in the public schemas of each of the databases.

dev=# insert into dev.public.t values (1);
INSERT 0 1
dev=# insert into pdb.public.t values (2);
INSERT 0 1
-- USEd database is not set.
dev=# show use;
 Use Database
--------------

(1 row)
dev=> show search_path;
  search_path
---------------
 $user, public
(1 row)

dev=# select * from t;
 c
---
 1
(1 row)

-- Set the USEd database to query the tables in it.
dev=# use pdb;
USE
dev=# select * from t;
 id
----
  2
(1 row)

dev=# select * from public.t;
 id
----
  2
(1 row)

-- Reset the USEd database to again refer to objects in the connected database.
dev=# RESET USE;
RESET
dev=# select * from t;
 c
---
 1
(1 row)