Skip to content

Latest commit

 

History

History
241 lines (132 loc) · 8.46 KB

File metadata and controls

241 lines (132 loc) · 8.46 KB

Amazon Neptune Export CHANGELOG

Neptune Export v2.1.3 (Release Date: TBD):

New Features and Improvements:

Bug Fixes:

Neptune Export v2.1.2 (Release Date: April 29, 2026):

New Features and Improvements:

  • Bump gremlin-driver to 3.7.6
  • Bump commons-beanutils to 1.11.0
  • Bump plexus-utils to 4.0.3
  • Bump jackson-databind to 2.18.2

Bug Fixes:

  • Fix S3 config file download failure when cleanOutputPath is true

Neptune Export v2.1.1 (Release Date: April 8, 2026):

New Features and Improvements:

  • Bump Netty to 4.2.12.Final

Neptune Export v2.1.0 (Release Date: March 25, 2026):

New Features and Improvements:

  • Use SPARQL over GSP for complete and named-graph exports in export-rdf for Neptune versions >= 1.3.2.0
  • Updated NeptuneSparqlClient create() method signature to require NeptuneClusterMetadata
  • Add new parameter expectedBucketOwner to export-service to validate target S3 buckets belong to the expected account

Bug Fixes:

  • Fix missing graph fields for complete and named-graph exports in export-rdf with nquads format
  • Fix --clone-cluster-enable-audit-logs overriding other Neptune cluster parameters

Neptune Export v2.0.2 (Release Date: June 16, 2025):

Bug Fixes:

  • Fix fallback for finding parameter group families via Neptune engine version

Neptune Export v2.0.1 (Release Date: June 10, 2025):

Bug Fixes:

  • Fix inability to upload large files (>5GB) to S3

Neptune Export v2.0.0 (Release Date: May 15, 2025):

Breaking Changes:

Missing CSV headers from export-pg-from-queries

This release fixes a bug where headers were previously missing from the default csv format for export-pg-from-queries. With this fix, headers will now be present by default in export-pg-from-queries. Use --format csvNoHeaders or "format": "csvNoHeaders" to revert to export as CSV without headers.

New Features and Improvements:

  • Migrate to AWS SDK for Java v2
  • Use the jobId from the Neptune Export Service (AWS Batch jobId) as the default exportId if available
  • Enable csv file rewrites for export-pg-from-queries to ensure output conforms to inferred schema

Bug Fixes:

  • Add retries to Neptune clone creation
  • Fix missing csv headers from export-pg-from-queries
  • Disable DFE for all Gremlin queries

Neptune Export v1.1.11 (Release Date: Mar 10, 2025):

Bug Fixes:

  • Fix incorrect URL scheme for network load balancer endpoints

Neptune Export v1.1.10 (Release Date: Dec 16, 2024):

New Features and Improvements:

  • Update TinkerPop to 3.7.3 and JanusGraph to 1.1.0

Neptune Export v1.1.9 (Release Date: Nov 12, 2024):

Bug Fixes:

  • Improve GremlinFilter compilation efficiency for highly concurrent exports

New Features and Improvements:

  • Bump AWS SDK to 1.12.773
  • Bump commons-io to 2.15.1
  • Bump aws-lambda-java-core to 1.2.3

Neptune Export v1.1.8 (Release Date: August 27, 2024):

Bug Fixes:

  • Fix RDF GSP error extraction
  • Disable client-side verification of URI syntax for export-rdf
  • Throws exception in cases where S3 Handler cannot find local files

Neptune Export v1.1.7 (Release Date: July 15, 2024):

Bug Fixes:

  • Support Neptune 1.3 parameter groups when describeDBClusterParameterGroups unavailable
  • Surface server errors for RDF GSP exports

New Features and Improvements:

  • Use AWS Batch Job ID as Neptune Export ID when available

Neptune Export v1.1.6 (Release Date: April 17, 2024):

Bug Fixes:

  • Fix bug in export-rdf to Kinesis where Neptune Export may terminate before all data has been written to the stream.

Neptune Export v1.1.5 (Release Date: March 18, 2024):

New Features and Improvements:

  • Add '--clone-cluster-enable-audit-logs' argument which enables audit logging on cloned clusters. Audit logging is disabled by default, which aligns with previous behavior.

