11# Neo4j 4 Metabase driver
22
3- Wraps the Neo4j BI connector to allow Metabase use .
3+ Simple wrapper of the Neo4j BI connector for metabase .
44
55## Building the driver
66
@@ -21,7 +21,7 @@ lein install-for-building-drivers
2121
2222``` bash
2323# cp the jar to the maven dir
24- mkdir -p .m2/repository/neo4j/neo4j-bi-jdbc/1.0.0 && cp JAR_PATH .m2/repository/neo4j/neo4j-bi-jdbc/1.0.0/
24+ mkdir -p ~ / .m2/repository/neo4j/neo4j-bi-jdbc/1.0.0 && cp JAR_PATH ~ / .m2/repository/neo4j/neo4j-bi-jdbc/1.0.0/
2525```
2626
2727### Build the driver
@@ -49,17 +49,53 @@ cd /path/to/metabase_source
4949lein run
5050```
5151
52- ## What this looks like
52+ ## Working with a relational model on graphs
5353
54- ![ databases] ( screenshots/databases.png )
55- ![ tables] ( screenshots/tables.png )
54+ The JDBC driver exposes schemas for ** Relationships** and ** Nodes**
5655
57- ## Caveats
56+ * Relationships
5857
59- This is a WIP implementation.
60- It is not heavily tested and is not compatible with neo4j 3.5 ( even though the underlying driver is)
58+ * The driver creates one table for each distinct combination of source label, relationship type, and target label.
59+
60+ * Nodes
61+ * The driver only creates tables for nodes that have labels.
62+ * The driver creates one table for each distinct combination of node labels.
63+
64+ Given
65+ * Node1, with the label [ Alphabet]
66+ * Node2, with the label [ Google]
67+ * Node3, with the labels[ Alphabet,Google]
68+
69+ The following tables will be created:
70+ * Alphabet
71+ * Google
72+ * Alphabet_Google
73+
74+ * Naming
75+ Separators between node label names and relationship names is an underscore by default
76+
77+ To change the Node name seperator, you can use the LabelSeparator JDBC property, or RelNodeSeperator for Relationship tables.
78+
79+ JDBC properties can be added via the driver configuration as shown in the image below.
80+
81+ > For an up to date list of allowed configuration values, please download the [ JDBC driver] ( https://neo4j.com/bi-connector/ )
82+
83+ ![ configuration] ( screenshots/db.png )
84+
85+ ## Caveats
86+
87+ ** This is a WIP.**
88+
89+ It is not heavily tested and is not compatible with neo4j 3.5 ( even though the underlying driver is )
6190
6291## TODO
6392
64- * Support Cypher queries when BI connector matures
65- * Testing
93+ * Testing
94+ * CI
95+ * Docker example
96+ * Edge properties
97+
98+ ## Future
99+
100+ * Support Cypher queries as BI connector matures
101+
0 commit comments