Dragonfly Docs

https://www.dragonflydb.io/docs
Admin
Dragonfly is a modern, multi-threaded in-memory datastore fully compatible with Redis and Memcached...
Tokens:478,254
Snippets:4,613
Trust Score:9.8
Update:3 hours ago
Show doc for...
Tokens:
Raw
### Basic GET Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/get

Retrieves the value of a key after setting it. Shows the expected output for a successful GET.

```shell
dragonfly$> SET mykey "Hello, Dragonfly!"
OK
dragonfly$> GET mykey
"Hello, Dragonfly!"
```

--------------------------------

### Quick Start: Clone and Run Magento Docker Example

Source: https://www.dragonflydb.io/docs/integrations/magento

Commands to clone the dragonfly-examples repository, navigate to the magento-integration directory, copy the environment file, edit it with your Dragonfly IP and Magento Marketplace credentials, and start the Docker services.

```bash
git clone https://github.com/dragonflydb/dragonfly-examples.git
cd dragonfly-examples/magento-integration
cp .env.example .env
# Edit .env with your Dragonfly IP and Magento Marketplace credentials
docker compose up -d
```

--------------------------------

### Basic MSET Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/mset

Sets three key-value pairs atomically and verifies each with GET. The command returns OK and each GET returns the corresponding value.

```shell
dragonfly$> MSET key1 "value1" key2 "value2" key3 "value3"
OK
dragonfly$> GET key1
"value1"
dragonfly$> GET key2
"value2"
dragonfly$> GET key3
"value3"
```

--------------------------------

### COMMAND INFO GET example

Source: https://www.dragonflydb.io/docs/command-reference/server-management/command-info

Shows the output of COMMAND INFO GET, returning a nested array with details about the GET command, including arity, flags, key positions, and ACL categories.

```shell
dragonfly> COMMAND INFO GET
1) 1) GET
   2) (integer) 2
   3) 1) readonly
      2) fast
   4) (integer) 1
   5) (integer) 1
   6) (integer) 1
   7) 1) @READ
      2) @STRING
      3) @FAST
```

--------------------------------

### CLIENT CACHING Usage Example

Source: https://www.dragonflydb.io/docs/command-reference/server-management/client-caching

Example session showing how to use CLIENT CACHING with CLIENT TRACKING in OPTOUT and OPTIN modes. Requires RESP3 (HELLO 3). Demonstrates that CLIENT CACHING NO prevents caching of the next GET, while CLIENT CACHING YES enables caching.

```shell
# Set RESP3, which is required by client-side caching.
dragonfly> HELLO 3

dragonfly> CLIENT TRACKING ON OPTOUT
OK
dragonfly> SET user_count 100
OK

# The next command will not be cached.
dragonfly> CLIENT CACHING NO
OK
dragonfly> GET user_count
"100"

# Change client tracking mode.
dragonfly> CLIENT TRACKING ON OPTIN
OK

# The next command will be cached.
dragonfly> CLIENT CACHING YES
OK
dragonfly> GET user_count
"100"
```

--------------------------------

### HSET command examples in shell

Source: https://www.dragonflydb.io/docs/command-reference/hashes/hset

Demonstrates setting and getting hash fields using HSET, HGET, and HGETALL. Shows that HSET returns the number of fields added, and that HGET returns the value for a field. The example includes setting multiple fields in one command.

```shell
dragonfly> HSET myhash field1 "Hello"
(integer) 1
dragonfly> HGET myhash field1
"Hello"
dragonfly> HSET myhash field2 "Hi" field3 "World"
(integer) 2
dragonfly> HGET myhash field2
"Hi"
dragonfly> HGET myhash field3
"World"
dragonfly> HGETALL myhash
1) "field1"
2) "Hello"
3) "field2"
4) "Hi"
5) "field3"
6) "World"
```

--------------------------------

### Basic PSETEX Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/psetex

Sets key 'mykey' to 'hello' with 2000 ms expiration. Returns OK. Then verifies expiration by getting the key before and after 2 seconds.

