연결 문자열 가져오기

2세대

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

IBM Cloud® Databases for PostgreSQL 인스턴스의 연결 문자열을 확인하려면 다음 단계를 따르십시오:

배포의 ‘개요’ 페이지 에서 아래로 스크롤하여 ‘서비스 엔드포인트 ’ 섹션으로 이동하세요.
'서비스 엔드포인트' 섹션에는 사용 가능한 연결 방법에 대한 탭이 표시됩니다:

PostgreSQL – 배포 환경의 연결 문자열, 호스트 이름, 포트, 데이터베이스 이름, 인증 소스 및 복제 세트를 표시합니다.
CLI – IBM CLI를 사용하여 연결하는 방법에 대한 세부 정보를 제공합니다.

아키텍처 — 연결 문자열 가져오기 - 서비스 엔드포인트 PostgreSQL 탭

Databases for PostgreSQL 배포에는 더 이상 기본값인 admin user 이 포함되지 않습니다. 대신, UI나 CLI를 통해 IBM Cloud® 서비스 자격 증명 인터페이스를 사용하여 ‘Manager’, ‘Writer’ 또는 ‘Reader’ 역할을 가진 사용자를 생성합니다. 여기에는 배포 환경에 연결하는 데 사용할 수 있는 사용자 이름(ibm_...), 비밀번호 및 연결 문자열이 제공됩니다.

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

또한 서비스 엔드포인트의 ‘CLI’ 탭에서도 해당 엔드포인트를 확인할 수 있습니다.

또한 Cloud Databases CLI 플러그인의 ‘Connection’ 명령을 사용하여 연결 문자열을 가져올 수도 있습니다.

명령은 다음과 비슷하게 나타납니다.

ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>

자세한 내용은 ‘Connections’ 명령어 옵션을 참조하십시오.

Databases for PostgreSQL 배포 시 더 이상 기본 관리자 사용자가 포함되지 않습니다. 대신, 고객은 UI 또는 CLI를 통해 IBM Cloud® 서비스 자격 증명 인터페이스를 사용하여 ‘Manager’, ‘Writer’ 또는 ‘Reader’ 역할을 가진 사용자를 생성합니다. 여기에는 배포 환경에 연결하는 데 사용할 수 있는 사용자 이름(ibm_...), 비밀번호 및 연결 문자열이 제공됩니다. 배치에 개인용 엔드포인트만 있는 경우, --endpoint-type private를 지정해야 하며 그렇지 않으면 명령이 오류를 리턴합니다. 사용자 및 엔드포인트 유형이 적용되지 않습니다. 지정된 연결 옵션인 비공개 엔드포인트를 사용하면 배포 환경에 있는 모든 사용자가 이를 이용할 수 있습니다.

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

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

Cloud Databases API에서 사용자의 연결 문자열을 가져오려면 Connections 엔드포인트를 사용하십시오. 연결 문자열을 생성할 때는 경로에 사용해야 할 특정 사용자와 엔드포인트 유형이 포함되어 있는지 확인하십시오. user 는 제한되거나 강제되지 않습니다. 배포 환경에 있는 모든 사용자를 자유롭게 활용할 수 있습니다.

API 명령어는 다음과 같습니다:

curl -X GET 'https://resource-controller.cloud.ibm.com/v2/resource_instances/{id}' -H "Authorization: Bearer <IAM token>""

{region}, {id}, {userid}, {endpoint_type} 을 적절한 값으로 대체하는 것을 잊지 마십시오.

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 에 연결하는 애플리케이션에 적합한 정보가 포함되어 있습니다.

PostgreSQL/URI 연결 정보
필드 이름	색인	설명
`Type`		연결 유형 - PostgreSQL, 의 경우 "URI"입니다.
`Scheme`		URI 구성 방식 - PostgreSQL, 의 경우 “postgresql”입니다.
`Path`		URI의 경로. PostgreSQL의 경우 데이터베이스 이름입니다. 기본값은 `ibmclouddb`입니다.
`Authentication`	`Username`	연결하는 데 사용하는 사용자 이름입니다.
`Authentication`	`Password`	사용자의 비밀번호 - `$PASSWORD` 형태로 표시될 수 있습니다.
`Authentication`	`Method`	인증이 수행되는 방법이며 "직접" 인증은 드라이버에 의해 처리됩니다.
`Hosts`	`0...`	연결할 호스트 이름 및 포트입니다.
`Composed`	`0...`	Scheme, 인증, 호스트 및 경로를 결합한 URI.

0... 배열 내에 이러한 항목 중 하나 이상을 나타냅니다.

CLI 섹션

“CLI” 섹션에는 psql 에 접속하는 데 필요한 정보가 포함되어 있습니다.

PostgreSQL/cli 연결 정보
필드 이름	색인	설명
`Bin`		연결을 설정하는 바이너리 파일입니다. 이 경우 `psql` 입니다.
`Composed`		배치에 대한 연결을 설정하는 형식화된 명령. 이 명령은 `Bin` 실행 파일, `Environment` 변수 설정을 결합하고 `Arguments`를 명령행 매개변수로 사용합니다.
`Environment`		환경 변수로 설정한 키/값 목록입니다.
`Arguments`	0...	Bin 필드에 표시된 명령에 인수로 전달되는 정보입니다.
`Type`		이 연결 정보를 사용하는 패키지 유형입니다. 여기서는 `cli`입니다.

0... 배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.