연결 문자열 가져오기

UI에서 연결 문자열 가져오기

IBM Cloud® Databases for PostgreSQL에 연결하려면 일부 사용자 및 연결 문자열이 필요합니다. 배포에 대한 연결 문자열은 개요 페이지의 엔드포인트 패널에 표시됩니다.

대시보드 개요의 엔드포인트 패널
대시보드 개요의 엔드포인트 패널

Databases for PostgreSQL 배치는 관리자로 프로비저닝되며 관리 비밀번호를 설정한 후 연결 문자열을 사용하여 배치에 연결할 수 있습니다.

CLI에서 연결 문자열 가져오기

CLI 에서 연결 문자열을 가져옵니다.

ibmcloud cdb deployment-connections example-deployment -u <NEW_USERNAME> [--endpoint-type <ENDPOINT_TYPE>]

전체 연결 정보는 ibmcloud cdb deployment-connections 플래그와 함께 --all 명령으로 리턴됩니다. "example-deployment"라는 배치에 대한 모든 연결 정보를 검색하려면 다음 명령을 사용하십시오.

ibmcloud cdb deployment-connections example-deployment -u <NEW_USERNAME> --all [--endpoint-type <ENDPOINT_TYPE>]

사용자를 지정하지 않으면 deployment-connections 명령이 기본적으로 admin 사용자에 대한 정보를 리턴합니다. 엔드포인트 유형을 지정하지 않으면, 연결 문자열이 기본적으로 공용 엔드포인트를 리턴합니다. 배치에 개인용 엔드포인트만 있는 경우, --endpoint-type private를 지정해야 하며 그렇지 않으면 명령이 오류를 리턴합니다. 사용자 및 엔드포인트 유형이 적용되지 않습니다. 배치의 모든 사용자를 두 엔드포인트 중 하나와 함께 사용할 수 있습니다(두 엔드포인트가 모두 배치에 있는 경우).

ibmcloud cdb CLI 명령을 사용하려면 Cloud Databases 플러그인을 설치해야 합니다.

API에서 연결 문자열 가져오기

API에서 사용자의 연결 문자열을 검색하려면 /users/{userid}/connections엔드포인트를 사용하십시오. 반환된 연결 문자열에 사용할 사용자와 엔드포인트 유형(공용 또는 비공개)을 경로에 지정해야 합니다. 사용자 및 엔드포인트 유형이 적용되지 않습니다. 배치의 모든 사용자를 두 엔드포인트 중 하나와 함께 사용할 수 있습니다(두 엔드포인트가 모두 배치에 있는 경우).

curl -X GET -H "Authorization: Bearer $APIKEY" 'https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/users/{userid}/connections/{endpoint_type}'

연결 문자열 명세

PostgreSQL 섹션

"PostgreSQL" 탭에는 PostgreSQL 에 연결하는 애플리케이션에 적합한 정보가 포함되어 있습니다.

포스트그레스큐/URI 연결 정보
필드 이름 색인 설명
Type 연결 유형. PostgreSQL의 경우 "URI"입니다.
Scheme URI의 스키마. PostgreSQL의 경우 "postgresql"입니다.
Path URI의 경로. PostgreSQL의 경우 데이터베이스 이름입니다. 기본값은 ibmclouddb입니다.
Authentication Username 연결하는 데 사용하는 사용자 이름입니다.
Authentication Password 사용자에 대한 비밀번호로 $PASSWORD로 표시될 수 있습니다.
Authentication Method 인증이 수행되는 방법이며 "직접" 인증은 드라이버에 의해 처리됩니다.
Hosts 0... 연결할 호스트 이름 및 포트입니다.
Composed 0... 스킴, 인증, 호스트 및 경로를 결합한 URI
Certificate Name 데이터베이스 배포를 위한 서비스 전용 인증서의 할당된 이름입니다
Certificate Base64 base64 인코딩된 인증서 버전입니다.
  • 0... 은 이러한 항목 중 하나 이상을 배열로 나타냅니다.

CLI 섹션

'CLI' 섹션에는 psql 에 연결하는 데 적합한 정보가 포함되어 있습니다.

pSQL/CLI 연결 정보
필드 이름 색인 설명
Bin 연결을 생성할 바이너리(이 경우 psql)입니다.
Composed 배치에 대한 연결을 설정하는 형식화된 명령. 이 명령은 Bin 실행 파일, Environment 변수 설정을 결합하고 Arguments를 명령행 매개변수로 사용합니다.
Environment 환경 변수로 설정한 키/값 목록입니다.
Arguments 0... Bin 필드에 표시된 명령에 인수로 전달되는 정보입니다.
Certificate Base64 애플리케이션이 적절한 서버에 연결 중인지 확인하는 데 사용되는 서비스 전용 인증서입니다. 이는 base64로 인코딩됩니다.
Certificate 이름 서비스 전용 인증서에 할당된 이름입니다.
Type 이 연결 정보를 사용하는 패키지 유형입니다. 여기서는 cli입니다.
  • 0... 배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.