Placement - Redis — ContextQMD

Configures the shard placement policy for a specified database.

rladmin placement
        db { db:<id> | <name> }
        { dense | sparse }

{{< note >}} rladmin placement db is deprecated and will be removed in a future version. Use [rladmin tune db]({{< relref "/operate/rs/7.22/references/cli-utilities/rladmin/tune#tune-db" >}}) with the shards_placement parameter instead. {{< /note >}}

Parameters

Parameter	Type/Value	Description
db	db:<id>
name	Configures shard placement for the specified database
dense		Places new shards on the same node as long as it has resources
sparse		Places new shards on the maximum number of available nodes within the cluster

Returns

Returns the new shard placement policy if the policy was changed successfully. Otherwise, it returns an error.

Use [rladmin status databases]({{< relref "/operate/rs/7.22/references/cli-utilities/rladmin/status#status-databases" >}}) to verify that the failover completed.

Example

$ rladmin status databases
DATABASES:
DB:ID  NAME       TYPE   STATUS   SHARDS   PLACEMENT    REPLICATION    PERSISTENCE    ENDPOINT                                
db:5   tr01       redis  active   1        dense        enabled        aof            redis-12000.cluster.local:12000         
$ rladmin placement db db:5 sparse
Shards placement policy is now sparse
$ rladmin status databases
DATABASES:
DB:ID  NAME       TYPE   STATUS   SHARDS   PLACEMENT    REPLICATION    PERSISTENCE    ENDPOINT                                
db:5   tr01       redis  active   1        sparse       enabled        aof            redis-12000.cluster.local:12000