psql - Azure Cosmos DB for PostgreSQL을 사용하여 클러스터에 연결
적용 대상: Azure Cosmos DB for PostgreSQL(PostgreSQL에 대한 Citus 데이터베이스 확장 기반)
이 빠른 시작에서는 Azure Cloud Shell에서 psql 연결 문자열을 사용하여 Azure Cosmos DB for PostgreSQL 클러스터에 연결하는 방법을 보여 줍니다.
필수 조건
- 활성 구독이 있는 Azure 계정. 계정이 없으면 무료 계정을 만듭니다.
- Azure Cosmos DB for PostgreSQL 클러스터 클러스터를 만들려면 Azure Portal에서 클러스터 만들기를 참조하세요.
연결
클러스터에 citus
라는 기본 데이터베이스가 있습니다. 데이터베이스에 연결하려면 연결 문자열 및 관리자 암호를 사용합니다.
Azure Portal의 클러스터 페이지에서 연결 문자열 메뉴 항목을 선택한 다음, psql 연결 문자열을 복사합니다.
psql 문자열은
psql "host=c-<cluster>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password={your_password} sslmode=require"
형식입니다. 호스트 이름은c.
로 시작합니다(예:c-mycluster.12345678901234.postgres.cosmos.azure.com
). 이 접두사는 클러스터의 코디네이터 노드를 나타냅니다. 기본값dbname
은citus
이며 클러스터 프로비전 시간에만 변경할 수 있습니다.user
는 클러스터에서 유효한 Postgres 역할일 수 있습니다.위쪽 메뉴 모음에서 Cloud Shell 아이콘을 선택하여 Azure Cloud Shell을 엽니다.
메시지가 표시되면 Cloud Shell 데이터를 저장할 Azure 구독을 선택합니다.
psql 연결 문자열을 셸에 붙여넣습니다.
연결 문자열에서
{your_password}
를 클러스터 암호로 바꾼 다음, Enter 키를 누릅니다.psql이 데이터베이스에 성공적으로 연결되면 새
citus=>
(또는 데이터베이스의 사용자 지정 이름) 프롬프트가 표시됩니다.psql (14.2, server 14.5) SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off) Type "help" for help. citus=>
테스트 쿼리를 실행합니다. 다음 명령을 psql 프롬프트에 붙여넣은 다음, Enter 키를 누릅니다.
SHOW server_version;
클러스터를 만드는 동안 선택한 PostgreSQL 버전과 일치하는 결과가 표시되어야 합니다. 예를 들면 다음과 같습니다.
server_version ---------------- 14.5 (1 row)
다음 단계
이제 클러스터에 연결했으므로 다음 단계는 테이블을 만들고 수평 스케일링을 위해 분할하는 것입니다.