Update Spark connector - Precisely Data Integrity Suite

Data Integrity Suite

Product
Spatial_Analytics
Data_Integration
Data_Enrichment
Data_Governance
Precisely_Data_Integrity_Suite
geo_addressing_1
Data_Observability
Data_Quality
dis_core_foundation
Services
Spatial Analytics
Data Integration
Data Enrichment
Data Governance
Geo Addressing
Data Observability
Data Quality
Core Foundation
ft:title
Data Integrity Suite
ft:locale
en-US
PublicationType
pt_product_guide
copyrightfirst
2000
copyrightlast
2026

The Spark connector is a component of the Data Integrity Suite agent. It enables the agent to interact with Spark based services for efficient data processing and integration across environments.

The Spark connector:
  • Provides compatibility with services that use Apache Spark
  • Manages access and permission levels required by those services
  • Acts as a bridge between the Agent and Spark workloads
Because the Spark connector is embedded in the Agent, the correct version is required for the Agent to work with Spark- dependent services. If the current Spark connector version does not provide required permissions or is incompatible with a specific service, manually update it to a supported version.
Note:
  • When using JSON array files with multiLine=true, Spark processes the entire file as one object. This approach can cause executor heap out-of-memory issues when working with large files. For smaller files, JSON remains a valid option if the file size does not exceed your executor memory limits. However, for larger datasets, JSONL (one JSON object per line) is the recommended format. JSONL enables proper partitioning and parallel processing across executors, which helps you avoid memory bottlenecks. Spark writes output in JSONL format regardless of whether your input is JSON or JSONL.
  • For optimal Spark performance, ensure that your input Parquet files are properly structured with an appropriate number of row groups. Spark processes Parquet files by splitting them at row group boundaries. If your files have too few row groups, for example, a single row group, this can result in data skew and underutilization of your executor cores. To achieve efficient parallel processing and even data distribution, align the number of row groups in your Parquet files with the number of executor cores configured in your pipeline engine.

Spark connector update criteria

Manually update the Spark connector if:
  • The current version lacks permissions required by a service
  • A new service requires a higher connector version than currently installed
  • You are experiencing compatibility issues with Spark based integrations
Warning: Ensure that no pipelines are running on the Agent during the update. If pipelines are running, stop the running pipeline or let it complete.

To manually update a specific Spark connector version, use the following commands:

  1. Update the CLI by running this command: ./discli updateCli
  2. The operator version updates automatically. If an issue arises, or if you must use a specific operator version, update it manually by running this command.

    ./discli agent applyOperatorVersion --version <version>.

  3. Update the Spark connector version: ./discli agent update -s spark-connector --version 2.1.1