命令参考 · kevy

命令参考

引擎能回答的每一条动词 —— 共 206 条,与服务端分发所用的是同一张表。

connection

`ECHO`	Return the given message.
`HELLO`	Handshake: report server info and switch RESP protocol version (2 or 3).
`PING`	Ping the server; returns PONG or echoes the optional message.
`QUIT`	Close the connection after replying OK.
`SELECT`	Select the logical database; kevy is single-DB and only accepts index 0.

feed

`FEED.READ`	Read change-feed frames from one shard past a generation/offset cursor.
`FEED.SHARDS`	Return the number of change-feed shards.
`FEED.TAIL`	Return a shard's current feed generation and next offset.

generic

`COPY`	Copy a key's value, and its remaining TTL, to another key.
`DEL`	Delete one or more keys.
`EXISTS`	Count how many of the given keys exist.
`EXPIRE`	Set a key's TTL in seconds (non-positive TTL deletes the key).
`EXPIREAT`	Set a key's expiry as an absolute Unix timestamp in seconds.
`PERSIST`	Remove a key's TTL.
`PEXPIRE`	Set a key's TTL in milliseconds.
`PEXPIREAT`	Set a key's expiry as an absolute Unix timestamp in milliseconds.
`PTTL`	Return a key's remaining TTL in milliseconds (-1 no TTL, -2 missing).
`RENAME`	Rename a key, overwriting the destination (write routed at the runtime Op level).
`RENAMENX`	Rename a key only if the destination does not exist (write routed at the runtime Op level).
`TOUCH`	Count how many of the given keys exist.
`TTL`	Return a key's remaining TTL in seconds (-1 no TTL, -2 missing).
`TYPE`	Return the type of the value stored at key.
`UNLINK`	Delete one or more keys (alias of DEL in kevy's shard model).

geo

`GEOADD`	Add geospatial members (longitude/latitude) to a geo set.
`GEODIST`	Return the distance between two geo members.
`GEOHASH`	Return the base32 geohash string of each member.
`GEOPOS`	Return the longitude/latitude of each member.
`GEORADIUS`	Legacy radius search around a coordinate, with optional STORE writes.
`GEORADIUSBYMEMBER`	Legacy radius search around an existing member, with optional STORE writes.
`GEOSEARCH`	Search members within a radius or box from a member or coordinate.
`GEOSEARCHSTORE`	Run GEOSEARCH on source and store the hits into destination.

hash

`HDEL`	Delete one or more hash fields.
`HEXISTS`	Check whether a hash field exists.
`HEXPIRE`	Set per-field TTLs on a hash, in seconds.
`HGET`	Return the value of a hash field.
`HGETALL`	Return all fields and values of a hash.
`HINCRBY`	Increment the integer value of a hash field.
`HINCRBYFLOAT`	Increment the float value of a hash field.
`HKEYS`	Return all field names of a hash.
`HLEN`	Return the number of fields in a hash.
`HMGET`	Return the values of multiple hash fields.
`HMSET`	Deprecated alias of HSET that replies OK.
`HPERSIST`	Remove per-field TTLs from a hash.
`HPEXPIRE`	Set per-field TTLs on a hash, in milliseconds.
`HPEXPIREAT`	Set per-field expiries as absolute Unix-millisecond deadlines.
`HPTTL`	Return per-field remaining TTLs in milliseconds (-1 no TTL, -2 missing).
`HRANDFIELD`	Return random fields from a hash; a negative count allows repeats, WITHVALUES pairs each with its value.
`HSCAN`	Iterate a hash's fields and values (single-batch cursor).
`HSET`	Set one or more hash fields; returns the number of new fields.
`HSETNX`	Set a hash field only if it does not exist.
`HTTL`	Return per-field remaining TTLs in seconds (-1 no TTL, -2 missing).
`HVALS`	Return all values of a hash.

index

`IDX.ADVISE`	The declarations refused queries have been asking for, most-refused first — each rendered as the command that would serve it.
`IDX.COUNT`	Count index entries matching a range or equality predicate.
`IDX.CREATE`	Declare a secondary index over a key prefix (catalog mutation, sidecar-persisted).
`IDX.DROP`	Drop a declared index (catalog mutation, sidecar-persisted).
`IDX.EXPLAIN`	The IDX.QUERY parse without the execution: kind, state, est_rows, and the plan line.
`IDX.LIST`	List declared indexes with per-index build state and stats.
`IDX.QUERY`	Query an index: range/equality, text MATCH, vector KNN, aggregation groups, or a two-index COMPOSE.
`IDX.REBUILD`	Rebuild an ANN index (tombstone compaction).
`IDX.VERIFY`	Verify an index. Scalar kinds re-read every held entry against its row and report entries/bytes/coerce_failures/duplicates/drift/checked/missing (both audit directions); agg/text/ann answer their own sizing vocabulary (rows\|docs\|vectors, bytes, ...) and carry no row-keyed audit.

list

`BLPOP`	Blocking left pop across one or more lists (effect logged as LPOP).
`BRPOP`	Blocking right pop across one or more lists (effect logged as RPOP).
`BRPOPLPUSH`	Blocking RPOPLPUSH: pop the source tail and push it onto the destination head.
`LINDEX`	Return the element at the given list index.
`LINSERT`	Insert an element before or after a pivot element.
`LLEN`	Return the length of a list.
`LMOVE`	Atomically move an element between two lists.
`LPOP`	Pop one or more elements from the head of a list.
`LPOS`	Return the index of matching elements in a list.
`LPUSH`	Prepend one or more elements to a list.
`LRANGE`	Return a range of list elements.
`LREM`	Remove elements equal to the given value from a list.
`LSET`	Set the list element at the given index.
`LTRIM`	Trim a list to the given range.
`RPOP`	Pop one or more elements from the tail of a list.
`RPOPLPUSH`	Pop the source tail and push it onto the destination head.
`RPUSH`	Append one or more elements to a list.

migration

`PREFIX.DIGEST`	Order-insensitive checksum of a prefix's rows for migration verification.
`PREFIX.STATS`	Report key-count and byte statistics for a key prefix.

pubsub

`PSUBSCRIBE`	Subscribe to channels matching the given glob patterns.
`PUBLISH`	Post a message to a channel; returns the receiver count.
`PUNSUBSCRIBE`	Unsubscribe from patterns (all patterns when none given).
`SUBSCRIBE`	Subscribe to the given channels.
`UNSUBSCRIBE`	Unsubscribe from channels (all channels when none given).

replication

`FAILOVER`	Planned zero-loss handover: quiesce writes, wait for the target replica to drain, promote it, and follow it.
`REPL.TOKEN`	kevy extension: mint a read-your-writes token — per-shard [generation, offset] pairs (a primary reports its live feed tail; a replica its applied positions).
`REPL.WAIT`	kevy extension: on a replica, block until every shard has applied the given REPL.TOKEN (then reads are read-your-writes); +OK on success, -MISDIRECTED writer is <primary> on timeout or generation mismatch. Default TIMEOUT 1000 ms, hard cap 60 s. On a primary: immediate +OK.
`REPLICAOF`	Make this server a replica of another, or promote it with NO ONE.
`ROLE`	Report the replication role and state of this server.
`SLAVEOF`	Legacy alias of REPLICAOF.
`WAIT`	Block until every shard's master_repl_offset is acknowledged by at least numreplicas replicas (or timeout ms pass); returns the minimum acked-replica count across shards. timeout 0 = wait forever, hard-capped at 60 s. NOTE: a replica ACK is not fsync durability.

scan

`KEYS`	Return every key matching the glob pattern (cross-shard gather).
`RANDOMKEY`	Return a random key from the keyspace.
`SCAN`	Iterate the keyspace incrementally: each call walks ~COUNT buckets of one shard and returns the next cursor.

script

`EVAL`	Run a Lua script server-side; routed to KEYS[1]'s shard when numkeys >= 1.
`EVALSHA`	Run a cached Lua script by its SHA1 digest.
`SCRIPT`	Manage the process-wide Lua script cache.

server

`BGREWRITEAOF`	Start an append-only-file rewrite in the background.
`BGSAVE`	Start a snapshot save in the background.
`CLIENT`	Connection introspection and control subcommands.
`CLUSTER`	Cluster topology introspection (virtual-node model over shards).
`COMMAND`	Introspect the command table (COUNT, LIST, INFO, DOCS subcommands).
`CONFIG`	Read or change server configuration parameters.
`DBSIZE`	Return the number of keys across all shards.
`DEBUG`	Debug subcommands; SLEEP blocks the shard, other subcommands are tolerated as OK.
`FLUSHALL`	Delete every key on every shard.
`FLUSHDB`	Delete every key of the current database (kevy is single-DB: same as FLUSHALL).
`INFO`	Report server statistics and status sections as text.
`MEMORY`	Memory introspection subcommands.
`SAVE`	Synchronously snapshot the dataset to disk.
`SHUTDOWN`	Stop the server process (connection drops without a reply).
`SLOWLOG`	Inspect or reset the slow-command log.
`TIME`	Return the server clock as unix seconds and microseconds.

set

`SADD`	Add one or more members to a set.
`SCARD`	Return the number of members in a set.
`SDIFF`	Return the difference of the given sets (cross-shard gather).
`SDIFFSTORE`	Store the difference of the given sets into destination.
`SINTER`	Return the intersection of the given sets (cross-shard gather).
`SINTERSTORE`	Store the intersection of the given sets into destination.
`SISMEMBER`	Check whether a value is a member of a set.
`SMEMBERS`	Return all members of a set.
`SPOP`	Remove and return one or more random members of a set.
`SRANDMEMBER`	Return one or more random members of a set without removing them. A negative count allows repeats.
`SREM`	Remove one or more members from a set.
`SSCAN`	Iterate a set's members (single-batch cursor).
`SUNION`	Return the union of the given sets (cross-shard gather).
`SUNIONSTORE`	Store the union of the given sets into destination.

stream

`XACK`	Acknowledge pending entries for a consumer group.
`XADD`	Append an entry to a stream, with optional trim.
`XAUTOCLAIM`	Scan and claim idle pending entries starting from a cursor.
`XCLAIM`	Claim specific idle pending entries for a consumer.
`XDEL`	Delete entries from a stream by ID.
`XGROUP`	Manage stream consumer groups.
`XINFO`	Introspect a stream, its groups, or its consumers.
`XLEN`	Return the number of entries in a stream.
`XPENDING`	Inspect pending entries of a consumer group (summary or extended form).
`XRANGE`	Return stream entries within an ID range.
`XREAD`	Read new entries from one or more streams, optionally blocking.
`XREADGROUP`	Read stream entries as a consumer-group member, optionally blocking.
`XREVRANGE`	Return stream entries within an ID range, in reverse order.
`XSETID`	Overwrite a stream's last-generated ID and bookkeeping counters.
`XTRIM`	Trim a stream by length or minimum ID.

string

`APPEND`	Append bytes to a string value; returns the new length.
`BITCOUNT`	Count set bits in a string, optionally over a byte range.
`BITOP`	Combine strings bitwise into a destination key.
`BITPOS`	Return the position of the first bit set to 0 or 1.
`DECR`	Decrement the integer value of a key by one.
`DECRBY`	Decrement the integer value of a key by the given amount.
`GET`	Return the string value of a key.
`GETBIT`	Return the bit at the given offset of a string.
`GETDEL`	Return the string value of a key and delete it.
`GETEX`	Read a key and set its expiry in the same call.
`GETRANGE`	Return a byte range of a string value.
`GETSET`	Set a key's string value and return its previous value.
`INCR`	Increment the integer value of a key by one.
`INCRBY`	Increment the integer value of a key by the given amount.
`INCRBYFLOAT`	Increment the float value of a key by the given amount.
`MGET`	Return the values of multiple keys (cross-shard gather).
`MSET`	Set multiple key/value pairs atomically per shard.
`PSETEX`	Set a key's value with a TTL in milliseconds.
`SET`	Set a key's string value with optional TTL and existence conditions.
`SETBIT`	Set the bit at the given offset, returning its old value.
`SETEX`	Set a key's value with a TTL in seconds.
`SETNX`	Set a key's value only if it does not exist.
`SETRANGE`	Overwrite a string from the given offset, returning the new length.
`STRLEN`	Return the length of a key's string value.

table

`TABLE.DECLARE`	Declare a relational table that compiles at declare time into named indexes (catalog mutation, sidecar-persisted).
`TABLE.DROP`	Drop a declared table and its compiled indexes (catalog mutation, sidecar-persisted).
`TABLE.ENSURE`	TABLE.DECLARE's boot form: identical existing declaration answers +UNCHANGED, a different one is a named refusal saying which part differs — never a silent rebuild.
`TABLE.LIST`	List declared tables with their prefix, PK and declaration counts.
`TABLE.REPLACE`	Drop and redeclare in one verb, rebuilding every compiled index from the rows. Named for its cost: a full backfill, asked for explicitly. A bad spec refuses BEFORE the old table drops.
`TABLE.VERIFY`	Verify a table: each compiled index's full drift recheck plus a bounded column-type spot check over sampled rows.

tx

`DISCARD`	Abort the open MULTI transaction.
`EXEC`	Execute every command queued since MULTI.
`MULTI`	Start a transaction; subsequent commands are queued until EXEC.
`UNWATCH`	Forget all watched keys.
`WATCH`	Watch keys for optimistic locking of the next EXEC.

view

`VIEW.CREATE`	Declare a composed view over indexes with an ORDER BY (catalog mutation, sidecar-persisted).
`VIEW.DROP`	Drop a declared view (catalog mutation, sidecar-persisted).
`VIEW.EXPLAIN`	Explain a view's composition tree with per-leaf cardinalities.
`VIEW.LIST`	List declared views with their mode and shape.
`VIEW.QUERY`	Page through a view's ordered members, optionally hydrating fields via the VIA template.
`VIEW.REBUILD`	Force a rebuild of a materialized view.
`VIEW.VERIFY`	Verify a view and report member/byte statistics.

zset

`BZPOPMIN`	Blocking pop of the lowest-scored member across one or more sorted sets.
`ZADD`	Add members with scores to a sorted set, with conditional flags.
`ZCARD`	Return the number of members in a sorted set.
`ZCOUNT`	Count members with scores within the given bounds.
`ZDIFFSTORE`	Store the difference of the given sorted sets into destination.
`ZINCRBY`	Increment a member's score in a sorted set.
`ZINTERCARD`	Return the cardinality of the intersection of the given sorted sets.
`ZINTERSTORE`	Store the intersection of the given sorted sets into destination.
`ZPOPMIN`	Pop up to count members with the lowest scores.
`ZPOPMIN.BELOW`	kevy extension: pop up to count lowest members with score strictly below the threshold (delayed-job primitive).
`ZRANGE`	Return members by rank range.
`ZRANGEBYSCORE`	Return members with scores within the given bounds.
`ZRANK`	Return a member's rank, ordered from the lowest score.
`ZREM`	Remove one or more members from a sorted set.
`ZREMRANGEBYRANK`	Remove members within the given rank range.
`ZREMRANGEBYSCORE`	Remove members with scores within the given bounds.
`ZREVRANGE`	Return members by rank range, highest score first.
`ZREVRANGEBYSCORE`	Return members with scores within the given bounds, highest first.
`ZSCAN`	Iterate a sorted set's members and scores (single-batch cursor).
`ZSCORE`	Return a member's score.
`ZUNIONSTORE`	Store the union of the given sorted sets into destination.