HOWTO · PostgreSQL
PostgreSQL에 로그인 및 인증
이 기사에서는 특정 PostgreSQL 데이터베이스에 액세스하기 위해 로그인하고 인증받는 방법을 독자에게 알려줍니다.
이 페이지의 내용
특정 PostgreSQL 데이터베이스에 연결하려면 필요에 따라 서버 호스트, 포트, 데이터베이스, 역할을 지정해 psql을 사용합니다. 로컬 연결은 운영 체제 계정의 기본값을 사용할 수 있지만, 원격 연결이나 암호 인증 연결에는 대개 명시적인 매개변수와 서버 인증 규칙이 필요합니다.
psql로 PostgreSQL에 연결하기
-h는 서버 호스트, -p는 포트, -U는 역할, -d는 데이터베이스를 지정합니다. 예를 들어 다음 명령으로 TCP 연결을 요청할 수 있습니다. psql -h localhost -p 5432 -U app_user -d products_db 기본 포트는 일반적으로 5432이지만, 서버가 다른 포트에서 수신하도록 설정될 수도 있습니다.
-U를 생략하면 psql은 일반적으로 운영 체제 계정 이름을 사용하고, -d를 생략하면 일반적으로 해당 역할 이름을 데이터베이스 이름으로 사용합니다. PGUSER, PGDATABASE, PGHOST 같은 환경 변수나 서비스 정의가 연결 설정을 제공할 수 있으며, 이로 인해 인수 없이 실행한 psql의 동작이 달라질 수 있습니다. 다른 기존 데이터베이스를 명시적으로 선택하면, 연결 전에 기본 이름과 일치하는 데이터베이스를 만들 필요는 없습니다.
로컬 Unix 도메인 소켓 연결과 TCP 연결에는 서로 다른 pg_hba.conf 규칙이 적용될 수 있습니다. local 규칙은 소켓 연결에 적용되고, host 규칙은 TCP에 적용됩니다. 따라서 클라이언트가 소켓으로 연결하는지 호스트를 지정하는지에 따라 같은 역할과 암호의 처리 방식이 달라질 수 있습니다. 인증이 예상대로 동작하지 않으면 서버 규칙과 선택한 연결 방식을 확인하세요.
애플리케이션 코드에서는 각 값이 별도의 인수로 전달되도록 인수를 명시적으로 구성하세요. 다음 Python 예제는 TCP 연결 요청을 준비하지만 PostgreSQL 서버에 접속하지는 않습니다.
이 예제를 실행하세요:
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
arguments = [
"psql",
"-h", "localhost",
"-p", "5432",
"-U", "app_user",
"-d", "products_db",
]
assert arguments[0] == "psql"
assert arguments[-1] == "products_db"
createuser와 createdb로 역할과 데이터베이스 만들기
로컬 PostgreSQL 설치에서는 관리자가 현재 운영 체제 계정에 해당하는 로그인 역할과 데이터베이스를 만들 수 있습니다. PostgreSQL 관리자 계정 이름이 postgres인 시스템에서는 sudo -u postgres createuser "$USER"를 실행해 역할을 만든 다음, 해당 운영 체제 계정으로 로그인한 상태에서 createdb를 실행하면 같은 이름의 데이터베이스가 생성됩니다. 이 명령에는 적절한 로컬 권한과 실행 중인 서버가 필요합니다. 애플리케이션 역할을 슈퍼유저로 만들 필요는 없습니다.
별도의 이름을 가진 데이터베이스를 원한다면 관리자가 createdb -O app_user products_db를 실행해 app_user를 소유자로 지정할 수 있습니다. 그런 다음 psql -d products_db -U app_user로 연결합니다. 역할이 이미 있어야 하며, 클라이언트는 해당 역할과 데이터베이스가 만들어진 서버 인스턴스에 연결해야 합니다. 명령줄 유틸리티도 PostgreSQL 환경 변수를 사용할 수 있으므로 여러 로컬 또는 원격 서버 중 어느 곳에 연결할지 혼동될 수 있다면 연결 옵션을 지정하세요.
SQL로 로그인 역할과 데이터베이스 만들기
다른 방법으로는 역할과 데이터베이스를 만들 권한이 있는 역할로 관리 데이터베이스에 연결한 뒤 CREATE ROLE app_user LOGIN; 및 CREATE DATABASE products_db OWNER app_user;를 실행할 수 있습니다. LOGIN은 해당 역할이 세션을 시작하도록 허용합니다. 데이터베이스 소유권은 새 데이터베이스에 대한 관리 권한을 부여하지만 슈퍼유저 권한을 부여하지는 않습니다. 암호 인증을 사용하려면 안전한 자격 증명 설정 절차로 암호를 지정하거나 psql에서 \password app_user를 사용하세요. 그러면 암호가 SQL 기록에 포함되지 않습니다. 실제 자격 증명을 스크립트나 예제에 넣지 마세요.
암호 인증을 사용하는 TCP 연결을 요청하려면 psql -h localhost -p 5432 -U app_user -d products_db를 실행합니다. 필요한 경우 psql이 암호를 묻습니다. 암호만으로 암호 인증이 보장되지는 않습니다. 해당 연결에 적용되는 pg_hba.conf 규칙이 연결을 허용하고 적절한 암호 인증 방식을 사용해야 하며, 서버도 TCP 연결을 받도록 설정되어 있어야 합니다. 실제 서버의 호스트나 포트가 이 로컬 개발 예제와 다르면 실제 값을 사용하세요.
인증 확인 및 일반적인 연결 오류 해결
연결한 뒤 프롬프트에 의도한 데이터베이스와 역할이 표시되는지 확인하세요. psql 프롬프트에서 \conninfo는 연결 정보를 보여 주고, SELECT current_user, current_database();는 현재 역할과 데이터베이스를 확인합니다. 이 방법으로 연결 자체는 성공했지만 대상이 잘못된 경우를 찾아낼 수 있습니다.
FATAL: role "david" does not exist와 같은 메시지는 연결된 서버에 david라는 역할이 없다는 뜻입니다. 인수 없이 psql을 실행했다면 해당 이름은 운영 체제 계정이나 연결 설정 재정의에서 비롯되었을 수 있습니다. 먼저 호스트, 포트, PGUSER를 확인한 다음 그 서버에 해당 역할이 있는지 확인하세요. 역할은 있지만 데이터베이스 연결에 실패한다면 PGDATABASE 또는 -d 값을 확인하고 데이터베이스가 존재하는지 살펴보세요. 암호 오류가 나면 암호와 적용되는 pg_hba.conf 규칙을 확인하세요. 연결 거부 오류가 나면 서버가 실행 중인지, 선택한 주소와 포트에서 수신 중인지, 클라이언트에서 접근할 수 있는지 확인하세요. PostgreSQL의 프롬프트와 진단 문구는 버전 및 설정에 따라 다르므로 예시는 고정된 출력이 아닌 대표적인 사례로 보세요.