docs.sheetjs.com/docz/docs/03-demos/07-data/26-redis.md
2023-11-19 05:41:07 -05:00

8.5 KiB

title sidebar_label description pagination_prev pagination_next sidebar_custom_props
Redis Databases Wrapped in Sheets Redis Store complex datasets in Redis. Seamlessly save data to spreadsheets and read data from sheets using SheetJS. Enable Excel spreadsheet experts to update content. demos/desktop/index demos/local/index
type
nosql

import current from '/version.js'; import CodeBlock from '@theme/CodeBlock';

Redis is a open source in-memory data store. It is capable of storing sets, lists and other simple data structures.

SheetJS is a JavaScript library for reading and writing data from spreadsheets.

This demo defines a schema for storing Redis databases in spreadsheets. We'll explore how to use SheetJS and Redis NodeJS connector modules to pull data from XLSX files to a Redis database and to serialize a database to a workbook.

Overview

Redis has 5 core data types: "String", List", "Set", "Sorted Set", and "Hash". Since the keys and values are limited to simple strings (and numbers), it is possible to store complete databases in a single worksheet.

SheetJSRedis.xlsx

Integration Details

:::note pass

SheetJSRedis.mjs exports the methods:

  • redis_to_ws creates a SheetJS worksheet by querying a redis client
  • ws_to_redis creates an array of query objects from the SheetJS worksheet

:::

Array of Arrays

The shared data representation is an "array of arrays"1. Each array within the structure corresponds to one row.

The Redis to SheetJS converter generates an array of arrays of the data by running queries to fetch data from the database. The SheetJS aoa_to_sheet and sheet_add_aoa2 methods build up worksheets from arrays of arrays. Once the worksheet is created, it can be added to a SheetJS workbook object3 and exported using writeFile4.

The SheetJS to Redis converter works in reverse. Workbook files are parsed with the SheetJS readFile method5 and the desired worksheet is pulled from the workbook object. An array of arrays can be created with the sheet_to_json6 utility function. The data structure can be scanned to generate Redis queries.

Appending Columns

Since the data is column-oriented, the goal is to add the data starting on the first row of the column after the data.

To calculate the starting point for writing data, SheetJS provides encode_cell and decode_range utility functions for working with addresses and ranges7.

The following snippet takes an array of arrays of values and writes the values to a worksheet starting from the column after the worksheet range:

function add_aoa_to_next_column(worksheet, aoa) {
  /* get range of worksheet */
  const range = XLSX.utils.decode_range(worksheet["!ref"])
  /* the origin to write new data will start in the column after the range */
  const origin = XLSX.utils.encode_cell({
    r: 0, // start on first row
    c: range.e.c + 1 // column after end
  });
  /* add data */
  XLSX.utils.sheet_add_aoa(worksheet, aoa, { origin });
}

Strings

Strings can be stored in a unified String table. The first column holds keys and the second column holds values:

XXX|    A    |   B   |
---+---------+-------+
 1 | Strings |       |
 2 |         |       |
 3 | Hello   | World |
 4 | Sheet   | JS    |

The SheetJS array-of-arrays representation of the string table is an array of key/value pairs.

The pairs can be generated from Redis by querying for all of the keys using the KEYS8 method, testing if the corresponding value is a string using the TYPE9 method, and fetching string values using the GET10 method:

const aoa = ["Strings"]; aoa.length = 2; // [ "Strings", empty ]
const keys = await client.KEYS("*");
for(let key of keys) {
  const type = await client.TYPE(key);
  // highlight-start
  if(type == "string") aoa.push([key, await client.GET(key)]);
  // highlight-end
}

Lists

Lists are unidimensional and can be stored in their own columns.

XXX|    C    |
---+---------+
 1 | List    |
 2 | List1   |
 3 | List1V1 |
 4 | List1V2 |

The SheetJS array-of-arrays representation of lists is a column of values.

Redis LRANGE11 returns a simple array of values. sheet_add_aoa interprets the result as one row, so the data should be transposed.