Neptune Export v1.1.4 (Release Date: January 11, 2024):

Bug Fixes:

  • Update --gremlin-filters to block use of mutating steps mergeV() and mergeE()

New Features and Improvements:

  • Add --split-queries option to export-pg-from-queries. When invoked, range() steps will be injected in the beginning of queries, and they will be split according to the configured concurrency.
  • Add --named-graph argument to export-rdf. This argument allows for a single named graph URI to be specified to limit the scope of the export.

Neptune Export v1.1.3 (Release Date: November 30, 2023):

New Features and Improvements:

  • Add support for neptune_ml profile to export-pg-from-queries.

Neptune Export v1.1.2 (Release Date: November 15, 2023):

New Features and Improvements:

  • Use Graph Store Protocol for complete RDF graph exports, improving performance for large exports.

Neptune Export v1.1.1 (Release Date: November 3, 2023):

Bug Fixes:

  • Resolves issue where certain special characters would cause RDF export jobs to fail.

Neptune Export v1.1.0 (Release Date: October 31, 2023):

Bug Fixes:

  • Resolves issue in which RDF outputs may contain unexpected and potentially faulty prefixes.

New Features and Improvements:

  • Introduce --structured-output CLI option to export-pg-from-queries. This option, when used in conjunction with --format csv, will produce CSV output matching the structure of the Neptune bulk loader's gremlin data format. This is the same format as produced by export-pg --format csv. The use of this option requires that queries produce elementMap()'s of nodes and edges.

  • Add --filter-edges-early option to property graph exports. This option forces gremlinFilters to apply before the range() step which breaks up concurrent traversals. This may lead to improved performance in cases where the gremlinFilters are efficient and filter out the majority of edges.

Neptune Export v1.0.7 (Release Date: September 27, 2023):

New Features and Improvements:

  • Cross Account Exports: New CLI options and parameters added to specify a role to assume when uploading to Amazon S3 buckets or Amazon Kinesis Data Streams
  • New --credentials-profile CLI option to fetch AWS Credentials from non-default AWS CLI profiles

Neptune Export v1.0.6 (Release Date: July 31, 2023):

Bug Fixes:

  • Fixed bug which could lead to corrupted output in highly concurrent csv exports

Neptune Export v1.0.5 (Release Date: June 5, 2023):

Bug Fixes:

  • Resolves issue which caused the error gremlin-groovy is not an available GremlinScriptEngine to appear when using the --gremlin-filter option in the uber jar.

Neptune Export v1.0.4 (Release Date: May 31, 2023):

New Features and Improvements:

  • Upgraded to Gremlin Dependency Version to 3.6.2

Neptune Export v1.0.3 (Release Date: April 27, 2023):

Bug Fixes:

  • Fixed NullPointerException bug during RDF Exports

New Features and Improvements:

  • Added aws-java-sdk-sts as a dependency to enable WebIdentityTokenFileCredentialsProvider.

Neptune Export v1.0.2 (Release Date: April 7, 2023):

Bug Fixes:

  • Fixed bug which was preventing getting the output id in FileToStreamOutputWriter

Neptune Export v1.0.1 (Release Date: March 30, 2023):

Bug Fixes:

  • Updated NOTICE file in shaded jar

New Features and Improvements:

  • Added new --disable-stream-aggregation option for property graph exports to Kinesis streams. More details can be found here.

  • Improved error messages from server side errors (such as timeout exceptions) for RDF exports.

Neptune Export v1.0.0 (Release Date: February 28, 2023):

Neptune Export is a tool to perform bulk data exports from AWS Neptune. Neptune Export is migrated from the AWS Labs Amazon Neptune Tools repository, and the old module is now deprecated. In this release, the release artifact neptune-export.jar has been renamed to neptune-export-1.0.0-all.jar. Going forward, Neptune Export will be following this new versioned naming scheme.

Instructions for running export jobs can be found in the docs/ directory.

A few changes are included since the migration.

Bug Fixes:

  • Corrected r6g instance type prefix (used to be listed as r6d).

New Features and Improvements:

  • Added a new optional parameter to use customer managed KMS key for S3 server-side encryption.
  • Added integration tests for developers requiring manual setup (see docs/dev/IntegrationTests.md).