Skip to content

Commit bf23f92

Browse files
Debrands RedisJSON
1 parent 1afd5de commit bf23f92

File tree

6 files changed

+29
-30
lines changed

6 files changed

+29
-30
lines changed

docs/docs/_index.md

+10-10
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ scientific_name = r.json().get('doc', '$..scientific-name')
154154

155155
### Run with Docker
156156

157-
To run JSON with Docker, use the `redis-stack-server` Docker image:
157+
To run RedisJSON with Docker, use the `redis-stack-server` Docker image:
158158

159159
```sh
160160
$ docker run -d --name redis-stack-server -p 6379:6379 redis/redis-stack-server:latest
@@ -164,19 +164,19 @@ For more information about running Redis Stack in a Docker container, see [Run R
164164

165165
### Download binaries
166166

167-
To download and run JSON from a precompiled binary:
167+
To download and run the RedisJSON module that provides the JSON data structure from a precompiled binary:
168168

169-
1. Download a precompiled version of Search and Query from the [Redis download center](https://redis.com/download-center/modules/).
169+
1. Download a precompiled version from the [Redis download center](https://redis.com/download-center/modules/).
170170

171-
1. Run Redis with JSON:
171+
2. Load the module it in Redis
172172

173173
```sh
174174
$ redis-server --loadmodule /path/to/module/src/rejson.so
175175
```
176176

177177
### Build from source
178178

179-
To build JSON from the source code:
179+
To build RedisJSON from the source code:
180180

181181
1. Clone the [repository](https://github.com/RedisJSON/RedisJSON) (make sure you include the `--recursive` option to properly clone submodules):
182182

@@ -210,7 +210,7 @@ Otherwise, you can invoke
210210
$ ./deps/readies/bin/getredis
211211
```
212212

213-
To load the JSON module, use one of the following methods:
213+
To load the RedisJSON module, use one of the following methods:
214214

