获取连接字符串

要连接到 IBM Cloud® Databases for MySQL，您需要一些用户和连接字符串。部署的连接字符串显示在“仪表板概述”的“端点”面板中。

》上的端点面板* 《控制面板概览》上的端点面板

将使用管理用户供应 Databases for MySQL 部署，并且在设置管理密码后，使用其连接字符串来连接到部署。

CLI
您还可以从 CLI 抓取连接字符串。

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

完整连接信息由带有 --all 标志的 ibmcloud cdb deployment-connections 命令返回。要检索名为 "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...`	结合了方案、验证、主机和路径的 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... 指示数组中可能有一个或多个这些条目。