psql 클라이언트를 사용한 연결

MySQL | PostgreSQL | SQL Server

PostgreSQL 명령줄 클라이언트를 사용하여 Cloud SQL에 연결할 수 있습니다. 이 페이지에서는 클라이언트 머신에서 로컬로 실행되고 있거나 Compute Engine VM 또는 Cloud Shell에서 실행되고 있는 psql 클라이언트를 Cloud SQL 인스턴스에 연결하는 방법을 설명합니다.

참고: Windows에서는 psql 명령어를 실행하기 전에 다음 명령어를 입력하세요.
SET PGCLIENTENCODING=utf-8
chcp 65001

시작하기 전에

psql 클라이언트를 사용하여 Cloud SQL 인스턴스에 연결하려면 먼저 다음을 수행하세요.

Cloud SQL 인스턴스를 만들고 기본 사용자를 구성합니다.

인스턴스 만들기 및 기본 사용자 계정의 비밀번호 설정을 참조하세요.
원할 경우 Compute Engine VM 인스턴스를 만든 다음 SSH를 사용하여 인스턴스에 연결합니다.

VM 인스턴스 만들기 및 시작, SSH 연결 정보, RDP를 사용하여 Windows VM에 연결을 참조하세요.
인스턴스에 연결할 방법을 결정합니다.

연결 옵션 및 연결 옵션을 선택하는 방법은 연결 옵션 정보를 참조하세요.

로컬 머신 또는 Compute Engine VM에서 PostgreSQL 클라이언트 사용

psql 클라이언트를 사용하여 Cloud SQL 인스턴스에 연결하려면 다음 3가지 상위 작업을 수행해야 합니다.

클라이언트를 설치합니다.
Cloud SQL 인스턴스에 대한 액세스를 구성합니다.
Cloud SQL 인스턴스에 연결합니다.

클라이언트 설치

psql 클라이언트를 설치하려면 다음을 수행합니다.

Debian/Ubuntu

패키지 관리자에서 psql 클라이언트를 설치합니다.

sudo apt-get update
sudo apt-get install postgresql-client

CentOS/RHEL

패키지 관리자에서 psql 클라이언트를 설치합니다.

sudo yum install postgresql

openSUSE

패키지 관리자에서 psql 클라이언트를 설치합니다.

sudo zypper install postgresql

기타 플랫폼

PostgreSQL 다운로드 페이지에서 플랫폼에 맞는 PostgreSQL Core Distribution을 다운로드합니다.
Core Distribution에는 psql 클라이언트가 포함되어 있습니다.
다운로드 페이지의 안내에 따라 PostgreSQL 데이터베이스를 설치합니다.

Cloud SQL 인스턴스에 대한 액세스 구성

인스턴스에 대한 액세스를 구성하려면 다음 안내를 따르세요.

클라이언트 머신 또는 Compute Engine VM 인스턴스에서 내 IP는 무엇인가요?를 사용하여 클라이언트 머신의 IP 주소를 확인합니다.
IP 주소를 복사합니다.
Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
SQL 탐색 메뉴에서 연결을 선택합니다.
네트워킹 탭을 선택합니다.
승인된 네트워크 섹션에서 네트워크 추가를 클릭하고 클라이언트가 설치된 머신의 IP 주소를 입력합니다.
참고: 인스턴스의 IP 주소와 사용자가 승인한 psql 클라이언트 IP 주소 모두 IPv4여야 합니다.
완료를 클릭합니다. 그런 다음 페이지 하단에 있는 저장을 클릭하여 변경사항을 저장합니다.
SSL/TLS를 사용하거나 암호화 없이(SSL/TLS를 사용하지 않음) 인스턴스에 연결합니다.

암호화 없이 Cloud SQL 인스턴스에 연결

암호화 없이 연결하려면 인스턴스에 SSL 모드가 ALLOW_UNENCRYPTED_AND_ENCRYPTED로 설정되어 있어야 합니다. Google Cloud 콘솔에서 이에 해당하는 구성은 암호화되지 않은 네트워크 트래픽 허용입니다.

인스턴스의 SSL/TLS 구성에 대한 자세한 내용은 SSL/TLS 인증서 구성을 참조하세요.

인스턴스에 연결하려면 다음을 수행하세요.

