取得連接字串

IBM Cloud® Databases for Redis 服務佈建時已啟用鑑別。 您需要使用者名稱、密碼及連線字串，才能連接及發出指令。

您的部署的連接字串顯示在概述頁面的端點面板中。 部署上的所有使用者都可以使用連線字串，包括公用或專用端點的連線字串。

您的連線字串將預設為資料庫 0。 不過，支援修改連線以連接至 0 以外的資料庫。

您的 Redis 部署已佈建管理者使用者。 您必須先設定管理密碼，然後才能使用它來連接至資料庫。 如需相關資訊，請參閱 設定管理者密碼 頁面。

從 UI 取得連接字串

請依照下列步驟檢索您的Databases for Redis實例連接字串：

  1. 在部署的概述頁面中，向下捲動到端點部分。
  2. 在端點部分中，您可以找到包含以下部分的快速啟動標籤：
    • 使用 CLI 連接- 此部分包含透過 IBM CLI連接到您的部署的資訊。
    • 使用Redis用戶端連線- 此部分可讓您取得 TLS 憑證並連線到您的部署。

從 CLI 取得連接字串

您可以從 CLI 抓取連線字串。

ibmcloud cdb deployment-connections <INSTANCE_NAME_OR_CRN> -u <NEWUSERNAME> [--endpoint-type <endpoint type>]

ibmcloud cdb deployment-connections 指令會以 --all 旗標傳回完整連線資訊。 若要檢索部署的所有連接訊息，請使用以下命令：

ibmcloud cdb deployment-connections <INSTANCE_NAME_OR_CRN> -u <NEWUSERNAME> --all [--endpoint-type <endpoint type>]

如果您未指定使用者，依預設，deployment-connections 指令會傳回管理使用者的資訊。 如果您未指定端點類型，依預設，連線字串會傳回公用端點。 如果您的部署只有專用端點，則必須指定 --endpoint-type private，否則指令會傳回錯誤。 未施行使用者和端點類型。 您可以將部署上的任何使用者與任一端點搭配使用 (如果部署上同時存在這兩個端點)。

若要使用 ibmcloud cdb CLI 指令，您必須 安裝 Cloud Databases 外掛程式。

從 API 取得連接字串

若要從 API 擷取使用者的連線字串，請使用 /users/{userid}/connections 端點。 您必須在路徑中指定在傳回的連線字串中使用的使用者及端點類型 (公用或專用)。 未施行使用者和端點類型。 您可以將部署上的任何使用者與任一端點搭配使用 (如果部署上同時存在這兩個端點)。

curl -X GET https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/users/{user_type}/{user_id}/connections/{endpoint_type} \
-H 'Authorization: Bearer <>' \

更多用戶和連接字串

對Databases for Redis部署的存取權限不限於管理員使用者。 您可以使用_「服務憑證」_頁面、IBM Cloud CLI 或透過IBM Cloud Databases API。

部署上的所有使用者都可以使用連線字串，包括公用或專用端點的連線字串。

從 UI 建立用戶

  1. 導航到您的服務的資源詳細資訊頁面。
  2. 按一下服務憑證以開啟_服務憑證_頁面。
  3. 按一下新認證。
  4. 為您的新憑證選擇一個描述性的名稱。
  5. （可選）指定新憑證是使用公共端點還是專用端點。 在_新增內聯配置參數_欄位中使用 { "service-endpoints": "public" } / { "service-endpoints": "private" } 來產生使用指定端點的連接字串。 端點的使用不是強制的，因為它控制連接字串中的主機名稱。 預設會產生公共端點。
  6. 按一下 “新增” 以配置新憑證。 使用者名稱和密碼以及關聯的Redis使用者是自動產生的。

新憑證將顯示在表中，並且連接字串在_「檢視憑證」_下的點擊複製欄位中以 JSON 形式提供。

從 CLI 建立使用者

如果您透過IBM Cloud CLI 和 雲端資料庫外掛程式 管理服務，則可以使用 cdb user-create 建立新使用者。 例如，要為“example-deployment”建立新用戶，請使用下列命令。

ibmcloud cdb user-create example-deployment <NEWUSERNAME> <NEWPASSWORD>

任務完成後，您可以使用 ibmcloud cdb deployment-connections 命令檢索新使用者的連接字串。

使用 API 建立使用者

服務的_概述_面板上顯示的_基礎端點_提供了透過 API 存取此部署的基本URL。 若要建立和管理用戶，請使用具有 /users 端點的基本URL。

curl -X POST 'https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/users/{user_type}' \
-H "Authorization: Bearer $APIKEY" \
-H "Content-Type: application/json" \
-d '{"user": {"username": "user", "password": "v3ry-1-secUre-pAssword-2"}}'

若要檢索使用者的連接字串，請使用具有 /users/{userid}/connections 端點的基本URL。

將使用者新增至 UI 中的_服務憑證_

從 CLI 建立新使用者不會自動將該使用者的連接字串填入_Service Credentials_中。 如果您想在那裡新增它們，您可以使用現有的使用者資訊建立一個新的憑證。

在 JSON 欄_位新增內嵌設定參數_中輸入使用者名稱和密碼，或指定儲存 JSON 資訊的檔案。 例如，將 {"existing_credentials":{"username":"Robert","password":"supersecure"}} 放在欄位中會產生_服務憑證_，其中使用者名稱「Robert」和密碼「supersecure」填入連接字串中。

從現有使用者產生憑證不會檢查或建立該使用者。

連線字串明細

Redis部分

在*「服務憑證」*頁面上建立的憑證的「Redis」部分包含適合連接到Redis應用程式的資訊。

Redis /URI 連接訊息
欄位名稱 索引 說明
Type 連接類型 - 對於Redis，它是“URI”。
Scheme URI 方案 - 對於Redis，它是「rediss」。
Path URI 的路徑 - 對Redis來說，它是資料庫編號。
Authentication Username 您用來連接的使用者名稱。
Authentication Password 使用者的密碼 - 可能顯示為 $PASSWORD。
Authentication Method 如何進行鑑別; 由驅動程式處理「直接」鑑別。
Hosts 0... 要連接的主機名稱和連接埠。
Composed 0... 結合了方案、身份驗證、主機和路徑的 URI。
Certificate Name 用於資料庫部署的服務專屬憑證的已分配名稱。
Certificate Base64 憑證的 base64 編碼版本。
  • 0... 表示陣列中可能有一或多個這些項目。

有關更多信息，請參閱 連接外部應用程式。

CLI 部分

在*「服務憑證」*頁面上建立的憑證的「CLI」部分包含適合與Redis連接的命令列用戶端的資訊。

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

有關更多信息，請參閱 使用命令列客戶端連接。