```shell
dragonfly$> PSETEX mykey 2000 "hello"
OK
```

```shell
dragonfly$> GET mykey
"hello"
# Wait for more than 2 seconds
dragonfly$> GET mykey
(nil)
```

--------------------------------

### Basic GETDEL Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/getdel

Sets a key, retrieves and deletes it with GETDEL, then verifies deletion with GET. The value is returned and the key is removed.

```shell
dragonfly$> SET mykey "Hello, Dragonfly!"
OK

dragonfly$> GETDEL mykey
"Hello, Dragonfly!"

dragonfly$> GET mykey
(nil)
```

--------------------------------

### Basic Example: Setting and Getting a Bit

Source: https://www.dragonflydb.io/docs/command-reference/strings/setbit

Sets a bit at offset 7 and retrieves its original state. The output shows the original bit value (0) and the new value (1) via GETBIT.

```shell
dragonfly$> SET mykey "foo"
OK
dragonfly$> SETBIT mykey 7 1
(integer) 0  # The bit at offset 7 was originally 0, now set to 1.
dragonfly$> GETBIT mykey 7
(integer) 1  # We just set this bit to 1.
```

--------------------------------

### CONFIG HELP command example

Source: https://www.dragonflydb.io/docs/command-reference/server-management/config-help

Shows the output of the CONFIG HELP command in Dragonfly, listing the available CONFIG subcommands (GET, SET, RESETSTAT, REWRITE, HELP) and their descriptions.

```shell
dragonfly> CONFIG HELP
 1) CONFIG <subcommand> [<arg> [value] [opt] ...]. Subcommands are:
 2) GET <pattern>
 3)     Return parameters matching the glob-like <pattern> and their values.
 4) SET <directive> <value>
 5)     Set the configuration <directive> to <value>.
 6) RESETSTAT
 7)     Reset statistics reported by the INFO command.
 8) REWRITE
 9)     Rewrite the configuration file with the current configuration.
10) HELP
11)     Prints this help.
```

--------------------------------

### Basic XAUTOCLAIM Example

Source: https://www.dragonflydb.io/docs/command-reference/stream/xautoclaim

Claims messages pending for over 5 seconds. Shows setup with XGROUP CREATE, XADD, XREADGROUP, then XAUTOCLAIM with min-idle-time 5000 and start 0. The returned ID '0-0' indicates the entire stream was scanned.

```shell
dragonfly$> XGROUP CREATE mystream mygroup $ MKSTREAM
OK

dragonfly$> XADD mystream * name Alice
"1636581234567-0"

dragonfly$> XREADGROUP GROUP mygroup consumer-1 COUNT 1 STREAMS mystream >
1) 1) "mystream"
   2) 1) 1) "1636581234567-0"
         2) 1) "name"
            2) "Alice"

# Assume 'consumer-1' is unavailable and 'consumer-2' takes over.
dragonfly$> XAUTOCLAIM mystream mygroup consumer-2 5000 0
1) "0-0" # Next ID to scan from. Note that '0-0' means the entire stream was scanned.
2) 1) 1) "1736363819856-0"
      2) 1) "name"
         2) "Alice"
3) (empty array)
```

--------------------------------

### Collect performance information about an index with FT.PROFILE

Source: https://www.dragonflydb.io/docs/command-reference/search/ft.profile

This example shows how to create a hash, create an index, and run FT.PROFILE with a SEARCH query. The output includes 'took', 'hits', and 'serialized' metrics, followed by execution trees for each shard.

