取得連接字串

在 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 指令會傳回管理使用者的資訊。如果您未指定端點類型，依預設，連線字串會傳回公用端點。如果您的部署只有專用端點，則必須指定 --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的應用程式的資訊。

PostgreSQL/URI 連線資訊
欄位名稱	索引	說明
`Type`		連線類型——對於 PostgreSQL, 而言，其值為「URI」。
`Scheme`		URI 方案——以 PostgreSQL, 為例，其 URI 為「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 的資訊。

psql/cli 連接訊息
欄位名稱	索引	說明
`Bin`		用來建立連線的二進位檔; 在此情況下為 `psql`。
`Composed`		格式化指令，用於建立與部署的連線。該指令結合 `Bin` 執行檔、`Environment` 變數設定，並使用 `Arguments` 作為指令行參數。
`Environment`		您設定為環境變數的索引鍵/值清單。
`Arguments`	0...	作為引數傳遞至 Bin 欄位中所顯示指令的資訊。
`Certificate`	Base64	一種服務專屬憑證，用於確認應用程式是否正在連線至正確的伺服器。這是採用 base64 編碼的。
`Certificate`	名稱	服務專屬憑證的分配名稱。
`Type`		使用此連線資訊的套件類型; 在此情況下為 `cli`。

0... 表示陣列中可能有一或多個這些項目。