Set up docs MCP연결 정보 확인하기
애플리케이션을 ClickHouse Managed Postgres에 연결하려면 인스턴스 왼쪽 사이드바의 Connect 보기로 이동하십시오.
Connect를 클릭하면 여러 포맷의 연결 자격 증명과 연결 문자열을 표시하는 모달이 열립니다.
연결 모달에는 다음 정보가 표시됩니다.
- Username: 데이터베이스 사용자(기본값:
postgres) - Password: 데이터베이스 비밀번호(기본적으로 마스킹되며, 눈 아이콘을 클릭하면 표시됩니다)
- Server: ClickHouse Managed Postgres 인스턴스의 호스트명
- Port: PostgreSQL 포트(기본값:
5432)
ClickHouse Managed Postgres는 데이터베이스에 대한 슈퍼유저 액세스를 제공합니다. 이 자격 증명을 사용해 슈퍼유저로 연결하면 추가 사용자를 생성하고 데이터베이스 객체를 관리할 수 있습니다.
연결 문자열 포맷
Connect via 탭에서는 애플리케이션 요구 사항에 맞는 여러 포맷의 연결 문자열을 제공합니다:
| Format | Description |
|---|---|
| url | postgresql://<USER>:<PASSWORD>@<HOST>:<PORT>/<DATABASE> 포맷의 표준 connection URL |
| psql | psql 명령줄 도구로 연결할 때 바로 사용할 수 있는 명령 |
| env | libpq 기반 클라이언트를 위한 환경 변수 |
| yaml | YAML 형식의 구성 |
| jdbc | Java 애플리케이션용 JDBC 연결 문자열 |
보안상 연결 문자열의 password는 기본적으로 마스킹되어 표시됩니다. 필드나 연결 문자열 옆의 복사 아이콘을 클릭하면 클립보드에 바로 복사할 수 있습니다.
PgBouncer 연결 풀링
ClickHouse Managed Postgres에는 서버 측 연결 풀링을 위한 PgBouncer 인스턴스가 기본으로 포함되어 있습니다. PgBouncer는 특히 다음과 같은 애플리케이션에서 연결 관리, 성능, 리소스 활용도를 개선하는 데 도움이 됩니다.
- 많은 동시 연결을 여는 경우
- 연결을 자주 생성하고 종료하는 경우
- serverless 또는 임시 컴퓨트 환경을 사용하는 경우
연결 풀링을 사용하려면 연결 모달 상단의 via PgBouncer 토글을 클릭하세요. 연결 세부 정보가 업데이트되어 PostgreSQL에 직접 연결하는 대신 연결 pooler를 통해 라우팅됩니다.
TLS 구성
모든 ClickHouse Managed Postgres 인스턴스에는 TLS가 적용됩니다. 지원되는 최소 버전은 TLS 1.3입니다.
빠른 연결 (TLS 암호화)
기본적으로 연결은 인증서 검증 없이 TLS로 암호화됩니다:
psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres'검증된 TLS 연결(프로덕션 권장)
프로덕션 워크로드에서는 올바른 서버와 통신하고 있는지 확인할 수 있도록, 검증된 TLS로 연결하는 것을 권장합니다. 이를 위해 설정 탭에서 CA 인증서 번들을 다운로드한 후 데이터베이스 클라이언트의 신뢰할 수 있는 인증서에 추가하십시오.
CA 인증서는 각 ClickHouse Managed Postgres 인스턴스마다 고유하므로 다른 인스턴스에서는 작동하지 않습니다.
검증된 TLS 연결을 사용하려면 sslmode=verify-full과 다운로드한 인증서 경로를 추가하십시오:
psql 'postgresql://postgres:PASSWORD@your-instance.pg.clickhouse.cloud:5432/postgres?sslmode=verify-full&sslrootcert=/path/to/ca-certificate.pem'