How to integrate Neo4j using Talend Studio

Learn how to quickly and efficiently connect Neo4j with Talend Studio for smooth data access.

Read and write Neo4j data effortlessly. Query, integrate, and manage nodes, relationships, and graph data — almost no coding required. You can do it all using the high-performance Neo4j ODBC Driver for Talend Studio (often referred to as the Neo4j Connector). We'll walk you through the entire setup.

Ready to dive in? Download the product to jump right in, or follow the step-by-step guide below to see how it works.

Neo4j ODBC Driver Powering this integration

High performance
Bidirectional
Low-code / No-code
Easy to use

Built on the ZappySys JDBC Bridge Driver, the Neo4j ODBC Driver is a high-performance, low-code / no-code solution. It enables you to connect to Neo4j data without any coding right in your SQL Server, or any ODBC/JDBC application. Part of the ODBC PowerPack.

Documentation

Prerequisites

Before we begin, make sure you meet the following prerequisite: Java Runtime Environment (JRE) or Java Development Kit (JDK) must be installed on your system.

Minimum required version: Java 17
- Amazon Corretto 17
- Oracle JRE 17
Recommended Java version: Java 21
- Amazon Corretto 21
- Oracle JRE 21

If your JDBC Driver targets a different Java version (e.g., 11 / 17 / 21), install the corresponding or newer Java version.

