이 페이지는 Cloud Translation API를 통해 번역되었습니다.

인스턴스에 psql 클라이언트 연결

이 페이지에서는 psql 클라이언트 도구를 AlloyDB 인스턴스에 연결하는 방법을 설명합니다.

psql를 AlloyDB 인스턴스에 연결하는 절차에는 다음 작업이 포함됩니다.

이 작업 중 처음 두 가지는 일회성 작업입니다. Compute Engine VM을 만들고 여기에 psql 클라이언트를 설치한 후에는 VM을 계속 사용하여 나머지 작업을 실행하여 psql를 AlloyDB 인스턴스에 연결할 수 있습니다.

시작하기 전에

사용 중인 Google Cloud 프로젝트가 AlloyDB에 액세스하도록 사용 설정되어 있어야 합니다.
사용 중인 Google Cloud 프로젝트의 VPC 네트워크가 이미 AlloyDB에 대한 비공개 서비스 액세스를 위해 구성되어 있어야 합니다.
사용 중인 Google Cloud 프로젝트에 다음 IAM 역할 중 하나가 있어야 합니다.
- roles/alloydb.admin (AlloyDB 관리자가 사전 정의한 IAM 역할)
- roles/owner(소유자 기본 IAM 역할)
- roles/editor(편집자 기본 IAM 역할)
이러한 역할이 없는 경우 조직 관리자에게 문의하여 액세스 권한을 요청하세요.
클라이언트 호스트에 방화벽이 있는 경우 AlloyDB 인스턴스의 IP 주소에서 포트 5432로 나가는 연결을 허용해야 합니다.

Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

VM 인스턴스로 이동
연결하려는 AlloyDB 인스턴스가 포함된 프로젝트를 선택합니다.
인스턴스 만들기를 클릭합니다.
머신 구성 섹션을 클릭합니다.
인스턴스의 이름을 입력합니다.
인스턴스를 만들 리전과 영역을 구성합니다.
머신 시리즈 및 해당 머신 유형을 선택합니다.
OS 및 저장용량 섹션의 기본값을 그대로 둡니다.
네트워킹 섹션을 클릭하고 네트워크 인터페이스를 AlloyDB에 대한 비공개 서비스 액세스에 구성된 VPC 네트워크로 설정합니다.
네트워크 인터페이스가 비공개 서비스 액세스에 구성된 VPC 네트워크로 설정되어 있지 않으면 펼친 후 네트워크를 VPC 네트워크로 설정합니다.
관측 가능성 섹션의 기본값을 유지합니다.
보안 섹션을 클릭합니다.
ID 및 API 액세스에서 액세스 범위를 모든 Cloud API에 대한 전체 액세스 허용으로 설정합니다.
고급 섹션의 기본값을 유지합니다.
만들기를 클릭합니다.

VM이 생성된 후 SSH를 사용하여 만든 Compute Engine VM에 연결합니다.

SSH를 사용하여 만든 Compute Engine VM에 연결합니다.
기본적으로 Compute Engine VM에 대한 SSH 연결은 Identity-Aware Proxy를 사용합니다. 조직의 네트워킹 정책에 따라 VM에 대한 트래픽을 허용하기 위해 인그레스 방화벽 규칙을 만들어야 할 수 있습니다.
콘솔
1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.
  VM 인스턴스로 이동
2. 가상 머신 인스턴스 목록에서 만든 인스턴스 행에서 SSH를 클릭합니다.
gcloud

gcloud compute ssh 명령어를 사용하여 만든 인스턴스에 연결합니다.
```
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
```
다음을 바꿉니다.
- PROJECT_ID: 인스턴스가 포함된 프로젝트의 ID입니다.
- ZONE: 인스턴스가 있는 영역의 이름입니다.
- VM_NAME: 인스턴스 이름입니다.
패키지 관리자에서 psql 클라이언트를 설치합니다.
```
sudo apt-get update
sudo apt-get install postgresql-client
```

연결하려는 AlloyDB 인스턴스의 IP 주소를 가져오려면 해당 인스턴스의 설정을 확인합니다.