Skip to content

doc: add Redis SET commands to Materia KV #855

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
davlgd merged 1 commit into from
Feb 5, 2026
+39 −2
Merged

doc: add Redis SET commands to Materia KV #855

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions content/changelog/2026/02-05-materia-kv-set.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: "Materia KV supports Set value type"

Check failure on line 2 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L2 

[Vale.Spelling] Did you really mean 'Materia'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'Materia'?", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 2, "column": 9}}}, "severity": "ERROR"}
description: Manage sets in Materia KV with new commands such as SADD, SREM, SMEMBERS, SISMEMBER or SCARD.

Check notice on line 3 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L3 

[Google.Acronyms] Spell out 'SADD', if it's unfamiliar to the audience.
Raw output 
{"message": "[Google.Acronyms] Spell out 'SADD', if it's unfamiliar to the audience.", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 3, "column": 66}}}, "severity": "INFO"}

Check notice on line 3 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L3 

[Google.Acronyms] Spell out 'SREM', if it's unfamiliar to the audience.
Raw output 
{"message": "[Google.Acronyms] Spell out 'SREM', if it's unfamiliar to the audience.", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 3, "column": 72}}}, "severity": "INFO"}

Check notice on line 3 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L3 

[Google.Acronyms] Spell out 'SCARD', if it's unfamiliar to the audience.
Raw output 
{"message": "[Google.Acronyms] Spell out 'SCARD', if it's unfamiliar to the audience.", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 3, "column": 101}}}, "severity": "INFO"}
date: 2026-02-05
tags:
- addons
- materia
- kv
authors:
- name: David Legrand
link: https://github.com/davlgd
image: https://github.com/davlgd.png?size=40
excludeSearch: true
---

[Materia KV](/doc/addons/materia-kv/) now supports multiple commands to create and manage sets. You don't have anything to change in your configuration to benefit from this new feature, just use the new supported commands in your applications.

Check failure on line 16 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L16 

[Vale.Spelling] Did you really mean 'Materia'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'Materia'?", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 16, "column": 2}}}, "severity": "ERROR"}

- [Learn more about Materia KV](/doc/addons/materia-kv/)

Check failure on line 18 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L18 

[Vale.Spelling] Did you really mean 'Materia'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'Materia'?", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 18, "column": 21}}}, "severity": "ERROR"}
- [Learn more about Materia KV supported commands](/doc/addons/materia-kv/#supported-types-and-commands)

Check failure on line 19 in content/changelog/2026/02-05-materia-kv-set.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/changelog/2026/02-05-materia-kv-set.md#L19 

[Vale.Spelling] Did you really mean 'Materia'?
Raw output 
{"message": "[Vale.Spelling] Did you really mean 'Materia'?", "location": {"path": "content/changelog/2026/02-05-materia-kv-set.md", "range": {"start": {"line": 19, "column": 21}}}, "severity": "ERROR"}
22 changes: 20 additions & 2 deletions content/doc/addons/materia-kv.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,7 @@
Supported value types are:

- Hash
- Set
- String

Find below the list of currently supported commands:
Expand Down Expand Up @@ -180,13 +181,30 @@
| `PERSIST` | Remove the existing time to live associated with the `key`. |
| `PEXPIRE` | Set a `key` time to live in milliseconds. After the timeout has expired, the `key` will be automatically deleted. The time to live can be updated using the `PEXPIRE` command or cleared using the `PERSIST` command. |
| `PING` | Returns `PONG` if no argument is provided, otherwise return a copy of the argument as a bulk. |
| `PTTL` | RReturns the remaining time to live of a `key`, in milliseconds. |
| `PTTL` | Returns the remaining time to live of a `key`, in milliseconds. |
| `SADD` | Add the specified members to the set stored at `key`. Specified members that are already a member of this set are ignored. If `key` doesn't exist, a new set is created before adding the specified members. |

Check notice on line 185 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L185 

[Google.Passive] In general, use active voice instead of passive voice ('are ignored').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are ignored').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 185, "column": 122}}}, "severity": "INFO"}

Check notice on line 185 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L185 

[Google.Passive] In general, use active voice instead of passive voice ('is created').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is created').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 185, "column": 169}}}, "severity": "INFO"}
| `SCAN` | Incrementally iterate over a collection of elements. It is a cursor based iterator, this means that at every call of the command, the server returns an updated cursor that the user needs to use as the cursor argument in the next call. An iteration starts when the cursor is set to `0`, and terminates when the cursor returned by the server is `0`. |
| `SCARD` | Returns the set cardinality (number of elements) of the set stored at `key`. |
| `SDIFF` | Returns the members of the set resulting from the difference between the first set and all the successive sets. |
| `SDIFFSTORE` | This command is equal to `SDIFF`, but instead of returning the resulting set, it is stored in `destination`. If `destination` already exists, it is overwritten. |

Check notice on line 189 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L189 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 189, "column": 96}}}, "severity": "INFO"}

Check notice on line 189 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L189 

[Google.Passive] In general, use active voice instead of passive voice ('is stored').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is stored').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 189, "column": 99}}}, "severity": "INFO"}

