获取连接字符串

第2代

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

请按照以下步骤获取您的 IBM Cloud® Databases for PostgreSQL 实例的连接字符串：

  1. 在部署的 “概览”页面中，向下滚动至 “服务端点”部分。
  2. “服务端点”部分显示了可用连接方式的选项卡：
  • PostgreSQL – 显示部署的连接字符串、主机名、端口、数据库名称、身份验证源和副本集。
  • CLI – 提供了有关如何使用 IBM CLI 进行连接的详细信息。

架构
获取连接字符串 -“服务端点”PostgreSQL 选项卡

Databases for PostgreSQL 部署中不再包含默认的 admin user。 相反，您应通过 IBM Cloud® 服务凭据接口（使用UI或CLI）创建具有“Manager”、“Writer”或“Reader”角色的用户。 此处提供了一个用户名（ibm_...）、密码和连接字符串，可用于连接到您的部署环境。

在 CLI 中获取连接字符串

您还可以在“服务端点”的“CLI”选项卡下找到该端点。

架构
获取连接字符串 -“服务端点”CLI 选项卡

您还可以使用 Cloud Databases CLI插件中的“Connection”命令来检索连接字符串。

命令类似如下：

ibmcloud resource service-instance <INSTANCE_NAME_OR_CRN>

有关详细信息，请参阅 “Connections”命令选项。

Databases for PostgreSQL 部署中不再包含默认管理员用户。 相反，客户可通过 IBM Cloud® 服务凭据接口（使用UI或CLI），创建具有“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,，其值为“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... 表示数组中可能包含一个或多个此类条目。