Skip to content

Node.js client for RedisGraph, by wrapping ioredis module

License

Notifications You must be signed in to change notification settings

Jonahss/ioredisgraph

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Libraries.io dependency status for latest release Node CI npm version

ioredisgraph

A javascript client for RedisGraph based on the excellent ioredis client.

Literally based off ioredis. This module wraps ioredis, adds a couple commands, and returns an array of objects from each query (as well as the query meta information).

let RedisGraph = require('ioredisgraph');

async function demo () {
  let graph = new RedisGraph('MotoGP')
  await graph.query("CREATE (:Rider {name:'Valentino Rossi'})-[:rides]->(:Team {name:'Yamaha'}), (:Rider {name:'Dani Pedrosa'})-[:rides]->(:Team {name:'Honda'}), (:Rider {name:'Andrea Dovizioso'})-[:rides]->(:Team {name:'Ducati'})")
  let ridingForYamaha = await graph.query("MATCH (r:Rider)-[:rides]->(t:Team) WHERE t.name = 'Yamaha' RETURN r,t")

  console.log(ridingForYamaha)
  // [ { 'r.name': 'Valentino Rossi', 't.name': 'Yamaha' },
  // meta: { queryInternalExecutionTime: '1.446600 milliseconds' } ]

  await graph.delete()
}

demo()

Usage

Constructor

ioredisgraph has all the same constructor options as ioredis, but adds a graphName argument.

Add graph name as first argument to constructor:

let graph = new RedisGraph('DEMO_GRAPH')

let graph = new RedisGraph('DEMO_GRAPH', 6379)

or add to options object:

let graph = new RedisGraph({graphName: 'DEMO_GRAPH', port: 6379})

Methods

These methods are added. All other methods usually available to an ioredis client are accessible.

graph.query(cypherString) Pass in a string for your cypher query. Results are an array of object. Each object has properties based on the name used in the query. access results.meta for the meta information redisgraph returns.

graph.delete() Deletes database

graph.explain(cypherString)

Performance

RedisGraph supports a special --compact argument on queries, which improves performance by having responses include enums instead of looking up the string values for property names, label names, and relationship type names. This client does not use --compact currently. Create an issue to support this, we are currently waiting for a solution to redis/ioredis#895

About

Node.js client for RedisGraph, by wrapping ioredis module

Resources

License

Stars

Watchers

Forks

Packages

No packages published