获取连接字符串

将在启用认证的情况下供应 IBM Cloud® Databases for Redis 服务。 您需要用户名，密码和连接字符串来连接和发出命令。

部署的连接字符串显示在“概览”页面的“端点”面板中。 部署上的所有用户都可以使用连接字符串，包括公共或专用端点的连接字符串。

您的连接字符串将缺省为数据库 0。 但是，支持修改连接以连接到 0 以外的数据库。

您的 Redis 部署是由管理员用户供应的。 必须先设置管理员密码，然后才能将其用于连接到数据库。 有关更多信息，请参阅 设置管理员密码 页面。

从用户界面获取连接字符串

请按照以下步骤检索Databases for Redis实例连接字符串：

  1. 在部署的“概览”页面，向下滚动到“端点”部分。
  2. 在“端点”部分，有一个“快速入门”选项卡，其中包含以下部分：
    • 使用 CLI 连接- This section contains information for connecting to your deployment through the IBM CLI.
    • 使用Redis客户端连接- 本节允许你获取 TLS 证书并连接到部署。

从 CLI 获取连接字符串

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

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

完整连接信息由带有 --all 标志的 ibmcloud cdb deployment-connections 命令返回。 要检索部署的所有连接信息，请使用以下命令：

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

如果未指定用户，那么缺省情况下，deployment-connections 命令将返回 admin 用户的信息。 如果未指定端点类型，那么缺省情况下，连接字符串将返回公共端点。 如果您的部署只有专用端点，那么必须指定 --endpoint-type private 或命令返回错误。 未强制实施用户和端点类型。 您可以将部署上的任何用户与任一端点配合使用 (如果这两个端点都存在于您的部署上)。

要使用 ibmcloud cdb CLI 命令，必须 安装 Cloud Databases 插件。

从应用程序接口获取连接字符串

要从 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创建用户。云 CLI，或通过IBM创建用户。Cloud DatabasesAPI。

部署上的所有用户都可以使用连接字符串，包括公共或专用端点的连接字符串。

从用户界面创建用户

  1. 导航至服务的资源详情页。
  2. 单击服务凭证打开_服务凭证_页面。
  3. 单击新建凭证。
  4. 为新证书选择一个描述性名称。
  5. (可选） 指定新凭证使用的是公共端点还是专用端点。 在“添加内联配置参数”字段中使用 { "service-endpoints": "public" }/{ "service-endpoints": "private" } 可使用指定的端点生成连接字符串。 不强制使用端点，因为它控制连接字符串中的主机名。 默认情况下会生成公共端点。
  6. 单击“添加” 提供新凭证。 会自动生成用户名和密码以及相关的Redis用户。

新凭据会出现在表格中，连接字符串会以 JSON 格式出现在“_查看凭据”_下的“点击复制”字段中。

通过 CLI 创建用户

如果您通过IBM CloudCLI 和 云数据库插件 管理服务，则可以使用 cdb user-create 创建新用户。 例如，要为 "example-deployment "创建一个新用户，请使用以下命令。

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

任务完成后，可以使用 ibmcloud cdb deployment-connections 命令检索新用户的连接字符串。

使用应用程序接口创建用户

服务_概览_面板上显示的_基础端点_提供了通过 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。

在用户界面中为_服务证书_添加用户

从 CLI 创建新用户不会自动将该用户的连接字符串填充到_服务凭证_中。 如果要在这里添加，可以使用现有用户信息创建一个新凭证。

在 JSON 字段“添加内联配置参数”中输入用户名和密码，或指定一个存储 JSON 信息的文件。 例如，在字段中输入 {"existing_credentials":{"username":"Robert","password":"supersecure"}}，生成的_服务凭据_会在连接字符串中填入用户名 "Robert "和密码 "supersecure"。

从现有用户生成证书不会检查或创建该用户。

连接字符串细分

Redis部分

服务凭证页面上创建的凭证的Redis"部分包含适合连接到Redis 的应用程序的信息。

Redis 连接信息
字段名称 索引 描述
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 连接信息
字段名称 索引 描述
Bin 用于创建连接的建议二进制文件; 在此情况下为 redli。
Composed 用于与部署建立连接的格式化命令。 该命令组合了 Bin 可执行文件 Environment 变量设置，并使用 Arguments 作为命令行参数。
Environment 设置为环境变量的键或值的列表。
Arguments 0... 作为参数传递给 "Bin" 字段中显示的命令的信息。
Certificate Base64 服务专有证书，用于确认应用程序正在连接到相应的服务器。 base64 编码。
Certificate 名称 服务专有证书的分配名称。
Type 使用此连接信息的包的类型; 在本例中为 cli。
  • 0... 指示数组中可能有一个或多个这些条目。

更多信息，请参阅 使用命令行客户端连接。