```bash
dragonfly> HSET blog:post:1 title "blog post 1" published_at 1701210030 category "default" description "this is a blog"
(integer) 4

dragonfly> FT.CREATE idx ON HASH PREFIX 1 blog:post: SCHEMA title TEXT SORTABLE published_at NUMERIC SORTABLE category TAG SORTABLE description TEXT NOINDEX
OK

dragonfly> FT.PROFILE idx SEARCH QUERY "@category:{default}"
1) 1) "took"
   2) (integer) 488
   3) "hits"
   4) (integer) 1
   5) "serialized"
   6) (integer) 1
2) 1) "took"
   2) (integer) 13
   3) "tree"
   4) 1) t=9          n=0          Field{category}
      2) 1) t=5          n=0          Tags{default}
3) 1) "took"
   2) (integer) 35
   3) "tree"
   4) 1) t=30         n=0          Field{category}
      2) 1) t=5          n=0          Tags{default}
4) 1) "took"
   2) (integer) 24
   3) "tree"
   4) 1) t=19         n=0          Field{category}
      2) 1) t=14         n=0          Tags{default}
5) 1) "took"
   2) (integer) 54
   3) "tree"
   4) 1) t=11         n=1          Field{category}
      2) 1) t=9          n=1          Tags{default}
6) 1) "took"
   2) (integer) 9
   3) "tree"
   4) 1) t=6          n=0          Field{category}
      2) 1) t=5          n=0          Tags{default}
```

--------------------------------

### Get help for all parameters with FT.CONFIG HELP *

Source: https://www.dragonflydb.io/docs/command-reference/search/ft.config

Returns help information for all available configuration parameters. The output shows an array of arrays, each containing parameter name, description, and value.

```bash
dragonfly> FT.CONFIG HELP *
1) 1) "MAXSEARCHRESULTS"
   2) "Description"
   3) "Maximum number of results from ft.search command"
   4) "Value"
   5) "1000000"
2) 1) "search_query_string_bytes"
   2) "Description"
   3) "Maximum number of bytes in search query string"
   4) "Value"
   5) "10240"
```

--------------------------------

### PUBSUB CHANNELS usage example

Source: https://www.dragonflydb.io/docs/command-reference/pubsub/pubsub-channels

Shows how to set up subscriptions and then use PUBSUB CHANNELS to list active channels. The example first subscribes to channels using PSUBSCRIBE and SUBSCRIBE, then demonstrates listing all channels, filtering with a pattern, and filtering with a different pattern.

```shell
users> PSUBSCRIBE h?llo
users> SUBSCRIBE hello
users> SUBSCRIBE hxxllo
users> SUBSCRIBE world
---
dragonfly> PUBSUB CHANNELS
1) "hxxllo"
2) "world"
3) "hello"
dragonfly> PUBSUB CHANNELS h*llo
1) "hxxllo"
2) "hello"
dragonfly> PUBSUB CHANNELS h?llo
1) "hello"
```

--------------------------------

### Example with Short Expiration

Source: https://www.dragonflydb.io/docs/command-reference/strings/setex

Sets a key with a 2-second expiration. Immediately after, GET returns the value; after 2 seconds, GET returns nil.

```shell
dragonfly$> SETEX anotherkey 2 "temporary_data"
OK
```

```shell
dragonfly$> GET anotherkey
"temporary_data"
```

```shell
dragonfly$> GET anotherkey
(nil)
```

--------------------------------

### TOPK.LIST command example with TOPK.RESERVE and TOPK.ADD

Source: https://www.dragonflydb.io/docs/command-reference/top-k/topk.list

This example demonstrates the full workflow of creating a Top-K structure with TOPK.RESERVE, adding items with TOPK.ADD, and then listing them with TOPK.LIST. It shows the output of TOPK.LIST both without and with the WITHCOUNT flag, which returns item-count pairs.

```shell
dragonfly> TOPK.RESERVE topk 3
OK
dragonfly> TOPK.ADD topk foo foo foo bar bar baz
1) (nil)
2) (nil)
3) (nil)
4) (nil)
5) (nil)
6) (nil)
dragonfly> TOPK.LIST topk
1) "foo"
2) "bar"
3) "baz"
dragonfly> TOPK.LIST topk WITHCOUNT
1) "foo"
2) (integer) 1
3) "bar"
4) (integer) 0
5) "baz"
6) (integer) 0
```

--------------------------------

### Basic SUBSTR Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/substr

Sets a string key and extracts the entire string using SUBSTR with start 0 and end 6. The output is "example".

