![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4&size=40){kind=avatar}
This is a tool that enables you, with very little effort, to introspect the schema/data model in an existing Neo4j database and build up a set of data structures that can be transformed into any output format.
This is provided by a separate npm package, @neo4j/introspector.
The currently officially supported output format is GraphQL type definitions. This is usually a one-time thing and should be considered a starting point for a GraphQL schema.
This tool has full support for generating type definitions, including:
@relationshipdirective, including relationship properties@nodelabelfor mapping where a node label might use a character that's not in the supported GraphQL character setadditionalLabelsfor nodes that have multiple labels
- Generating a read-only version of the GraphQL type definitions, i.e. generate a
@exclude(operations: [CREATE, DELETE, UPDATE])directive on all node types.
If an element property has mixed types throughout your graph, that property will be excluded from the generated type definitions. The reason for this is that your GraphQL server will throw an error if it finds data that doesn't match the specified type.
Currently, there's a programmatic API for introspecting the Neo4j schema and generating GraphQL type definitions.
This example introspects the schema, generates GraphQL type definitions and persists them to a file schema.graphql.
You can then serve this file with your GraphQL server.
const { toGraphQLTypeDefs } = require("@neo4j/introspector");
const neo4j = require("neo4j-driver");
const fs = require("fs");
const driver = neo4j.driver("neo4j://localhost:7687", neo4j.auth.basic("neo4j", "password"));
const sessionFactory = () => driver.session({ defaultAccessMode: neo4j.session.READ });
// We create a async function here until "top level await" has landed
// so we can use async/await
async function main() {
const typeDefs = await toGraphQLTypeDefs(sessionFactory);
fs.writeFileSync("schema.graphql", typeDefs);
await driver.close();
}
main();This example generates a read-only version of the schema from the database and immediately spins up an ApolloServer server.
Here the type definitions are never persisted to disk.
import { ApolloServer } from "@apollo/server";
import { startStandaloneServer } from "@apollo/server/standalone";
import { Neo4jGraphQL } from "@neo4j/graphql";
import { toGraphQLTypeDefs } from "@neo4j/introspector";
import neo4j from "neo4j-driver";
const driver = neo4j.driver("neo4j://localhost:7687", neo4j.auth.basic("neo4j", "password"));
const sessionFactory = () => driver.session({ defaultAccessMode: neo4j.session.READ });
// We create a async function here until "top level await" has landed
// so we can use async/await
async function main() {
const readonly = true; // We don't want to expose mutations in this case
const typeDefs = await toGraphQLTypeDefs(sessionFactory, readonly);
const neoSchema = new Neo4jGraphQL({ typeDefs, driver });
const server = new ApolloServer({
schema: await neoSchema.getSchema(),
});
await startStandaloneServer(server, {
context: async ({ req }) => ({ req }),
});
}
main();You can introspect the schema and then transform it to any desired format.
Example:
import { toGenericStruct } from "@neo4j/introspector";
import neo4j from "neo4j-driver";
const driver = neo4j.driver("neo4j://localhost:7687", neo4j.auth.basic("neo4j", "password"));
const sessionFactory = () => driver.session({ defaultAccessMode: neo4j.session.READ });
async function main() {
const genericStruct = await toGenericStruct(sessionFactory);
// Programmatically transform to what you need.
}
main();