The code transposes the result with values.map(v => [v]).

const values = await client.LRANGE(key, 0, -1);
const aoa = [ ["List"], [key] ].concat(values.map(v => [v]));

Sets

Sets are unidimensional and can be stored in their own columns.

XXX|   D   |
---+-------+
 1 | Set   |
 2 | Set1  |
 3 | Set1A |
 4 | Set1B |

The SheetJS array-of-arrays representation of sets is a column of values.

Redis SMEMBERS12 returns an array of values. sheet_add_aoa interprets the result as one row, so the data should be transposed.

The code transposes the result with values.map(v => [v]).

const values = await client.SMEMBERS(key);
const aoa = [ ["Set"], [key] ].concat(values.map(v => [v]));

Sorted Sets

Sorted Sets have an associated score which can be stored in the second column.

XXX|    E    | F |
---+---------+---+
 1 | Sorted  |   |
 2 | ZSet1   |   |
 3 | Key1    | 1 |
 4 | Key2    | 2 |

The SheetJS array-of-arrays representation is an array of key/score pairs.

ZRANGE_WITHSCORES13 returns an array of objects which can be reshaped.

const values = await client.ZRANGE_WITHSCORES(key, 0, -1);
const aoa = [ ["Sorted"], [key] ].concat(values.map(v => [v.value, v.score]));

Hashes

Hashes are stored like the string table, with key and value columns in order.

XXX|   G   |   H   |
---+-------+-------+
 1 | Hash  |       |
 2 | Hash1 |       |
 3 | Key1  | Val1  |
 4 | Key2  | Val2  |

The SheetJS array-of-arrays representation is an array of key/value pairs.

HGETALL14 returns an object which can be converted using Object.entries:

const values = await client.HGETALL(key);
const aoa = [ ["Hash"], [key] ].concat(Object.entries(values));

Complete Example

:::note Tested Deployments

This demo was last tested on 2023 November 18 with Redis 7.2.3, Redis connector module 4.6.10 and NodeJS 20.9.0.

:::

:::warning pass

The most recent version of the redis node module does not work with most versions of NodeJS. It is "ESM-only", requiring NodeJS 18 or later. As a result, this demo also requires NodeJS version 18 or later.

:::

  1. Set up and start a local Redis server.

:::note pass

This demo was last tested on macOS. Redis was installed with:

brew install redis

The following command started the server process:

/usr/local/opt/redis/bin/redis-server /usr/local/etc/redis.conf

:::

  1. Download the following scripts:
curl -LO https://docs.sheetjs.com/nosql/SheetJSRedis.mjs
curl -LO https://docs.sheetjs.com/nosql/SheetJSRedisTest.mjs
  1. Install dependencies:

{\ npm i --save https://cdn.sheetjs.com/xlsx-${current}/xlsx-${current}.tgz redis@4.6.10}

  1. Run the test script:
node SheetJSRedisTest.mjs

Inspect the output and compare with the data in SheetJSRedisTest.mjs.

Open SheetJSRedis.xlsx and verify the columns have the correct data


  1. See "Array of Arrays" in "Utility Functions" ↩︎

  2. See "Array of Arrays Input" in "Utility Functions". ↩︎

  3. See "Workbook Helpers" in "Utility Functions" ↩︎

  4. See writeFile in "Writing Files" ↩︎

  5. See readFile in "Reading Files" ↩︎

  6. See sheet_to_json in "Utilities" ↩︎

  7. See "Utilities" in "Addresses and Ranges" ↩︎

  8. See KEYS in the Redis documentation. ↩︎

  9. See TYPE in the Redis documentation. ↩︎

  10. See GET in the Redis documentation. ↩︎

  11. See LRANGE in the Redis documentation. ↩︎

  12. See SMEMBERS in the Redis documentation. ↩︎

  13. The official command is ZRANGE. ZRANGE_WITHSCORES is a special command supported by the NodeJS wrapper. ↩︎

  14. See HGETALL in the Redis documentation. ↩︎