```shell
dragonfly$> SET mykey "example"
OK
dragonfly$> SUBSTR mykey 0 6
"example"
```

--------------------------------

### Enable Tracking and Read Key (client-1)

Source: https://www.dragonflydb.io/docs/command-reference/server-management/client-tracking

Shows how to switch to RESP3, enable tracking, create a key, and read it to start tracking. Note that creating a key alone does not trigger tracking; the key must be read after enabling tracking.

```shell
### client-1 ###

# Switch protocol to RESP3, output omitted.
dragonfly> HELLO 3

# Switch on client tracking.
dragonfly> CLIENT TRACKING ON
OK

# Create a key and set its value to 100.
dragonfly> SET user_count 100
OK

# Read the key so that the server starts tracking its update.
dragonfly> GET user_count
"100"
```

--------------------------------

### TOPK.ADD usage example with TOPK.RESERVE and TOPK.LIST

Source: https://www.dragonflydb.io/docs/command-reference/top-k/topk.add

Shows how to create a Top-K structure with TOPK.RESERVE, add items with TOPK.ADD, and list the top items with TOPK.LIST. The key must already exist before adding items.

```shell
dragonfly> TOPK.RESERVE topk 2
OK
dragonfly> TOPK.ADD topk foo bar baz
1) (nil)
2) (nil)
3) (nil)
dragonfly> TOPK.LIST topk
1) "bar"
2) "foo"
```

--------------------------------

### ACL SETUSER and ACL DRYRUN examples

Source: https://www.dragonflydb.io/docs/command-reference/acl/dryrun

These examples show how to set up a user with permissions and test them using ACL DRYRUN. The first command creates a user 'mike' with a password and allows GET but denies SET. The subsequent DRYRUN commands simulate GET (success) and SET (failure) to verify permissions.

```shell
dragonfly> ACL SETUSER mike >mypass +GET -SET
OK
```

```shell
dragonfly> ACL DRYRUN mike GET
OK
```

```shell
dragonfly> ACL DRYRUN mike SET
"This user has no permissions to run the 'SET' command"
```

--------------------------------

### TOPK.INFO example with TOPK.RESERVE

Source: https://www.dragonflydb.io/docs/command-reference/top-k/topk.info

Shows how to create a Top-K structure with TOPK.RESERVE and then retrieve its metadata with TOPK.INFO. The output is a flat array of field-value pairs: k, width, depth, and decay.

```shell
dragonfly> TOPK.RESERVE topk 5 20 7 0.9
OK
dragonfly> TOPK.INFO topk
1) "k"
2) (integer) 5
3) "width"
4) (integer) 20
5) "depth"
6) (integer) 7
7) "decay"
8) "0.9"
```

--------------------------------

### Test Dragonfly with SET and GET commands

Source: https://www.dragonflydb.io/docs/managing-dragonfly/using-tls

Shows example redis-cli commands and their outputs to verify the data store is working: SET and GET commands return OK and the stored value.

```bash
dragonfly$> SET anchdrite 33.7
OK
dragonfly$> SET pallasite 19.1
OK
dragonfly$> GET anchdrite
"33.7"

```

--------------------------------

### Basic BITFIELD Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/bitfield

Demonstrates setting and getting an unsigned 8-bit field at offset 0. SET returns the previous value (0), and GET returns the set value (100).

```shell
dragonfly$> BITFIELD mykey SET u8 0 100
1) (integer) 0
dragonfly$> BITFIELD mykey GET u8 0
1) (integer) 100
```

--------------------------------

### PTTL command example

Source: https://www.dragonflydb.io/docs/command-reference/generic/pttl

Shows how to use PTTL to get the remaining time to live of a key in milliseconds. The example sets a key, sets an expire of 1 second, and then checks PTTL, which returns 1000 milliseconds.

```shell
dragonfly> SET mykey "Hello"
OK
dragonfly> EXPIRE mykey 1
(integer) 1
dragonfly> PTTL mykey
(integer) 1000
```

--------------------------------

### KEYS command examples

