[PostgreSQL] docker 를 이용한 PostgreSQL (psql) 튜토리얼

# docker run --name [컨테이너명] -e [환경변수키=환경변수값] -d -p [포트바인딩] [이미지명]

docker run --name postgres-0 -e POSTGRES_PASSWORD=password -d -p 5432:5432 postgres:alpine
Bash
복사

옵션은 아래와 같다.

•

--name : 컨테이너 이름을 명시하는 옵션

•

-e : 컨테이너의 환경변수를 설정하는 옵션. 여기서는 POSTGRES_PASSWORD=password 환경변수를 설정했다.

•

-d : 컨테이너가 detached 모드로 실행되어서 백그라운드에서 동작하게 된다.

•

-p : 호스트 포트와 컨테이너 포트를 바인딩하는 옵션 ( 호스트 5432 포트 → 컨테이너 5432 포트)

참고자료

컨테이너 실행 결과 창 (-d 옵션으로 구동시켰기 때문에 백그라운드로 실행되고 터미널엔 컨테이너 id 만 출력된다)

DB 접속

1. 도커 컨테이너로 직접 접속

실행되고 있는 컨테이너에 직접 접속해서 bash 쉘 실행

# docker exec -it [컨테이너명] bash

docker exec -it postgres-0 bash
Bash
복사

# psql -h {호스트명} -p {포트 번호} -U {사용자명} -d {데이터베이스명}

psql -U postgres
Bash
복사

로컬에 있는 postgreSQL 서버는 호스트명, 포트번호 를 생략 가능하다.

그리고 사용자명과 데이터베이스명이 같으면 데이터베이스명 또한 생략 가능하다.

따라서 psql -U postgres 만으로도 접속이 가능하다.

(도커 이미지로 다운 받은 postgreSQL 의 디폴트 사용자명과 데이터베이스명은 둘 다 postgre 이다.)

접속화면

2. 로컬에서 접속

컨테이너외부포트(로컬 포트) 과 컨테이너내부포트(컨테이너 포트) 를 이용하여 로컬에서 접속한다.

컨테이너를 실행할 때 5432:5432 로 포트바인딩 시켰으므로 로컬에서 5432 로 접속하면 컨테이너의 5432 포트로 접속된다.

psql -h localhost -p 5432 -U postgres
Bash
복사

이 때 만약 로컬의 5432 에서 돌아가는 기존의 postgreSQL 이 있다면 프로세스 종료를 시켜주어야 한다. (포트 충돌남)

brew services stop postgresql # 로컬에서 구동중인 postgreSQL 중지
Bash
복사

도커 컨테이너로 띄워진 postgreSQL 에 접속한 모습

psql 기본 명령어

GUI 툴로도 DB 를 조작할 수 있지만 CLI 로 postgreSQL 를 다루기 위해서는 psql (postgreSQL 쉘) 을 사용한다.

psql 은 커맨드 앞에 \ 를 붙힌다.

psql 도움말 : \?

postgres=# \?
Bash
복사

sql 도움말 : \h

도움말 목록 보기

postgres=# \h

# 또는 postgres=# \help
Bash
복사

특정 SQL 도움말 보기

\h 에 나온 쿼리들을 두 번째 인자로 넘겨주면 특정 SQL 에 대한 도움말을 볼 수 있다.

# select 에 대한 도움말

postgres=# \h select
Bash
복사

유저 목록 조회 : \du

postgres=# \du
Bash
복사

데이터베이스 명령어

데이터베이스 생성 : create database {데이터베이스명}

# create database {데이터베이스명}

postgres=# create database testdb;
Bash
복사

데이터베이스 목록 조회 : \l

postgres=# \l

# 또는 postgres=# \list

List of databases
   Name    |  Owner   | Encoding |  Collate   |   Ctype    |   Access privileges
-----------+----------+----------+------------+------------+-----------------------
 postgres  | postgres | UTF8     | en_US.utf8 | en_US.utf8 |
 template0 | postgres | UTF8     | en_US.utf8 | en_US.utf8 | =c/postgres          +
           |          |          |            |            | postgres=CTc/postgres
 template1 | postgres | UTF8     | en_US.utf8 | en_US.utf8 | =c/postgres          +
           |          |          |            |            | postgres=CTc/postgres
 testdb    | postgres | UTF8     | en_US.utf8 | en_US.utf8 |
(4 rows)
Bash
복사

데이터베이스 사용(접속) : \c

# postgres=# \c [데이터베이스명]

# testdb 데이터베이스를 사용

postgres=# \c testdb
psql (14.6 (Homebrew), server 15.1)
WARNING: psql major version 14, server major version 15.
         Some psql features might not work.
You are now connected to database "testdb" as user "postgres".
testdb=#
Bash
복사

스키마 명령어

postgreSQL 은 데이터베이스 > 스키마 > 테이블의 계층구조를 가진다.

MySQL 에서 데이터베이스 == 스키마 인 것과 대조적이다.

•

postgreSQL 에서는 데이터베이스 안에 스키마를 만들고, 스키마 안에 테이블을 생성함

•

디폴트로 public 스키마가 존재하고, 별도의 명령을 하지 않고 테이블을 만들게 되면 이 public 스키마 안에 테이블이 생성됨

스키마 조회 : \dn

testdb=# \dn
      List of schemas
  Name  |       Owner
--------+-------------------
 public | pg_database_owner
(1 row)
Bash
복사

데이터베이스 안에 디폴트 스키마로 public 이 존재한다.

스키마 생성 : create schema {스키마명}

testdb=# create schema myschema;
CREATE SCHEMA

# 제대로 생성되었는지 스키마 조회
testdb=# \dn
       List of schemas
   Name   |       Owner
----------+-------------------
 myschema | postgres
 public   | pg_database_owner
(2 rows)
Bash
복사

스키마명 수정 : ALTER SCHEMA {name} RENAME TO {new_name}

testdb=# \dn
       List of schemas
   Name   |       Owner
----------+-------------------
 myschema | postgres
 public   | pg_database_owner
(2 rows)

testdb=# alter schema myschema rename to ourschema;
ALTER SCHEMA

testdb=# \dn
        List of schemas
   Name    |       Owner
-----------+-------------------
 ourschema | postgres
 public    | pg_database_owner
(2 rows)
Bash
복사

myschema → ourschema 로 스키마명 변경

스키마 삭제 : DROP SCHEMA [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]

testdb=# \dn
        List of schemas
   Name    |       Owner
-----------+-------------------
 ourschema | postgres
 public    | pg_database_owner
(2 rows)

testdb=# drop schema ourschema;
DROP SCHEMA

testdb=# \dn
      List of schemas
  Name  |       Owner
--------+-------------------
 public | pg_database_owner
(1 row)
Bash
복사