Check notice on line 189 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L189 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 189, "column": 160}}}, "severity": "INFO"}
| `SET` | Set `key` to hold the string `value`. If key already holds a value, it is overwritten, regardless of its type. |
| `SETBIT` | Sets or clears the bit at offset in the string value stored at `key`. |
| `SINTER` | Returns the members of the set resulting from the intersection of all the given sets. |
| `SINTERCARD` | Returns the number of elements that would result from the intersection of all given sets. |
| `SINTERSTORE` | This command is equal to `SINTER`, but instead of returning the resulting set, it is stored in `destination`. If `destination` already exists, it is overwritten. |

Check notice on line 194 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L194 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 194, "column": 98}}}, "severity": "INFO"}

Check notice on line 194 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L194 

[Google.Passive] In general, use active voice instead of passive voice ('is stored').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is stored').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 194, "column": 101}}}, "severity": "INFO"}

Check notice on line 194 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L194 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 194, "column": 162}}}, "severity": "INFO"}
| `SISMEMBER` | Returns if `member` is a member of the set stored at `key`. |
| `SMEMBERS` | Returns all the members of the set value stored at `key`. |
| `SMISMEMBER` | Returns whether each member is a member of the set stored at `key`. For every member, `1` is returned if the value is a member of the set, or `0` if the element is not a member of the set or if `key` doesn't exist. |

Check notice on line 197 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L197 

[Google.Passive] In general, use active voice instead of passive voice ('is returned').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is returned').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 197, "column": 108}}}, "severity": "INFO"}

Check notice on line 197 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L197 

[Google.Contractions] Use 'isn't' instead of 'is not'.
Raw output 
{"message": "[Google.Contractions] Use 'isn't' instead of 'is not'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 197, "column": 179}}}, "severity": "INFO"}
| `SMOVE` | Move `member` from the set at `source` to the set at `destination`. This operation is atomic. In every given moment the element will appear to be a member of `source` or `destination` for other clients. |

Check warning on line 198 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L198 

[Google.Will] Avoid using 'will'.
Raw output 
{"message": "[Google.Will] Avoid using 'will'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 198, "column": 141}}}, "severity": "WARNING"}
| `SPOP` | Removes and returns one or more random members from the set value stored at `key`. |
| `SRANDMEMBER` | When called with just the `key` argument, return a random element from the set value stored at `key`. |
| `SREM` | Remove the specified members from the set stored at `key`. Specified members that are not a member of this set are ignored. If `key` doesn't exist, it is treated as an empty set and this command returns `0`. |

Check notice on line 201 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L201 

[Google.Contractions] Use 'aren't' instead of 'are not'.
Raw output 
{"message": "[Google.Contractions] Use 'aren't' instead of 'are not'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 201, "column": 94}}}, "severity": "INFO"}

Check notice on line 201 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L201 

[Google.Passive] In general, use active voice instead of passive voice ('are ignored').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('are ignored').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 201, "column": 123}}}, "severity": "INFO"}

Check notice on line 201 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L201 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 201, "column": 160}}}, "severity": "INFO"}

Check notice on line 201 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L201 

[Google.Passive] In general, use active voice instead of passive voice ('is treated').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is treated').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 201, "column": 163}}}, "severity": "INFO"}
| `SSCAN` | Incrementally iterate over set elements. It is a cursor based iterator, this means that at every call of the command, the server returns an updated cursor that the user needs to use as the cursor argument in the next call. An iteration starts when the cursor is set to `0`, and terminates when the cursor returned by the server is `0`. |

Check notice on line 202 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L202 

[Google.Contractions] Use 'it's' instead of 'It is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'It is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 202, "column": 54}}}, "severity": "INFO"}

Check notice on line 202 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L202 

[Google.Passive] In general, use active voice instead of passive voice ('is set').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is set').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 202, "column": 272}}}, "severity": "INFO"}
| `SUNION` | Returns the members of the set resulting from the union of all the given sets. |
| `SUNIONSTORE` | This command is equal to `SUNION`, but instead of returning the resulting set, it is stored in `destination`. If `destination` already exists, it is overwritten. |

Check notice on line 204 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L204 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 204, "column": 98}}}, "severity": "INFO"}

Check notice on line 204 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L204 

[Google.Passive] In general, use active voice instead of passive voice ('is stored').
Raw output 
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is stored').", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 204, "column": 101}}}, "severity": "INFO"}

Check notice on line 204 in content/doc/addons/materia-kv.md

View workflow job for this annotation

GitHub Actions / vale

[vale] content/doc/addons/materia-kv.md#L204 

[Google.Contractions] Use 'it's' instead of 'it is'.
Raw output 
{"message": "[Google.Contractions] Use 'it's' instead of 'it is'.", "location": {"path": "content/doc/addons/materia-kv.md", "range": {"start": {"line": 204, "column": 162}}}, "severity": "INFO"}
| `STRLEN` | Returns the length of the string value stored at `key`. An error is returned when key holds a non-string value. |
| `TTL` | Returns the remaining time to live of a `key`, in seconds. |
| `TYPE` | Returns the string representation of the type of the value stored at `key`. Can be: `hash`, `list` or `string`. |
| `TYPE` | Returns the string representation of the type of the value stored at `key`. Can be: `hash`, `list`, `set` or `string`. |

### JSON commands

Expand Down
Loading