Source: https://www.dragonflydb.io/docs/command-reference/generic/keys

Shows how to use KEYS with various patterns. First, MSET creates keys, then KEYS *name* returns keys containing 'name', KEYS a?? matches keys starting with 'a' followed by two characters, and KEYS * returns all keys. The output is an array reply.

```shell
dragonfly> MSET firstname Jack lastname Stuntman age 35
OK
dragonfly> KEYS *name*
1) "lastname"
2) "firstname"
dragonfly> KEYS a??
1) "age"
dragonfly> KEYS *
1) "lastname"
2) "age"
3) "firstname"
```

--------------------------------

### Simple SET Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/set

Basic SET command that assigns a string value to a key, followed by a GET to retrieve it.

```shell
dragonfly$> SET mykey "hello"
OK
dragonfly$> GET mykey
"hello"
```

--------------------------------

### TOUCH command example

Source: https://www.dragonflydb.io/docs/command-reference/generic/touch

Example of using TOUCH after setting two keys. The output shows the integer reply 2, indicating both keys were touched.

```shell
dragonfly> SET key1 "Hello"
OK
dragonfly> SET key2 "World"
OK
dragonfly> TOUCH key1 key2
(integer) 2
```

--------------------------------

### Basic Example: Create a Consumer in a Group

Source: https://www.dragonflydb.io/docs/command-reference/stream/xgroup-createconsumer

Demonstrates creating a stream with XADD, creating a consumer group with XGROUP CREATE, and then creating a consumer named 'consumer-1' in 'mygroup'. The command returns (integer) 1 for a new consumer.

```shell
# Create a stream with items
dragonfly$> XADD mystream * field1 value1
"1609471230723-0"

dragonfly$> XGROUP CREATE mystream mygroup 0
OK

# Create a consumer named 'consumer-1' in 'mygroup'.
dragonfly$> XGROUP CREATECONSUMER mystream mygroup consumer-1
(integer) 1
```

--------------------------------

### SCAN basic usage example

Source: https://www.dragonflydb.io/docs/command-reference/generic/scan

Example of a full SCAN iteration. The first call uses cursor 0 to start, and the second call uses the returned cursor 17. The iteration finishes when the returned cursor is 0.

```shell
dragonfly> scan 0
1) "17"
2)  1) "key:12"
    2) "key:8"
    3) "key:4"
    4) "key:14"
    5) "key:16"
    6) "key:17"
    7) "key:15"
    8) "key:10"
    9) "key:3"
   10) "key:7"
   11) "key:1"
dragonfly> scan 17
1) "0"
2) 1) "key:5"
   2) "key:18"
   3) "key:0"
   4) "key:2"
   5) "key:19"
   6) "key:13"
   7) "key:6"
   8) "key:9"
   9) "key:11"
```

--------------------------------

### Basic GETBIT Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/getbit

Sets a string 'example' and retrieves bits at positions 1 and 6. The comments show the binary representation. The bit at position 1 is 1, and at position 6 is 0.

```shell
# String: example
# Hex:    0x65     0x78     0x61     0x6d     0x70     0x6c     0x65
# Binary: 01100101 01111000 01100001 01101101 01110000 01101100 01100101
dragonfly$> SET mykey "example"
OK
dragonfly$> GETBIT mykey 1
(integer) 1  # The bit at position 1 is 1.
dragonfly$> GETBIT mykey 6
(integer) 0  # The bit at position 6 is 0.
```

--------------------------------

### Example Redis commands and output

Source: https://www.dragonflydb.io/docs/getting-started/kubernetes-operator

Shows an interactive session with redis-cli: GET returns nil, SET returns OK, GET returns the value, and exit deletes the pod. Includes a note about pressing enter if no prompt appears.

```sh
If you don't see a command prompt, try pressing enter.
dragonfly-sample.default:6379> GET 1
(nil)
dragonfly-sample.default:6379> SET 1 2
OK
dragonfly-sample.default:6379> GET 1
"2"
dragonfly-sample.default:6379> exit
pod "redis-cli" deleted
```

