You've already forked node-redis
mirror of
https://github.com/redis/node-redis.git
synced 2025-08-07 13:22:56 +03:00
@@ -1,6 +1,6 @@
|
|||||||
# @redis/json
|
# @redis/json
|
||||||
|
|
||||||
This package provides support for the [RedisJSON](https://redisjson.io) module, which adds JSON as a native data type to Redis. It extends the [Node Redis client](https://github.com/redis/node-redis) to include functions for each of the RedisJSON commands.
|
This package provides support for the [RedisJSON](https://redis.io/docs/stack/json/) module, which adds JSON as a native data type to Redis. It extends the [Node Redis client](https://github.com/redis/node-redis) to include functions for each of the RedisJSON commands.
|
||||||
|
|
||||||
To use these extra commands, your Redis server must have the RedisJSON module installed.
|
To use these extra commands, your Redis server must have the RedisJSON module installed.
|
||||||
|
|
||||||
@@ -10,7 +10,7 @@ For a complete example, see [`managing-json.js`](https://github.com/redis/node-r
|
|||||||
|
|
||||||
### Storing JSON Documents in Redis
|
### Storing JSON Documents in Redis
|
||||||
|
|
||||||
The [`JSON.SET`](https://oss.redis.com/redisjson/commands/#jsonset) command stores a JSON value at a given JSON Path in a Redis key.
|
The [`JSON.SET`](https://redis.io/commands/json.set/) command stores a JSON value at a given JSON Path in a Redis key.
|
||||||
|
|
||||||
Here, we'll store a JSON document in the root of the Redis key "`mydoc`":
|
Here, we'll store a JSON document in the root of the Redis key "`mydoc`":
|
||||||
|
|
||||||
@@ -37,11 +37,11 @@ await client.json.set('noderedis:jsondata', '$', {
|
|||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
|
||||||
For more information about RedisJSON's path syntax, [check out the documentation](https://oss.redis.com/redisjson/path/).
|
For more information about RedisJSON's path syntax, [check out the documentation](https://redis.io/docs/stack/json/path/).
|
||||||
|
|
||||||
### Retrieving JSON Documents from Redis
|
### Retrieving JSON Documents from Redis
|
||||||
|
|
||||||
With RedisJSON, we can retrieve all or part(s) of a JSON document using the [`JSON.GET`]() command and one or more JSON Paths. Let's get the name and age of one of the pets:
|
With RedisJSON, we can retrieve all or part(s) of a JSON document using the [`JSON.GET`](https://redis.io/commands/json.get/) command and one or more JSON Paths. Let's get the name and age of one of the pets:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
const results = await client.json.get('noderedis:jsondata', {
|
const results = await client.json.get('noderedis:jsondata', {
|
||||||
@@ -62,19 +62,19 @@ const results = await client.json.get('noderedis:jsondata', {
|
|||||||
|
|
||||||
RedisJSON includes commands that can atomically update values in a JSON document, in place in Redis without having to first retrieve the entire document.
|
RedisJSON includes commands that can atomically update values in a JSON document, in place in Redis without having to first retrieve the entire document.
|
||||||
|
|
||||||
Using the [`JSON.NUMINCRBY`](https://oss.redis.com/redisjson/commands/#jsonnumincrby) command, we can update the age of one of the pets like this:
|
Using the [`JSON.NUMINCRBY`](https://redis.io/commands/json.numincrby/) command, we can update the age of one of the pets like this:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
await client.json.numIncrBy('noderedis:jsondata', '.pets[1].age', 1);
|
await client.json.numIncrBy('noderedis:jsondata', '.pets[1].age', 1);
|
||||||
```
|
```
|
||||||
|
|
||||||
And we can add a new object to the pets array with the [`JSON.ARRAPPEND`](https://oss.redis.com/redisjson/commands/#jsonarrappend) command:
|
And we can add a new object to the pets array with the [`JSON.ARRAPPEND`](https://redis.io/commands/json.arrappend/) command:
|
||||||
|
|
||||||
```javascript
|
```javascript
|
||||||
await client.json.arrAppend('noderedis:jsondata', '.pets', {
|
await client.json.arrAppend('noderedis:jsondata', '.pets', {
|
||||||
name: 'Robin',
|
name: 'Robin',
|
||||||
species: 'bird',
|
species: 'bird',
|
||||||
age: 1,
|
age: 1,
|
||||||
isMammal: false
|
isMammal: false
|
||||||
});
|
});
|
||||||
```
|
```
|
||||||
|
Reference in New Issue
Block a user