mirror of
https://github.com/redis/redis.git
synced 2026-04-20 21:59:42 -04:00
0c3b8b7e90
This is an attempt to normalize/formalize command summaries. Main actions performed: * Starts with the continuation of the phrase "The XXXX command, when called, ..." for user commands. * Starts with "An internal command...", "A container command...", etc... when applicable. * Always uses periods. * Refrains from referring to other commands. If this is needed, backquotes should be used for command names. * Tries to be very clear about the data type when applicable. * Tries to mention additional effects, e.g. "The key is created if it doesn't exist" and "The set is deleted if the last member is removed." * Prefers being terse over verbose. * Tries to be consistent.
102 lines
2.9 KiB
JSON
102 lines
2.9 KiB
JSON
{
|
|
"RESTORE-ASKING": {
|
|
"summary": "An internal command for migrating keys in a cluster.",
|
|
"complexity": "O(1) to create the new key and additional O(N*M) to reconstruct the serialized value, where N is the number of Redis objects composing the value and M their average size. For small string values the time complexity is thus O(1)+O(1*M) where M is small, so simply O(1). However for sorted set values the complexity is O(N*M*log(N)) because inserting values into sorted sets is O(log(N)).",
|
|
"group": "server",
|
|
"since": "3.0.0",
|
|
"arity": -4,
|
|
"function": "restoreCommand",
|
|
"history": [
|
|
[
|
|
"3.0.0",
|
|
"Added the `REPLACE` modifier."
|
|
],
|
|
[
|
|
"5.0.0",
|
|
"Added the `ABSTTL` modifier."
|
|
],
|
|
[
|
|
"5.0.0",
|
|
"Added the `IDLETIME` and `FREQ` options."
|
|
]
|
|
],
|
|
"doc_flags": [
|
|
"SYSCMD"
|
|
],
|
|
"command_flags": [
|
|
"WRITE",
|
|
"DENYOOM",
|
|
"ASKING"
|
|
],
|
|
"acl_categories": [
|
|
"KEYSPACE",
|
|
"DANGEROUS"
|
|
],
|
|
"key_specs": [
|
|
{
|
|
"flags": [
|
|
"OW",
|
|
"UPDATE"
|
|
],
|
|
"begin_search": {
|
|
"index": {
|
|
"pos": 1
|
|
}
|
|
},
|
|
"find_keys": {
|
|
"range": {
|
|
"lastkey": 0,
|
|
"step": 1,
|
|
"limit": 0
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"arguments": [
|
|
{
|
|
"name": "key",
|
|
"type": "key",
|
|
"key_spec_index": 0
|
|
},
|
|
{
|
|
"name": "ttl",
|
|
"type": "integer"
|
|
},
|
|
{
|
|
"name": "serialized-value",
|
|
"type": "string"
|
|
},
|
|
{
|
|
"name": "replace",
|
|
"token": "REPLACE",
|
|
"type": "pure-token",
|
|
"optional": true,
|
|
"since": "3.0.0"
|
|
},
|
|
{
|
|
"name": "absttl",
|
|
"token": "ABSTTL",
|
|
"type": "pure-token",
|
|
"optional": true,
|
|
"since": "5.0.0"
|
|
},
|
|
{
|
|
"token": "IDLETIME",
|
|
"name": "seconds",
|
|
"type": "integer",
|
|
"optional": true,
|
|
"since": "5.0.0"
|
|
},
|
|
{
|
|
"token": "FREQ",
|
|
"name": "frequency",
|
|
"type": "integer",
|
|
"optional": true,
|
|
"since": "5.0.0"
|
|
}
|
|
],
|
|
"reply_schema": {
|
|
"const": "OK"
|
|
}
|
|
}
|
|
}
|