取得連線字串

若要連接至 IBM Cloud® Databases for MySQL,您需要一些使用者及連線字串。 部署的連線字串會顯示在「儀表板概觀」的「端點」畫面中。

儀表板概述上的端點面板
儀表板概述上的端點面板

Databases for MySQL 部署由管理使用者佈建,在 設定管理密碼 之後,請使用其連線字串來連接至您的部署。

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

ibmcloud cdb deployment-connections example-deployment -u <newusername> [--endpoint-type <endpoint type>]

ibmcloud cdb deployment-connections 指令會以 --all 旗標傳回完整連線資訊。 若要擷取名為 "example-deployment" 之部署的所有連線資訊,請使用下列指令。

ibmcloud cdb deployment-connections example-deployment -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 -H "Authorization: Bearer $APIKEY" 'https://api.{region}.databases.cloud.ibm.com/v4/ibm/deployments/{id}/users/{userid}/connections/{endpoint_type}'

連線字串明細

MySQL 區段

"mysql" 區段包含適用於連接至 mysql 的應用程式的資訊。

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

CLI 區段

"CLI" 區段包含適用於連接 mysql 的資訊。

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