Model Simple Data in a Graph For Use in Neo4J

Create Nodes and Relationships in Neo4J with Cypher

Read Nodes and Relationships in Neo4J with Cypher

Update Nodes and Relationships in Neo4J with Cypher

Delete Nodes and Relationships in Neo4J with Cypher

Use neo4j-graphql-js to Create a Simple API

Explicitly Model Schema Relationships with the @relation Directive in neo4j-graphql-js

Create Data in Neo4J Through a GraphQL API

Create Custom GraphQL Mutations with the @cypher Directive in neo4j-graphql-js

Build Complex Schema Relationships with the @cypher Directive in neo4j-graphql-js

Build a Neo4J & GraphQL API

We will learn to use the `@relation` directive provided by `neo4j-graphql-js` to make the relationships in our model explicit in our schemas.

Instructor: [00:00] Let's start out by making sure we don't have any data in our graph, so we can start with a clean slate. Now, we can fill a few nodes representing a person, a species, a planet, and a film. While we create these, we'll also relate them to each other.

[00:17] We can get a quick look at the graph model we built to see how these nodes relate to each other. A person has a species and homeworld, and appeared in a film. A species appeared in a film, and a planet appeared in a film.

[00:32] We can see a tidy little graph as the result of that query, which looks like what we can call a subgraph in our model. Let's create schemas in our API to represent the new film and species nodes that we've added.

[00:45] We'll also fill in the properties and types of our relationships. If we run our API server, we can put together a query to get back all of the nodes we created. What's missing, however, is any indication of the relationships between these nodes.

[01:02] In typical GraphQL fashion, we could write some resolvers to handle this for us. Instead, we're going to let neo4j-graphql-js do the lifting. Enter the relation directive. We can use this to easily describe within our schema any relationships a type of node has to another node.

[01:19] We can reference external film nodes by decorating person, planet, and species with relations that go out to a film. That goes the same for a person's homeworld and species properties. Similarly, we can reference these same nodes from a film by describing them on the film schema as relations that come in from some other node.

[01:43] Now, we can take a look at our updated API and query against these relations. As with any other GraphQL implementation, we can query and hydrate data in an arbitrarily nested structure. Not only do we save some development cycles by not building resolvers, but we also get to keep working in a Graph mindset.

[02:03] Let's take a look at our API's logged output. Rather than query the database for a person node, read its properties in JavaScript, then go back to the database to hydrate those properties, neo4j-graphql-js will create a single query, and walk the graph in one step to fill in all of the data we need.

[02:22] The schema tab in our GraphQL playground will also now contain a whole new class of mutations. Now, we can not only create nodes, but also relationships between existing nodes.

Course

Build a Neo4J & GraphQL API

Explicitly Model Schema Relationships with the @relation Directive in neo4j-graphql-js

Share this video with your friends