Skip to content

Commit 21ae7e8

Browse files
committed
fix readmes
1 parent 5f459fa commit 21ae7e8

File tree

6 files changed

+211
-12
lines changed

6 files changed

+211
-12
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ spark.databricks.safespark.jdbcSandbox.size.default.mib 512
8686
```sql
8787
CREATE CONNECTION neo4j_connection TYPE JDBC
8888
ENVIRONMENT (
89-
java_dependencies '["path/to/neo4j-jdbc-full-bundle-6.10.3.jar", "path/to/neo4j-jdbc-translator-sparkcleaner-6.10.3.jar"]'
89+
java_dependencies '["path/to/neo4j-jdbc-full-bundle-6.10.3.jar", "path/to/neo4j-jdbc-translator-sparkcleaner-6.10.3.jar"]' -- must be UC Volume paths
9090
)
9191
OPTIONS (
9292
url 'jdbc:neo4j+s://your-host:7687/neo4j?enableSQLTranslation=true',

docs/neo4j_uc_jdbc_guide.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ Upload these JARs to a Unity Catalog Volume:
4444

4545
**Note:** The version numbers in this guide reflect the versions available at the time of writing. If you are using a different version, adjust the JAR filenames and references accordingly.
4646

47+
**Important:** The `java_dependencies` option in `CREATE CONNECTION TYPE JDBC` only supports Unity Catalog Volume paths (e.g., `/Volumes/catalog/schema/jars/`). Cluster-installed libraries (Maven coordinates, uploaded JARs) cannot be referenced here — they are a separate system. JARs must be uploaded to a UC Volume and referenced by their Volume path.
48+
4749
Example path: `/Volumes/catalog/schema/jars/`
4850

4951
### 3. Cluster Libraries
@@ -56,7 +58,7 @@ For comprehensive testing, install these libraries on your cluster:
5658
| neo4j (Python) | 6.0.2 | Neo4j Python Driver |
5759
| neo4j-jdbc-full-bundle | 6.10.5 | JDBC driver (cluster library for Direct JDBC) |
5860

59-
For UC JDBC only, the cluster libraries are optional—the JARs are loaded from the UC Volume.
61+
For UC JDBC connections, cluster libraries are **not used**. The `java_dependencies` option only accepts UC Volume paths — cluster-installed libraries (Maven coordinates or uploaded JARs) cannot be referenced in `CREATE CONNECTION`. The JDBC JARs must be stored in a UC Volume.
6062

6163
---
6264

@@ -346,14 +348,14 @@ df = query_neo4j(
346348

347349
## Choosing the Right Integration Method
348350

349-
| Use Case | Recommended Method |
350-
|----------|-------------------|
351-
| Aggregate analytics (COUNT, SUM, etc.) | UC JDBC Connection |
352-
| Graph traversal counts | UC JDBC with NATURAL JOIN |
353-
| Row-level data access | Neo4j Spark Connector |
354-
| Complex Cypher queries | Neo4j Spark Connector |
355-
| GROUP BY analytics | Direct JDBC or Spark Connector |
356-
| Ad-hoc exploration | Neo4j Python Driver |
351+
| Use Case | Recommended Method | JAR Source |
352+
|----------|-------------------|------------|
353+
| Aggregate analytics (COUNT, SUM, etc.) | UC JDBC Connection | UC Volume (`java_dependencies`) |
354+
| Graph traversal counts | UC JDBC with NATURAL JOIN | UC Volume (`java_dependencies`) |
355+
| Row-level data access | Neo4j Spark Connector | Cluster library (Maven coordinate) |
356+
| Complex Cypher queries | Neo4j Spark Connector | Cluster library (Maven coordinate) |
357+
| GROUP BY analytics | Direct JDBC or Spark Connector | Cluster library (Maven coordinate) |
358+
| Ad-hoc exploration | Neo4j Python Driver | pip package |
357359

358360
---
359361

0 commit comments

Comments
 (0)