Skip to content

Commit a5b0549

Browse files
committed
README, screenshots
1 parent 0dd5cf7 commit a5b0549

File tree

4 files changed

+46
-10
lines changed

4 files changed

+46
-10
lines changed

README.md

Lines changed: 46 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
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
4949
lein 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+

screenshots/db.png

57 KB
Loading

screenshots/rel.png

35.4 KB
Loading

screenshots/schema.png

31 KB
Loading

0 commit comments

Comments
 (0)