Migration guide

This guide covers the upgrade boundaries to and between the 6.x line that contain breaking changes. For the complete list of changes per release, see Changelog.

The Maven coordinate for the connector has been changed since major version 6.0.0. The new coordinate is org.neo4j.connectors:spark. When migrating from an older major version, update the Maven coordinate.
Upgrade Breaking change

5.5 → 6.0

Spark version support set to 4.0 and/or 4.1.

5.5 → 6.0

What changed: the baseline Apache Spark version was raised from 3.5 to 4.0/4.1. Minimum Java runtime version changed from 8 to 17. Supported Scala versions are now 2.13.

How to migrate:

  1. First, upgrade to the latest Neo4j Spark connector version 5.5.0 or later.

  2. Upgrade your Spark cluster to 4.0 or later.

  3. Use the 6.0.0 artifact built for Spark 3:

    org.neo4j.connectors:spark:6.0.0-s_2.13

  4. If you cannot upgrade your Spark version, stay on the 5.x line.

See the 6.0.0 release notes for the full list of changes.