--------------------------------

### Basic ZINTERSTORE Example

Source: https://www.dragonflydb.io/docs/command-reference/sorted-sets/zinterstore

Intersects two sorted sets zset1 and zset2, storing the result in 'out'. Scores are summed by default (e.g., 'a' gets 1+2=3, 'b' gets 2+3=5). The command returns the number of elements in the result.

```shell
dragonfly$> ZADD zset1 1 a 2 b 3 c
(integer) 3

dragonfly$> ZADD zset2 2 a 3 b 1 d
(integer) 3

dragonfly$> ZINTERSTORE out 2 zset1 zset2
(integer) 2

dragonfly$> ZRANGE out 0 -1 WITHSCORES
1) "a"
2) "3"  # Score is 1 + 2 = 3
3) "b"
4) "5"  # Score is 2 + 3 = 5
```

--------------------------------

### Verify Resources with kubectl get all

Source: https://www.dragonflydb.io/docs/managing-dragonfly/operator/prometheus-guide

Run `kubectl get all` to check that all resources have been created successfully. The output shows the expected pods, services, deployments, replicasets, and statefulsets.

```text
$ kubectl get all
NAME                                       READY   STATUS    RESTARTS         AGE
pod/dragonfly-sample-0                     1/1     Running   4 (3h50m ago)    12d
pod/dragonfly-sample-1                     1/1     Running   4 (3h50m ago)    12d
pod/prometheus-operator-744c6bb8f9-vnxw4   1/1     Running   16 (3h49m ago)   19d
pod/prometheus-prometheus-0                2/2     Running   6 (3h50m ago)    11d

NAME                          TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/dragonfly-sample      ClusterIP   10.96.2.149     <none>        6379/TCP   12d
service/kubernetes            ClusterIP   10.96.0.1       <none>        443/TCP    45d
service/prometheus-operated   ClusterIP   None            <none>        9090/TCP   11d
service/prometheus-operator   ClusterIP   None            <none>        8080/TCP   19d
service/prometheus-svc        ClusterIP   10.96.8.22      <none>        9090/TCP   11d

NAME                                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/prometheus-operator   1/1     1            1           19d

NAME                                             DESIRED   CURRENT   READY   AGE
replicaset.apps/prometheus-operator-744c6bb8f9   1         1         1       19d

NAME                                     READY   AGE
statefulset.apps/dragonfly-sample        2/2     12d
statefulset.apps/prometheus-prometheus   1/1     11d
```

--------------------------------

### STICK command usage example

Source: https://www.dragonflydb.io/docs/command-reference/generic/stick

Shows how to use STICK on existing and non-existing keys. The example first sets keys 'a' and 'b', then makes 'a' sticky (returns 1), and then attempts to make 'a', 'b', and 'c' sticky, but only 'c' is new and not already sticky, so it returns 1.

```shell
dragonfly> MSET a 1 b 2
OK
dragonfly> STICK a
(integer) 1
dragonfly> STICK a b c
(integer) 1
```

--------------------------------

### Check all resources after Grafana installation

Source: https://www.dragonflydb.io/docs/managing-dragonfly/operator/grafana-guide

Output of 'kubectl get all' showing Dragonfly, Grafana, and Prometheus resources running in the cluster.

