获取连接字符串

在用户界面中获取连接字符串

要连接到 IBM Cloud® Databases for PostgreSQL，您需要一些用户和连接字符串。部署的连接字符串显示在 Overview 页面的 Endpoints 面板中。

上的端点面板

Databases for PostgreSQL 部署由管理员用户供应，在设置管理员密码之后，您可以使用其连接字符串来连接到部署。

在 CLI 中获取连接字符串

从 CLI 抓取连接字符串。

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

完整连接信息由带有 --all 标志的 ibmcloud cdb deployment-connections 命令返回。要检索名为 "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 检索用户的连接字符串，请使用 /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, 而言，是 "postgresql"
`Path`		URI 的路径 - 对于 PostgreSQL, 是数据库名称。默认值为 `ibmclouddb`。
`Authentication`	`Username`	用于连接的用户名。
`Authentication`	`Password`	用户的密码-可能显示为 `$PASSWORD`
`Authentication`	`Method`	如何进行认证;“直接”认证由驱动程序处理。
`Hosts`	`0...`	要连接到的主机名和端口
`Composed`	`0...`	组合方案，认证，主机和路径的 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... 指示数组中可能有一个或多个这些条目。