215215
* [Makefile recipe](#makefile-recipe)
216216
* [Configuration file](#configuration-file)
@@ -219,7 +219,7 @@ To load the JSON module, use one of the following methods:
219219

220220
#### Makefile recipe
221221

222-
Run Redis with JSON:
222+
Run Redis with RedisJSON:
223223

224224
```sh
225225
$ make run
@@ -241,9 +241,9 @@ loadmodule /path/to/module/target/release/librejson.dylib
241241

242242
In the above lines replace `/path/to/module/` with the actual path to the module.
243243

244-
Alternatively, you can download and run JSON from a precompiled binary:
244+
Alternatively, you can download and run Redis from a precompiled binary:
245245

246-
1. Download a precompiled version of JSON from the [Redis download center](https://redis.com/download-center/modules/).
246+
1. Download a precompiled version of RedisJSON from the [Redis download center](https://redis.com/download-center/modules/).
247247

248248
#### Command-line option
249249

@@ -257,7 +257,7 @@ In the above lines replace `/path/to/module/` with the actual path to the module
257257
258258
#### `MODULE LOAD` command
259259
260-
You can also use the `MODULE LOAD` command to load JSON. Note that `MODULE LOAD` is a **dangerous command** and may be blocked/deprecated in the future due to security considerations.
260+
You can also use the `MODULE LOAD` command to load RedisJSON. Note that `MODULE LOAD` is a **dangerous command** and may be blocked/deprecated in the future due to security considerations.
261261
262262
After the module has been loaded successfully, the Redis log should have lines similar to:
263263

docs/docs/developer.md

+8-8
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@ description: >
88

99
# Developing Redis JSON
1010

11-
Developing Redis JSON involves setting up the development environment (which can be either Linux-based or macOS-based), building JSON, running tests and benchmarks, and debugging both the JSON module and its tests.
11+
Developing Redis JSON involves setting up the development environment (which can be either Linux-based or macOS-based), building RedisJSON (the Redis module providing JSON), running tests and benchmarks, and debugging both the JSON module and its tests.
1212

1313
## Cloning the git repository
14-
To clone the JSON module and its submodules, run:
14+
To clone the RedisJSON module and its submodules, run:
1515
```sh
1616
git clone --recursive https://github.com/RedisJSON/RedisJSON.git
1717
```
@@ -38,13 +38,13 @@ rejson=$(docker run -d -it -v $PWD:/build redisjson1 bash)
3838
docker exec -it $rejson bash
3939
```
4040

41-
You can replace `debian:bullseye` with your OS of choice. If you use the same OS as your host machine, you can run the JSON binary on your host after it is built.
41+
You can replace `debian:bullseye` with your OS of choice. If you use the same OS as your host machine, you can run the RedisJSON binary on your host after it is built.
4242

4343
## Installing prerequisites
4444

45-
To build and test JSON one needs to install several packages, depending on the underlying OS. Currently, we support the Ubuntu/Debian, CentOS, Fedora, and macOS.
45+
To build and test RedisJSON one needs to install several packages, depending on the underlying OS. Currently, we support the Ubuntu/Debian, CentOS, Fedora, and macOS.
4646

47-
Enter `RedisJSON` directory and run:
47+
Enter the `RedisJSON` directory and run:
4848

4949
```sh
5050
$ ./sbin/setup
@@ -124,13 +124,13 @@ make sanbox # create container for CLang Sanitizer tests
124124
```
125125

126126
## Building from source
127-
Run ```make build``` to build JSON.
127+
Run ```make build``` to build RedisJSON.
128128

129129
Notes:
130130

131131
* Binary files are placed under `target/release/`, according to platform and build variant.
132132

133-
* JSON uses [Cargo](https://github.com/rust-lang/cargo) as its build system. ```make build``` will invoke both Cargo and the subsequent `make` command that's required to complete the build.
133+
* RedisJSON uses [Cargo](https://github.com/rust-lang/cargo) as its build system. ```make build``` will invoke both Cargo and the subsequent `make` command that's required to complete the build.
134134

135135
Use ```make clean``` to remove built artifacts. ```make clean ALL=1``` will remove the entire bin subdirectory.
136136

@@ -154,7 +154,7 @@ $ REDIS_PORT=6379 make test
154154
```
155155

156156
## Debugging
157-
To include debugging information, you need to set the `DEBUG` environment variable before you compile JSON. For example, run `export DEBUG=1`.
157+
To include debugging information, you need to set the `DEBUG` environment variable before you compile RedisJSON. For example, run `export DEBUG=1`.
158158

159159
You can add breakpoints to Python tests in single-test mode. To set a breakpoint, call the ```BB()``` function inside a test.
160160

docs/docs/indexing_JSON.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,6 @@ description: Combine Redis JSON and Search and Query to index and search JSON do
77

88
In addition to storing JSON documents, you can also index them using the [Search and Query](/docs/stack/search) feature. This enables full-text search capabilities and document retrieval based on their content.
99

10-
To use these features, you must install two modules: JSON and Search and Query. [Redis Stack](/docs/stack) automatically includes both modules.
10+
To use these features, you must install two modules: RedisJSON and RediSearch. [Redis Stack](/docs/stack) automatically includes both modules.
1111

12-
See the [tutorial](/docs/stack/search/indexing_json) to learn how to use Search and Query with JSON.
12+
See the [tutorial](/docs/stack/search/indexing_json) to learn how to search and query your JSON.

docs/docs/path.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ And if multi-paths are used, the return value is a JSON string with a top-level
1616

1717
## JSONPath support
1818

19-
JSON v2.0 introduced [JSONPath](http://goessner.net/articles/JsonPath/) support. It follows the syntax described by Goessner in his [article](http://goessner.net/articles/JsonPath/).
19+
RedisJSON v2.0 introduced [JSONPath](http://goessner.net/articles/JsonPath/) support. It follows the syntax described by Goessner in his [article](http://goessner.net/articles/JsonPath/).
2020

2121
A JSONPath query can resolve to several locations in a JSON document. In this case, the JSON commands apply the operation to every possible location. This is a major improvement over [legacy path](#legacy-path-syntax) queries, which only operate on the first path.
2222

@@ -248,11 +248,11 @@ JSONPath queries also work with other JSON commands that accept a path as an arg
248248

249249
## Legacy path syntax
250250

251-
JSON v1 had the following path implementation. JSON v2 still supports this legacy path in addition to JSONPath.
251+
RedisJSON v1 had the following path implementation. JSON v2 still supports this legacy path in addition to JSONPath.
252252

253253
Paths always begin at the root of a Redis JSON value. The root is denoted by a period character (`.`). For paths that reference the root's children, it is optional to prefix the path with the root.
254254

255-
JSON supports both dot notation and bracket notation for object key access. The following paths refer to _headphones_, which is a child of _inventory_ under the root:
255+
Redis JSON supports both dot notation and bracket notation for object key access. The following paths refer to _headphones_, which is a child of _inventory_ under the root:
256256

257257
* `.inventory.headphones`
258258
* `inventory["headphones"]`

docs/docs/performance/_index.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,7 @@ The following figures were obtained from an AWS EC2 c4.8xlarge instance that ran
1414
server as well the as the benchmarking tool. Connections to the server are via the networking stack.
1515
All tests are non-pipelined.
1616

17-
> NOTE: The results below are measured using the preview version of Redis JSON, which is still very much
18-
unoptimized.
17+
> NOTE: The results below are measured using the preview version of Redis JSON, which is still very much unoptimized.
1918
2019
## Redis JSON baseline
2120

@@ -97,7 +96,7 @@ performance of the module:
9796

9897
## Comparison vs. server-side Lua scripting
9998

100-
We compare JSON's performance with Redis' embedded Lua engine. For this purpose, we use the Lua
99+
We compare Redis Stack's JSON performance with Redis' embedded Lua engine. For this purpose, we use the Lua
101100
scripts at [/benchmarks/lua](https://github.com/RedisLabsModules/redisjson/tree/master/benchmarks/lua).
102101
These scripts provide JSON's GET and SET functionality on values stored in JSON or MessagePack
103102
formats. Each of the different operations (set root, get root, set path and get path) is executed

docs/docs/use_cases.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -10,16 +10,16 @@ aliases:
1010

1111
You can of course use Redis native data structures to store JSON objects, and that's a common practice. For example, you can serialize JSON and save it in a Redis String.
1212

13-
However, RedisJSON provides several benefits over this approach.
13+
However, Redis JSON provides several benefits over this approach.
1414

1515
**Access and retrieval of subvalues**
1616

17-
With RedisJSON, you can get nested values without having to transmit the entire object over the network. Being able to access sub-objects can lead to greater efficiencies when you're storing large JSON objects in Redis.
17+
With JSON, you can get nested values without having to transmit the entire object over the network. Being able to access sub-objects can lead to greater efficiencies when you're storing large JSON objects in Redis.
1818

1919
**Atomic partial updates**
2020

21-
RedisJSON allows you to atomically run operations like incrementing a value, adding, or removing elements from an array, append strings, and so on. To do the same with a serialized object, you have to retrieve and then reserialize the entire object, which can be expensive and also lack atomicity.
21+
JSON allows you to atomically run operations like incrementing a value, adding, or removing elements from an array, append strings, and so on. To do the same with a serialized object, you have to retrieve and then reserialize the entire object, which can be expensive and also lack atomicity.
2222

2323
**Indexing and querying**
2424

25-
When you store JSON objects as Redis strings, there's no good way to query those objects. On the other hand, storing these objects as JSON using RedisJSON lets you index and query them. This is provided by RediSearch.
25+
When you store JSON objects as Redis strings, there's no good way to query those objects. On the other hand, storing these objects as JSON using Redis Stack lets you index and query them. This is provided by the search and query capabilities of Redis Stack.

0 commit comments

Comments
 (0)