If you already have a JRE installed, you can try using it too. However, if you experience any issues, we recommend using one of the distributions mentioned above (you can install an additional JRE next to the existing one; just don't forget to configure the default Java in the Windows Environment Variables).

Download Neo4j JDBC driver

To connect to Neo4j in , you will have to download JDBC driver for it, which we will use in later steps. Let's perform these little steps right away:

Visit MVN Repository.
Download the JDBC driver, and save it locally, e.g. to E:\Drivers\JDBC\neo4j-jdbc-full-bundle.jar.
Done! That was easy, wasn't it? Let's proceed to the next step.

Create data source in ZappySys Data Gateway

In this section we will create a data source for Neo4j in the Data Gateway. Let's follow these steps to accomplish that:

Download and install ODBC PowerPack (if you haven't already).
Search for gateway in the Windows Start Menu and open ZappySys Data Gateway Configuration:
Go to the Users tab and follow these steps to add a Data Gateway user:
- Click the Add button
- In the Login field enter a username, e.g., john
- Then enter a Password
- Check the Is Administrator checkbox
- Click OK to save
Now we are ready to add a data source:
- Click the Add button
- Give the Data source a name (have it handy for later)
- Then select Native - ZappySys JDBC Bridge Driver
- Finally, click OK
Neo4jDSN

ZappySys JDBC Bridge Driver
Now, we need to configure the JDBC connection in the new ODBC data source. Simply enter the Connection string, credentials, configure other settings, and then click Test Connection button to test the connection:

Neo4jDSN

jdbc:neo4j://neo4j-instance-host-name:7687?enableSQLTranslation=true

E:\Drivers\JDBC\neo4j-jdbc-full-bundle.jar

neo4j

***************

[]

For Non-SSL Connection (SQL queries), use these values when setting parameters:
- Connection string: jdbc:neo4j://neo4j-instance-host-name:7687?enableSQLTranslation=true
- JDBC driver file(s): E:\Drivers\JDBC\neo4j-jdbc-full-bundle.jar
- User name: neo4j
- User password: ***************
- Connection parameters: []
  Use enableSQLTranslation=true attribute in the connection string to query Neo4j database using SQL queries, e.g.:
```
SELECT * FROM Movie
```
For Non-SSL Connection (Cypher queries), use these values when setting parameters:
- Connection string: jdbc:neo4j://neo4j-instance-host-name:7687
  Excluding enableSQLTranslation=true from the connection allows you to query Neo4j database using Cypher queries, e.g.:
```
MATCH (m:Movie) RETURN m.title AS Movie
```
For SSL Connection (SQL queries), use these values when setting parameters:
- Connection string: jdbc:neo4j+s://neo4j-instance-host-name:7687?enableSQLTranslation=true
For SSL Connection (Cypher queries), use these values when setting parameters:
- Connection string: jdbc:neo4j+s://neo4j-instance-host-name:7687
For Neo4j AuraDB Connection (SQL queries), use these values when setting parameters:
- Connection string: jdbc:neo4j+s://1234abcd.databases.neo4j.io?enableSQLTranslation=true
For Neo4j Aura Connection (Cypher queries), use these values when setting parameters:
- Connection string: jdbc:neo4j+s://1234abcd.databases.neo4j.io
You should see a message saying that connection test is successful:

Otherwise, if you are getting an error, check out our Community for troubleshooting tips.
We are at the point where we can preview a SQL query. For more SQL query examples visit JDBC Bridge documentation:
Neo4jDSN
```
SELECT * FROM Movie
```
```
SELECT * FROM Movie
```
You can also click on the <Select Table> dropdown and select a table from the list.

The ZappySys JDBC Bridge Driver acts as a transparent intermediary, passing SQL queries directly to the JDBC driver, which then handles the query execution. This means the Bridge Driver simply relays the SQL query without altering it.

Some JDBC drivers don't support INSERT/UPDATE/DELETE statements, so you may get an error saying "action is not supported" or a similar one. Please, be aware, this is not the limitation of ZappySys JDBC Bridge Driver, but is a limitation of the specific JDBC driver you are using.
Click OK to finish creating the data source.
Once done, go to the Network Settings tab and Add a firewall rule for inbound traffic:
- This will initially allow all inbound traffic.
- Click Edit IP filters to restrict access to specific IP addresses or ranges.
Crucial Step: After creating or modifying the data source, you must:
- Click the Save button to persist your changes.
- Hit Yes when prompted to restart the Data Gateway service.
This ensures all changes are properly applied:

Skipping this step may cause the new settings to fail, preventing you from connecting to the data source.

Read Neo4j data in Talend Studio

To read Neo4j data in Talend Studio, we'll need to complete several steps. Let's get through them all right away!

This article is compatible with Talend Open Studio (a free version, currently retired by Qlik). If you don't have it, you can still purchase a shareware version of Talend Studio from Qlik.

Create connection for input

First of all, open Talend Studio
Create a new connection:
Select Microsoft SQL Server connection:
Name your connection:
Fill-in connection parameters and then click Test connection:

Neo4jDSN
If the List of modules not installed for this operation window shows up, then download and install all of them:
Review and accept all additional module license agreements during the process
Finally, you should see a successful connection test result at the end:

Add input

Once we have a connection to ZappySys Data Gateway created, we can proceed by creating a job:
Simply drag and drop ZappySys Data Gateway connection onto the job:
Then create an input based on ZappySys Data Gateway connection:
Continue by configuring a SQL query and click Guess schema button:
Finish by configuring the schema, for example:

Add output

We are ready to add an output. From Palette drag and drop a tFileOutputDelimited output and connect it to the input:

Connecting tFileOutputDelimited output in Talend Studio

Run the job

Finally, run the job and integrate your Neo4j data:

Troubleshooters & resources (JDBC Bridge Driver)

Below are some useful community articles to help you troubleshoot and configure the ZappySys JDBC Bridge Driver:

How to combine multiple JAR files
Learn how to merge multiple .jar dependencies when your JDBC driver requires more than one file.
How to fix JBR error: “Data lake is not available / Unable to verify trust for server certificate chain”
Resolve SSL or certificate validation issues encountered during JDBC connections.
System Exception: “Java is not installed or not accessible”
Fix Java path or environment issues that prevent the JDBC Bridge from launching Java.
JDBC Bridge Driver disconnect from Java host error
Troubleshoot unexpected disconnection problems between SSIS and the Java process.
Error: Could not open jvm.cfg while using JDBC Bridge Driver
Resolve JVM configuration path errors during driver initialization.
How to enable JDBC Bridge Driver logging
Enable detailed driver logging for better visibility during troubleshooting.
How to pass JDBC connection parameters (not by URL)
Learn how to specify connection properties programmatically instead of embedding them in the JDBC URL.
How to fix JDBC Bridge error: “No connection could be made because the target machine actively refused it”
Troubleshoot firewall or local port binding issues preventing communication with the Java host.
How to use JDBC Bridge options (System Property for Java command line, e.g., classpath, proxy)
Configure custom Java options like classpath and proxy using JDBC Bridge system properties.

Conclusion

In this article we showed you how to connect to Neo4j in Talend Studio and integrate data without writing complex code — all of this was powered by Neo4j ODBC Driver. It's worth noting that ZappySys JDBC Bridge Driver allows you to connect not only to Neo4j, but to any Java application that supports JDBC (just use a different JDBC driver and configure it appropriately).

Download ODBC PowerPack now or ping us via chat if you have any questions or are looking for a specific feature (you can also reach out to us by submitting a ticket):

Download Chat