取得連線字串

第 2 代

在使用者介面中取得連線字串

請依照以下步驟取得您的 IBM Cloud® Databases for PostgreSQL 實例的連線字串：

  1. 在您的部署的 「概覽」頁面上，向下捲動至「服務端點」區段。
  2. 「服務端點」區段會顯示可用連線方式的標籤頁：
  • PostgreSQL – 顯示您部署的連線字串、主機名稱、埠號、資料庫名稱、驗證來源及複本集。
  • CLI – 提供有關如何使用 IBM CLI 進行連線的詳細資訊。

架構
取得連線字串 — 服務端點 PostgreSQL 標籤頁

Databases for PostgreSQL 部署中不再包含預設的 admin user。 相反地，您可以透過「IBM Cloud®」服務憑證介面（無論是透過使用者介面或命令列介面），建立具有「Manager」、「Writer」或「Reader」角色的使用者。 此處提供了一個使用者名稱（ibm_...）、密碼以及連線字串，可用於連線至您的部署環境。

在 CLI 中取得連線字串

您也可以在「服務端點」的「CLI」分頁下找到該端點。

Architecture
取得連線字串 — 服務端點的「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, 為例，其 URI 即為「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... 表示陣列中可能包含一個或多個此類項目。