```text
$ kubectl get all
NAME                                       READY   STATUS    RESTARTS        AGE
pod/dragonfly-sample-0                     1/1     Running   1 (171m ago)    23h
pod/dragonfly-sample-1                     1/1     Running   1 (171m ago)    23h
pod/grafana-ui-785f79fb65-rmk52            1/1     Running   1 (171m ago)    23h
pod/prometheus-operator-744c6bb8f9-vnxw4   1/1     Running   10 (170m ago)   8d
pod/prometheus-prometheus-0                2/2     Running   0               167m

NAME                          TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/dragonfly-sample      ClusterIP   10.96.2.149     <none>        6379/TCP   23h
service/grafana-ui            ClusterIP   10.96.146.235   <none>        80/TCP     23h
service/kubernetes            ClusterIP   10.96.0.1       <none>        443/TCP    33d
service/prometheus-operated   ClusterIP   None            <none>        9090/TCP   167m
service/prometheus-operator   ClusterIP   None            <none>        8080/TCP   8d

NAME                                  READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/grafana-ui            1/1     1            1           23h
deployment.apps/prometheus-operator   1/1     1            1           8d

NAME                                             DESIRED   CURRENT   READY   AGE
replicaset.apps/grafana-ui-785f79fb65            1         1         1       23h
replicaset.apps/prometheus-operator-744c6bb8f9   1         1         1       8d

NAME                                     READY   AGE
statefulset.apps/dragonfly-sample        2/2     23h
statefulset.apps/prometheus-prometheus   1/1     167m
```

--------------------------------

### Basic Example with Expiration

Source: https://www.dragonflydb.io/docs/command-reference/strings/setex

Sets a key with a 10-second expiration. After 10 seconds, the key expires and GET returns nil.

```shell
dragonfly$> SETEX mykey 10 "my_value"
OK
```

```shell
dragonfly$> GET mykey
(nil)
```

--------------------------------

### Basic SETNX Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/setnx

Sets a new key 'mykey' to 'hello' because it does not exist. Returns (integer) 1 to indicate the key was set.

```shell
dragonfly$> SETNX mykey "hello"
(integer) 1
```

--------------------------------

### BITOP NOT Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/bitop

Performs the NOT operation on a single key. The result is 1 byte and GET returns the inverted bits '\x55'.

```shell
dragonfly$> SET key1 "\xAA"  # 10101010 in binary
OK
dragonfly$> BITOP NOT result key1
(integer) 1
dragonfly$> GET result
"\x55"  # 01010101 in binary (inverted bits)
```

--------------------------------

### Run Dragonfly with default settings

Source: https://www.dragonflydb.io/docs/integrations/magento

Starts Dragonfly bound to all interfaces on port 6379. Use this for initial setup or development.

```bash
# Run Dragonfly with default settings
$> ./dragonfly --bind 0.0.0.0 --port 6379
```

--------------------------------

### Start LibreDB Studio container

Source: https://www.dragonflydb.io/docs/integrations/libredb-studio

Start LibreDB Studio container on the 'libredb-studio' network, mapping port 3000.

```sh
docker run --network libredb-studio -p 3000:3000 ghcr.io/libredb/libredb-studio:latest
```

--------------------------------

### Basic XREAD Example

Source: https://www.dragonflydb.io/docs/command-reference/stream/xread

Shows how to add entries to a stream with XADD and read them with XREAD from the beginning using ID 0. The output displays the stream entries with their IDs and fields.

```shell
dragonfly$> XADD mystream * name Alice age 30
"1609945144079-0"

dragonfly$> XADD mystream * name Bob age 25
"1609945144079-1"

dragonfly$> XREAD STREAMS mystream 0
1) 1) "mystream"
   2) 1) 1) "1609945144079-0"
         2) 1) "name"
            2) "Alice"
            3) "age"
            4) "30"
      2) 1) "1609945144079-1"
         2) 1) "name"
            2) "Bob"
            3) "age"
            4) "25"
```

--------------------------------

### BITOP XOR Example

Source: https://www.dragonflydb.io/docs/command-reference/strings/bitop

Uses the XOR operation to combine two keys. The result is 1 byte and GET returns '\xFF'.

```shell
dragonfly$> SET key1 "\x0F"
OK
dragonfly$> SET key2 "\xF0"
OK
dragonfly$> BITOP XOR result key1 key2
(integer) 1
dragonfly$> GET result
"\xFF"
```

--------------------------------

### Basic XGROUP CREATE Example

Source: https://www.dragonflydb.io/docs/command-reference/stream/xgroup-create

Creates a consumer group 'mygroup' for stream 'mystream' starting from new messages ($). Returns OK on success.

```shell
dragonfly$> XGROUP CREATE mystream mygroup $
OK
```
Tokens:
Raw