启用 OSS 集群 API

查看 Redis OSS 集群 API，以确定是否应该为数据库启用此功能。

先决条件

仅当数据库满足特定条件时，才支持 Redis OSS 集群 API。

数据库必须：

• 使用标准哈希策略。
• 将代理策略设置为 All primary shards （所有主分片） 或 All nodes （所有节点）。

此外，数据库不得：

• 使用节点include或exclude在代理策略中。
• 使用 RediSearch、RedisTimeSeries 或 RedisGears 模块。

OSS 集群 API 设置适用于单个数据库，而不是整个集群。

启用 OSS 集群 API 支持

您可以使用集群管理器 UI、rladmin实用程序或 REST API 来启用对数据库的 OSS 集群 API 支持。

当您为现有数据库启用 OSS 集群 API 支持时，更改将应用于新连接，但不会影响现有连接。客户端必须关闭现有连接并重新连接才能应用更改。

Cluster Manager UI 方法

当您使用集群管理器 UI 启用 OSS 集群 API 时，它会自动配置先决条件。

要在集群管理器 UI 中为现有数据库启用 OSS 集群 API，请执行以下作：

1. 从数据库的 Configuration 选项卡中，选择 Edit 。

2. 展开 Clustering （集群） 部分。

3. 选择 Enable sharding（启用分片）。

4. 选择 OSS Cluster API。

   

5. 选择 Save （保存）。

您还可以使用 Cluster Manager UI 在创建新数据库时启用该设置。

命令行方法

您可以使用rladmin效用为 Redis Enterprise Software 数据库（包括数据库副本）启用 OSS Cluster API。

对于主动-主动 （CRDB） 数据库，请使用 crdb-cli 实用程序。

确保已配置先决条件。然后，从命令行为 Redis 数据库启用 OSS 集群 API：

$ rladmin tune db <database name or ID> oss_cluster enabled

To determine the current setting for a database from the command line, use rladmin info db to return the value of the oss_cluster setting.

$ rladmin info db test | grep oss_cluster:
  oss_cluster: enabled

POST /v1/bdbs
{ 
  "oss_cluster": true,
  // Other database configuration parameters
}

PUT /v1/bdbs/<database-id>
{ "oss_cluster": true }

$ crdb-cli crdb create --name <name> \
    --memory-size 10g --port <port> \
    --sharding true --shards-count 2  \
    --replication true --oss-cluster true --proxy-policy all-master-shards \
    --instance fqdn=<fqdn>,username=<user>,password=<pass> \
    --instance fqdn=<fqdn>,username=<user>,password=<pass> \
    --instance fqdn=<fqdn>,username=<user>,password=<pass>

$ rladmin tune db db:<database-id> oss_cluster_api_preferred_ip_type external