클라이언트를 설치했으며 인스턴스에 대한 액세스를 구성했는지 확인합니다.

psql 클라이언트를 시작합니다.

psql "sslmode=disable dbname=postgres user=postgres hostaddr=INSTANCE_IP_ADDRESS"

비밀번호를 입력합니다.
psql 프롬프트가 표시됩니다.

SSL/TLS를 사용하여 Cloud SQL 인스턴스에 연결

SSL/TLS 및 기본 제공 인증을 사용하여 인스턴스에 연결하려면 다음 안내를 따르세요.

psql 클라이언트를 시작합니다.
```
psql "sslmode=require \
      hostaddr=INSTANCE_IP_ADDRESS \
      user=postgres dbname=DB_NAME"
   
```
예를 들면 다음과 같습니다.
```
psql "sslmode=require \
      hostaddr=203.12.34.56 \
      user=postgres dbname=postgres"
   
```
특히 둘 이상의 인스턴스에 연결하는 경우 연결 서비스 파일을 만들어 연결 매개변수를 관리할 수도 있습니다. 자세한 내용은 PostgreSQL 문서를 참조하세요.
비밀번호를 입력합니다. PostgreSQL이 SSL/TLS를 사용하는 동안 비밀번호 없는 연결을 지원하더라도 Cloud SQL에서는 비밀번호가 필수입니다.
연결 정보에서 암호화를 검색하여 연결이 암호화되었는지 확인할 수 있습니다.
```
SSL connection (cipher: ECDHE-RSA-AES128-GCM-SHA256, bits: 128)
```

SSL/TLS 및 클라이언트 인증서 확인을 사용하여 Cloud SQL 인스턴스에 연결

Cloud SQL 인스턴스의 ssl_mode가 TRUSTED_CLIENT_CERTIFICATE_REQUIRED로 구성된 경우 로그인할 때 확인된 클라이언트 ID도 제공해야 합니다.

클라이언트가 확인된 SSL/TLS 인증서를 사용하여 연결하려면 다음이 필요합니다.

client-cert.pem 파일의 클라이언트 공개 키 인증서
client-key.pem 파일의 클라이언트 비공개 키

또한 클라이언트가 상호 인증을 위해 서버 ID를 확인할 수 있게 하려면 서버 인증서 server-ca.pem을 지정합니다.

예를 들어 psql 클라이언트를 시작하려면 다음을 실행합니다.

   psql "sslmode=verify-ca sslrootcert=server-ca.pem \
      sslcert=client-cert.pem sslkey=client-key.pem \
      hostaddr=INSTANCE_IP_ADDRESS \
      user=postgres dbname=DB_NAME"

클라이언트 인증서와 해당 비공개 키가 없으면 새 클라이언트 인증서를 생성합니다.

Cloud Shell에서 클라이언트 사용

Cloud SQL 인스턴스에 연결하려면 다음을 수행합니다(공개 IP만 해당).

Google Cloud 콘솔로 이동합니다.
Google Cloud 콘솔로 이동
툴바 오른쪽에 있는 Cloud Shell 아이콘()을 클릭합니다.
Cloud Shell이 초기화되는 데 시간이 다소 걸립니다.
Cloud Shell 프롬프트에서 기본 제공 클라이언트를 사용하여 Cloud SQL 인스턴스에 연결합니다.
```
gcloud sql connect INSTANCE_ID \
--user=postgres
```
비밀번호를 입력합니다.

gcloud sql connect 명령어는 비공개 IP 또는 SSL/TLS를 사용한 Cloud SQL 인스턴스 연결을 지원하지 않습니다. 암호화로 연결하려면 Cloud Shell에서 프록시를 설치하고 사용합니다.

/home/USER 디렉터리에 프록시를 설치합니다(Linux 64비트).
gcloud CLI 인증을 사용하여 프록시를 시작합니다.
```
./cloud-sql-proxy INSTANCE_CONNECTION_NAME &
```
TCP 연결을 사용하여 데이터베이스에 연결합니다.
```
psql -U USERNAME --host=127.0.0.1
```

다음 단계

직접 사용해 보기

Google Cloud를 처음 사용하는 경우 계정을 만들어 실제 시나리오에서 Cloud SQL이 수행되는 방식을 평가할 수 있습니다. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Cloud SQL 무료로 사용해 보기