윈도우 psql 접속 하는 방법

안녕하세요,  오늘은 윈도우 psql 접속에 대해 알아보겠습니다. psql은 PostgreSQL 데이터베이스 서버에 연결하고 쿼리를 실행할 수 있는 커맨드 라인 도구입니다. 윈도우에서 psql을 사용하려면 몇 가지 설정과 절차가 필요합니다. 이 글에서는 윈도우 psql 접속을 위한 환경 변수 설정, psql 명령어 사용법, psql 접속 오류 해결 방법을 자세히 설명해 드리겠습니다.

글의 목차

• 윈도우 psql 접속을 위한 환경 변수 설정
• 윈도우 psql 명령어 사용법
• 윈도우 psql 접속 오류 해결 방법

 

윈도우 psql 접속을 위한 환경 변수 설정 {#환경-변수-설정}

윈도우에서 psql을 사용하려면 PostgreSQL의 bin 폴더가 환경 변수에 등록되어 있어야 합니다. 환경 변수에 등록하면 명령 프롬프트에서 psql 명령어를 바로 실행할 수 있습니다. 환경 변수에 등록하지 않으면 PostgreSQL의 bin 폴더로 이동해야만 psql 명령어를 실행할 수 있습니다. 환경 변수에 PostgreSQL의 bin 폴더를 등록하는 방법은 다음과 같습니다.

1. 제어판 - 시스템 및 보안 - 시스템 - 고급 시스템 설정을 차례로 클릭합니다.
2. 고급 탭에서 환경 변수 버튼을 클릭합니다.
3. 시스템 변수 목록에서 Path를 선택하고 편집 버튼을 클릭합니다.
4. 새로 만들기 버튼을 클릭하고 PostgreSQL의 bin 폴더 경로를 입력합니다. PostgreSQL의 bin 폴더 경로는 PostgreSQL을 설치한 폴더 하위에 있습니다. 예를 들어, PostgreSQL을 C:\Program Files에 설치했다면 bin 폴더 경로는 C:\Program Files\PostgreSQL\11\bin이 됩니다. PostgreSQL의 버전에 따라 경로가 다를 수 있으므로 주의하세요.
5. 확인 버튼을 눌러 환경 변수 설정을 완료합니다.

이렇게 하면 윈도우에서 psql을 사용할 수 있습니다. 환경 변수 설정이 제대로 되었는지 확인하려면 명령 프롬프트를 열고 psql --version 명령어를 입력해보세요. PostgreSQL의 버전 정보가 출력되면 성공적으로 설정된 것입니다.

윈도우 psql 명령어 사용법 {#명령어-사용법}

윈도우에서 psql 명령어를 사용하려면 명령 프롬프트를 열고 다음과 같은 형식으로 입력해야 합니다.

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

• -h 옵션은 PostgreSQL 서버가 실행되고 있는 호스트명이나 IP 주소를 지정합니다. 로컬 컴퓨터에 PostgreSQL 서버가 설치되어 있다면 -h 옵션을 생략할 수 있습니다.
• -p 옵션은 PostgreSQL 서버가 사용하는 포트번호를 지정합니다. 기본값은 5432입니다. 기본값을 사용한다면 -p 옵션을 생략할 수 있습니다.
• -U 옵션은 PostgreSQL 서버에 접속할 사용자명을 지정합니다. PostgreSQL을 설치할 때 생성한 슈퍼유저 postgres를 사용할 수 있습니다. 다른 사용자를 생성했다면 해당 사용자명을 입력해야 합니다.
• -d 옵션은 PostgreSQL 서버에 접속할 데이터베이스명을 지정합니다. PostgreSQL을 설치할 때 생성한 기본 데이터베이스 postgres를 사용할 수 있습니다. 다른 데이터베이스를 생성했다면 해당 데이터베이스명을 입력해야 합니다.

옵션을 모두 입력하고 엔터키를 누르면 비밀번호를 입력하라는 메시지가 나타납니다. 사용자명에 해당하는 비밀번호를 입력하면 psql 쉘에 접속할 수 있습니다. psql 쉘에서는 다양한 명령어를 사용할 수 있습니다. 명령어는 보통 SQL 문법을 따르며, 세미콜론(;)으로 끝나야 합니다. 예를 들어, 데이터베이스의 버전 정보를 확인하려면 다음과 같이 입력합니다.

SELECT version();

psql 쉘에서는 백슬래시()로 시작하는 메타 명령어도 사용할 수 있습니다. 메타 명령어는 SQL 문법을 따르지 않으며, 세미콜론(;)으로 끝나지 않아도 됩니다. 예를 들어, 데이터베이스의 목록을 확인하려면 다음과 같이 입력합니다.

\l

psql 쉘에서 사용할 수 있는 명령어와 메타 명령어의 목록은 다음과 같습니다.

명령어	설명
psql -?	psql의 옵션 목록과 도움말을 보여줍니다.
psql -U username -d database -c ‘query’	psql 쉘에 접속하지 않고 쿼리를 실행합니다.
psql -U username -d database -f ‘filename’	psql 쉘에 접속하지 않고 파일에 저장된 쿼리를 실행합니다.
\l	데이터베이스의 목록을 보여줍니다.
\c database	데이터베이스를 변경합니다.
\d	테이블, 인덱스, 시퀀스, 뷰 등의 목록을 보여줍니다.
\d table	테이블의 구조를 보여줍니다.
\dt	테이블의 목록을 보여줍니다.
\di	인덱스의 목록을 보여줍니다.
\ds	시퀀스의 목록을 보여줍니다.
\df	함수의 목록을 보여줍니다.
\dv	뷰의 목록을 보여줍니다.
\du	사용자의 목록을 보여줍니다.
\h	SQL 명령어의 도움말을 보여줍니다.
?	메타 명령어의 도움말을 보여줍니다.
\q	psql 쉘을 종료합니다.

윈도우 psql 접속 오류 해결 방법 {#접속-오류-해결}

윈도우에서 psql 접속을 시도할 때 다음과 같은 오류가 발생할 수 있습니다.

psql: error: could not connect to server: could not connect to server: No such file or directory Is the server running locally and accepting connections on Unix domain socket “/tmp/.s.PGSQL.5432”?

이 오류는 PostgreSQL 서버가 실행되고 있지 않거나, 포트번호가 잘못되었을 때 발생합니다. PostgreSQL 서버가 실행되고 있는지 확인하려면 다음과 같이 입력합니다.

pg_ctl status

이 명령어는 PostgreSQL 서버의 상태를 보여줍니다. PostgreSQL 서 서버가 실행되고 있다면 다음과 같은 메시지가 나타납니다.

pg_ctl: server is running (PID: 1234) C:/Program Files/PostgreSQL/11/bin/postgres.exe “-D” “C:/Program Files/PostgreSQL/11/data”

서버가 실행되고 있지 않다면 다음과 같은 메시지가 나타납니다.

pg_ctl: no server running

서버가 실행되고 있지 않다면 서버를 시작하려면 다음과 같이 입력합니다.

pg_ctl start

이 명령어는 PostgreSQL 서버를 시작합니다. 서버가 시작되면 다음과 같은 메시지가 나타납니다.

waiting for server to start… done server started

서버가 실행되고 있음에도 불구하고 접속 오류가 발생한다면 포트번호가 잘못되었을 가능성이 있습니다. PostgreSQL 서버가 사용하는 포트번호를 확인하려면 다음과 같이 입력합니다.

pg_ctl status -D “C:/Program Files/PostgreSQL/11/data”

이 명령어는 PostgreSQL 서버의 상세한 상태를 보여줍니다. 포트번호는 다음과 같은 부분에 나타납니다.

pg_ctl: server is running (PID: 1234) C:/Program Files/PostgreSQL/11/bin/postgres.exe “-D” “C:/Program Files/PostgreSQL/11/data” -p 5432

포트번호가 5432가 아니라면 psql 명령어에 -p 옵션으로 올바른 포트번호를 입력해야 합니다. 예를 들어, 포트번호가 5433이라면 다음과 같이 입력합니다.

psql -h localhost -p 5433 -U postgres -d postgres

이렇게 하면 윈도우 psql 접속 오류를 해결할 수 있습니다. psql 접속 오류는 PostgreSQL 서버의 실행 여부와 포트번호를 확인하고 조절하면 대부분 해결됩니다. 만약 다른 오류가 발생한다면 PostgreSQL의 공식 문서나 인터넷을 참고하세요.

요약 및 마무리 {#요약-및-마무리}

이 글에서는 윈도우 psql 접속을 위한 환경 변수 설정, psql 명령어 사용법, psql 접속 오류 해결 방법을 소개하였습니다. 윈도우에서 psql을 사용하려면 PostgreSQL의 bin 폴더가 환경 변수에 등록되어 있어야 하고, psql 명령어에는 호스트명, 포트번호, 사용자명, 데이터베이스명을 옵션으로 입력해야 합니다. psql 접속 오류는 PostgreSQL 서버의 실행 여부와 포트번호를 확인하고 조절하면 대부분 해결됩니다. psql 쉘에서는 SQL 명령어와 메타 명령어를 사용할 수 있습니다.

이 글이 여러분들에게 도움이 되었으면 좋겠습니다. 다음에도 유용한 정보를 전달해 드리겠습니다. 좋아요와 구독은 저에게 큰 힘이 됩니다. 감사합니다.