연결 문자열 가져오기
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 에 연결하는 애플리케이션에 적합한 정보가 포함되어 있습니다.
| 필드 이름 | 색인 | 설명 |
|---|---|---|
Type |
연결 유형 - PostgreSQL, 의 경우 "URI"입니다. | |
Scheme |
URI 구성 방식 - PostgreSQL, 의 경우 "postgresql"입니다. | |
Path |
URI의 경로. PostgreSQL의 경우 데이터베이스 이름입니다. 기본값은 ibmclouddb입니다. |
|
Authentication |
Username |
연결하는 데 사용하는 사용자 이름입니다. |
Authentication |
Password |
사용자의 비밀번호 - $PASSWORD 형태로 표시될 수 있습니다. |
Authentication |
Method |
인증이 수행되는 방법이며 "직접" 인증은 드라이버에 의해 처리됩니다. |
Hosts |
0... |
연결할 호스트 이름 및 포트입니다. |
Composed |
0... |
Scheme, 인증, 호스트 및 경로를 결합한 URI. |
Certificate |
Name |
데이터베이스 배포를 위한 서비스 전용 인증서에 할당된 이름입니다. |
Certificate |
Base64 | base64 인코딩된 인증서 버전입니다. |
0...은 이러한 항목 중 하나 이상을 배열로 나타냅니다.
CLI 섹션
“CLI” 섹션에는 psql 에 접속하는 데 필요한 정보가 포함되어 있습니다.
| 필드 이름 | 색인 | 설명 |
|---|---|---|
Bin |
연결을 설정하는 바이너리 파일입니다. 이 경우 psql 입니다. |
|
Composed |
배치에 대한 연결을 설정하는 형식화된 명령. 이 명령은 Bin 실행 파일, Environment 변수 설정을 결합하고 Arguments를 명령행 매개변수로 사용합니다. |
|
Environment |
환경 변수로 설정한 키/값 목록입니다. | |
Arguments |
0... | Bin 필드에 표시된 명령에 인수로 전달되는 정보입니다. |
Certificate |
Base64 | 애플리케이션이 올바른 서버에 연결되고 있음을 확인하는 데 사용되는 서비스 전용 인증서입니다. 이는 base64로 인코딩됩니다. |
Certificate |
이름 | 서비스 전용 인증서에 할당된 이름입니다. |
Type |
이 연결 정보를 사용하는 패키지 유형입니다. 여기서는 cli입니다. |
0...배열에 이러한 항목이 하나 이상 있을 수 있음을 표시합니다.