Release Notes Incorta 2025.7.0 (Preview)
2025.7.0 is a preview release. The first generally available (GA) release of the year is 2025.7.1, which includes all features from 2025.7.0 along with additional enhancements, new capabilities, and fixes
In addition to all features previously introduced in the 2024.7.x releases, the Incorta 2025.7.0 release delivers a comprehensive suite of new features, significant performance enhancements, and crucial stability improvements across the platform.
Release Highlights
- A redesigned and modernized user interface (UI) offering a significantly improved user experience, with more intuitive navigation and streamlined interactions
- Significant enhancements to data ingestion, including the ability to resume failed jobs from the point of failure, perform incremental loading at the table level, stage loads for non-optimized objects, discover remote Delta tables, and streamline the materialization of verified business views
- An improved version of the Data Catalog, now with extended coverage to treat Notebooks as first-class assets, simplified access request workflows, and comprehensive audit trails for all catalog-related activities
- Streamlined management of Data Agents, especially in Cloud environments, with support for service auto-discovery and enhanced memory management
- Enhanced platform performance and stability through optimized Primary Analytics configuration, improved workload management, and new caching controls for downloads
- Comprehensive improvements to Spark SQL Views, including support for multi-value variables and enhanced filter performance
- Integration with Secret Manager to support secure and centralized management of sensitive credentials
- Dashboard and visualization enhancements, including expanded personalization options, the ability to publicly share dashboards, precise layout controls for PDF exports, dynamic subtotal labeling, customizable font formatting, and improved performance of the Slicer component
- Enhanced chart interactivity with intuitive zoom capabilities for more granular data exploration
- Advanced Bubble chart functionality, featuring a new Break By tray, support for lasso selection, and sophisticated reference lines for quadrant-based analysis
- A smarter Incorta Copilot, delivering more accurate responses through refined training, support for direct SQL editing within the Copilot interface, improved response formatting, and better number handling
- Exciting preview features, including Git integration for materialized view (MV) and business notebook versioning, schema comparison, and dynamic column resolution
Upgrade considerations
Upgrade considerations for previous 2024.7.x releases also apply to this release unless stated otherwise.
Installation and upgrade requirements and recommendations
Deprecating support for Oracle 12c
Starting with this release, the Oracle 12c database server is no longer supported for the Incorta metadata database. Customers who are still using Oracle 12c for their metadata should upgrade to Oracle 19c.
Please contact Incorta support for any questions regarding this.
Supported Java versions
This release exclusively supports OpenJDK 17. It is mandatory to install or upgrade to the supported Java version before installing or upgrading to the 2025.7.0 release.
Adopting OpenJDK 17 is anticipated to deliver substantial improvements in both performance and stability for your Incorta platform, ensuring a more robust and efficient experience.
Incorta no longer supports Oracle Java SE 8, OpenJDK 8, or OpenJDK 11.
Supported Python versions
Although Python 3.8 and 3.9 are still supported, it is strongly recommended to use Python 3.10.12. Adopting the recommended version will allow you to leverage the latest security enhancements and critical fixes, ensuring a more secure and stable environment.
Connectors
After upgrading to Incorta 2025.7.0, it is mandatory to upgrade all CData and Presto connectors to their latest versions for continued functionality. Additionally, it is recommended to upgrade all other connectors to benefit from the recent fixes and enhancements.
Perform these upgrades using the Connector Marketplace.
New user interface
The 2025.7.0 release introduces a redesigned and modernized user interface (UI) for an improved user experience. Please note that reverting to the previous UI is not supported in this release.
Existing custom style sheets (CSS) you have implemented will be outdated after the upgrade and will require updates to align with the new UI's structure.
For details about the new selectors and necessary updates to your custom CSS, refer to References → Customize Incorta with CSS.
Clusters with Advanced SQLi
For On-Premises, Multi-Analytics clusters with Advanced SQLi enabled, the manually configured primary Analytics service will be ignored. To ensure proper operation, you must reconfigure the primary Analytics service after the upgrade from the CMC.
Additionally, you must configure the Advanced SQLi service with the Analytics node and service in single- or multi-Analytics environments with custom installations. Otherwise, the Spark Metastore Sync will fail to initialize.
For details, see Streamlining the primary Analytics configuration.
Stricter schema import validation
Incorta releases prior to 2024.1.0 allowed the creation of schemas with identical names that only differed in capitalization. While version 2024.1.0 restricted the creation of such schemas, this limitation did not apply to schema imports.
With the release of version 2025.7.0, Incorta now enforces this naming convention during schema import, preventing the import of schemas whose names are duplicates of existing ones but differ in capitalization.
getVar function behavior change
In this release, the behavior of the getVar
function in Spark SQL views has been updated. If the referenced variable returns multiple values, getVar
will now return them as a single, comma-separated string, instead of returning only the first value as in previous versions.
This may affect existing views that rely on the previous behavior. Please review and update any impacted queries accordingly.
Analyzer tables on secured base tables
Previously, the $user
system variable in the source object’s security filters would be evaluated incorrectly when loading or exploring Analyzer tables based on this object, leading to empty or inaccurate result sets.
Starting with this release, any security filter in the base object containing $user
will be ignored when loading or exploring the dependent Analyzer table.
For details, see Analyzer tables based on objects with security filters.
Upgrades from 2024.1.8
The Early Post-load calculations feature introduced in the 2024.1.8 release will not be available in the 2025.7.0 release until further notice. We will provide updates regarding its availability in future releases.
Service status observability port review
After upgrading to this release, it's critical to review and verify that the status observability ports are available and accessible by Incorta. This review should be conducted before starting the services to ensure proper service startup and status reporting.
The default ports are:
- 65531 for the Analysis service
- 65532 for the Loader service
In the case of a multi-Analytics node, you must manually change the status observability port for one of the Analytics services in the service.properties
file. For more details refer to Service status observability.
Date and cluster name added to the audit file name
The naming convention of the Engine audit files has been changed.
- Old pattern:
<nodeName>.<serviceName>-part<partNumber>.csv
Example:c71-node.analytics-part-00000-00.csv
- New pattern:
<date>-<clusterName>.<nodeName>.<serviceName>-part<partNo.>.csv
Example:2025-05-15-c71.c71-node.analytics-part-00000-00.csv
Data agent considerations
- This release uses the Data Agent version 12.0.0. Please upgrade to this version.
- For Cloud clusters, data agents are managed from the Cloud Admin Portal and not the Data Manager.
- After upgrading the data agent, you must regenerate the authentication file from the Cloud Admin Portal and copy it to the following directories on the remote host machine:
<unzipped_data_agent_path>/incorta.dataagent/conf
<unzipped_data_agent_path>/incorta.dataagent.controller/conf
- Enhanced memory management options are now available for the data agent.
- The
data.agent.fetch.size property
in thenode.properties
file has been deprecated. Any configured value will be ignored after upgrading to this release. - The data source fetch size must not exceed the
estimatedFetchSize
configured for the corresponding data agent to avoid out-of-memory errors while fetching data.
- The
For details, see Data agent memory management.
New Features
Data Management Layer
- Enhanced UI/UX
- Data Catalog enhancements
- Git integration for materialized views and business notebooks (Preview)
- Verified business view materialization
- Integration with Secret Manager
- Support Remote Delta tables discovery
- Comparing schema versions (Preview)
- Data agent enhancements
- More data loading options in the Schema Manager
- Optimized load plans: Restart from failed steps
- Automatically cascade data purge to dependent Materialized Views (MVs)
- Log-based incremental load enhanced to support soft deletes
- Extraction timestamp column
- Showing warnings for invalid joins
- Collecting MV logs
- Load job timeline visualization
- Analyzer tables based on objects with security filters
Architecture and Application Layer
- Streamlining the primary Analytics configuration
- Track variables evaluation and SQLi queries in the Enhanced Audit file
- Enhanced Analytics stability with new workload management options
- Dedicated caching controls for CSV and XLSX insight downloads
- Spark SQL Views Enhancements
- A CMC option for Spark Metastore forced sync
- Improved connectivity with Tableau via Advanced SQLi
- GetColumn function for dynamic column resolution (Preview)
- Data extraction via Advanced SQLi and Public API enhancements
- Service status observability
- Inspector Tool enhancements
Dashboards, Visualizations, and Analytics
- Publicly shared dashboards
- Bubble and Scatter chart enhancements
- Enhanced chart interactivity: Zoom functionality for Cartesian charts
- Enhanced personalization: Consistent views across UI, downloads, and reports
- Enhanced export options for dashboards
- Enhanced PDF export fidelity: Precise layout control
- Performance enhancement in the Slicer component
- Customizable font controls
- Dynamic subtotal labeling
- Custom navigation links
Incorta Copilot
- Training Copilot via reference questions
- Edit SQL within Copilot
- Optimized response delivery
- Number format enhancement in all Copilot answers
- Enhanced search capabilities
Data Management Layer
Enhanced UI/UX
This release delivers a cleaner and improved UI/UX for the navigation pane, Content Manager, and the chart Settings panel, enhancing usability and efficiency across the platform.
Existing custom style sheets (CSS) you have implemented will be outdated after the upgrade and will require updates to align with the new UI's structure.
For details about the new selectors and necessary updates to your custom CSS, refer to References → Customize Incorta with CSS.
Navigation Pane
- Positioned on the left: The navigation pane is now located on the left side of the Analytics platform, with options to expand or collapse for better accessibility and a cleaner layout.
- Sub-links under Content:
- Directory: Provides access to the root directory of the Content Manager, displaying folders, dashboards, and notebooks.
- Favorites: Offers quick access to your favorite dashboards and notebooks
Note: You can now add as many dashboards and notebooks as you want to the Favorites list. The 20-item limit is no longer applicable.
Content > Directory
- Enhanced filtering: Additional filter options to control the displayed items by name, owner, and type (Dashboards or Notebooks in the root directory).
- Layout configurations: Choose from multiple layout styles: Grid, Grid Compacted, List, or List Compacted.
- Content Grouping: Group content by type (dashboards, folders, and Notebooks), modification date, or name (alphabetical grouping).
Settings panel
The Settings panel in charts now organizes format options by element, allowing for precise adjustments to each displayed component, such as axis titles, legends, and values.
Data Catalog enhancements
Expanded asset coverage
This release significantly extends the Data Catalog to include Business Notebooks assets, enhancing their discoverability and governance. Notebooks can now be documented and assigned to tags, domains, and owners.
Streamlined access request workflow
You can now seamlessly request access to data assets you discover within the Data Catalog but don't have permissions for. You can submit requests with justification and desired access levels. The system supports a flexible approval workflow, directly notifying asset owners via a direct email and in-app notification. You then receive notifications for approvals or denials, streamlining data access while maintaining strong governance.
Improved usability and unified user experience
- You can now browse, filter, and search the Content directory from within the Data Catalog, including dashboards and folders you don’t have access to, streamlining asset discovery.
- When searching the Data Catalog, the Search dialog displays the Data Catalog tree along with matching items to select from.
- This release optimized Data Catalog operations for faster loading and smoother interactions.
- The Data Catalog now displays asset counts per definition to enhance user navigation and comprehension.
- The Data Catalog context is now integrated into Incorta’s main screens, including the Schema Manager, Business Schema Manager, Data Manager, and Dashboard Manager, for seamless access and interaction.
Robust audit trail
This release introduces comprehensive Data Catalog audit capabilities, allowing you to track and monitor all Catalog activities, including imports, edits, and definitions. A new data_catalog_audit
folder with Catalog audit files is now available under each tenant's path. You can create a schema table to explore these logged actions and gain a complete audit trail.
Git integration for materialized views and business notebooks (Preview)
The new Git Integration for MVs and business notebooks feature allows users to seamlessly connect Incorta with a compatible Git provider, enabling robust version control for MVs and business notebooks. Users can track versions and retrieve the latest version of an MV or notebook from a remote Git branch. This feature is available as a preview and can be enabled from the Server Configurations under Git Integration. Administrators can configure the integration at the cluster level and link each cluster to a specific Git branch, making version management and tracking more streamlined and efficient.
For more details, refer to Integrations → Git for Version Control.
Verified business view materialization
This release introduces enhancements to business view materialization, improving data accessibility and processing efficiency. These enhancements include:
- Materialize Verified Business Views as Load Plan Actions
- Materialize Verified Business Views via MVs Using the Advanced SQL Interface
Send verified business views to external storage as load plan actions
Incorta introduces Load Plan Actions that are triggered after a load job is completed and the Primary Analytics is updated (processed sync signal of all schemas in a load group).
You can now materialize business views (BVs) as part of Load Plan actions. This allows you to flatten curated datasets after loading and share the resulting Parquet files with other clusters.
Limitation: The materialized data is sent to the cluster's external shared bucket. Contact the support to
Materialize verified business views via MVs using the Advanced SQLi
Schema managers can now compose Spark SQL queries that reference verified business views, leveraging the Advanced SQL Interface and Spark for optimized query processing and Parquet writing.
The Query Verified Business Views using Advanced SQL Interface toggle is now available for Spark SQL MVs.
Limitation: When enabled, the Incremental toggle and Notebook option are disabled.
Integration with Secret Manager
Incorta now supports secure integration with Azure Key Vault and Google Secret Manager to manage and retrieve sensitive credentials, such as passwords, tokens, and keys. This enhancement strengthens security by eliminating the need to store credentials within Incorta and allows organizations to apply Secret Manager policies such as automated secret rotations.
Enabling the Secret Manager Integration
To configure a secret manager, navigate to: CMC > Cluster Configuration > Server Configuration > Secret Manager, then enter the required configuration details for your provider.
Supported use cases
The secret manager integration is available in the following use cases:
- Materialized views (MVs) and Notebooks
Instead of specifying data source credentials in plain text in materialized views (MVs) and notebooks, schema managers can retrieve credentials from the configured secret manager using the following functions for each MV type:- Python:
get_secret(secret_key: String)
- R:
getSecret(secretKey: String)
- Scala:
getSecret(secretKey: String)
- Python:
- Data sources and destinations
A new option, Use Secret Manager, is now available wherever a password, token, or key is required in a data source or a destination definition. When enabled, schema managers can specify the identifier of the secret stored in the configured secret manager. Incorta will automatically retrieve the secret when establishing a connection.
Support Remote Delta tables Discovery
Incorta now supports discovering remote Delta Lake tables when creating a table using data lake connectors, without copying the data into Incorta.
When adding or editing a dataset and enabling the Remote toggle, the Delta Lake appears in the File Type dropdown. When this type is selected, the schema manager must specify the Delta table path, which should be a folder containing the _delta_log
.
Data from remote Delta tables can be accessed through MVs.
Comparing schema versions (Preview)
A new feature allows users to easily compare two schema versions to identify differences in tables, columns, datasets, and their properties. Users can analyze changes in table attributes, joins, filters, and dataset queries. Available as a preview feature, it can be enabled from the tenant configurations under Incorta Labs by toggling the Schema Compare option.
Data agent enhancements
Incorta is introducing multiple improvements to data agents, including the following
- Managing data agents from the Cloud Admin Portal (CAP) (Cloud only)
- Download the data agent logs from the CMC (Cloud only)
- Service auto-discovery by the data agent (Cloud only)
- Data agent memory management (Cloud and On-Premises)
Data agent management in CAP
Instead of managing data agents via the Analytics platform of each tenant, you can now manage all data agents in your Cloud cluster from within the Cloud Admin Portal (CAP) > Cluster > Configurations > Data Agents. This section lists all data agents in your cluster with an enhanced user experience and interface.
A data agent is still designed to operate on a single tenant only.
Download data agent logs from the CMC
You can now download the data agent logs from the CMC > Logs tab.
The following log files are available for download:
- Data Agent Service logs
- Data Agent tenant logs (specific to the selected tenant)
- Data Agent GC logs
- Controller Service logs
- Controller tenant logs (specific to the selected tenant)
- Controller GC logs
- Data agent metrics file
These log files cannot be summarized.
Service auto-discovery
The Data Agent now automatically detects newly added or removed services (Loader, Analytics, etc.) in the cluster without requiring the regeneration of the authentication file.
Data agent memory management
To improve the reliability and stability of the data agent and prevent out-of-memory errors during data fetch operations, Incorta has introduced the following enhancements:
Increased the default value for the
data.agent.data.size.limit
option, which controls the maximum number of bytes returned in each batch.Introduced new configuration options to better manage memory consumption by the data agent.
- Properties configured in the
<data_agent_directory>/bin/options.properties
file on the data agent host machine:fetchThreadsLimit
: The maximum number of threads used to fetch records from related data sources. The default value is 4 times the available CPU cores.estimatedFetchSize
: The estimated number of records a given connector can pull in a single data source call. The default is 30,000.managedMemoryPercentage
: The proportion of the data agent’smemorySize
that the data agent Memory Manager manages during extraction. The default is 0.75.
- Properties configured in the CMC > Server Configurations > Data Agent:
- Data Transfer Batch Size: The maximum size of data chunks sent from the data agent to Incorta after fetching.
- Request Timeout: The time Incorta will wait for a response from the data agent before marking the request as failed.
- Maximum Retries: The number of automatic retry attempts Incorta will make for a failed or timed-out request.
- Properties configured in the
- For Cloud clusters, contact Incorta Support to update the CMC-based configurations.
- The data source fetch size must not exceed the value of the new
estimatedFetchSize
option configured for the corresponding data agent.
More data loading options in the Schema Manager
This release introduces enhanced data loading options on the schema page. These updates streamline data loading processes while offering greater flexibility and efficiency. Key improvements include:
- Load multiple selected objects:
You can now select one or more physical schema objects and load all selected objects simultaneously. You can also start Incremental load jobs for one or more physical schema objects. - Staging load for non-optimized objects:
Non-optimized objects can now be loaded from staging, enabling recovery from compaction issues.
Optimized load plans: Restart from failed steps
You can now restart a load plan from the point of failure when restarting a failed or finished with errors load group, significantly improving load job recovery. This enhancement saves time and resources by skipping successful extraction and enrichment tasks. For data integrity, any subsequent load groups will start from the beginning as usual.
This functionality requires Enable detailed load jobs tracking to be enabled in CMC.
Additionally, a new public API endpoint is available to restart a load plan from a specific group, from the beginning, or from failed steps.
Automatically cascade data purge to dependent Materialized Views (MVs)
Incorta now supports cascading delete operations for downstream materialized views (MVs). To enable this, select the Cascade Delete Operations toggle when configuring Data Retention or Synchronizing Delete Operations on a table. When enabled, MVs in the same load job are fully recalculated after the base table is purged.
Log-based incremental load enhanced to support soft deletes
The log-based incremental load mechanism has been enhanced to support delete operations in the source system using a soft delete approach.
When creating a new table using log-based incremental loading, a special column is now added to indicate delete operations. Users can:
- Use this column in queries to filter out soft-deleted rows
- Leverage it in a purge job to physically remove these rows from Incorta
To add this column to existing tables, you need to validate the tables after the upgrade.
Extraction timestamp column
Starting with 2025.7.0, Incorta automatically adds a new column, reserved_incorta_extraction_timestamp
, to newly created tables. This column stores the timestamp of extraction, enhancing traceability and helping track when each piece of data was ingested into Incorta. It also supports use cases, such as capturing data snapshots or purging data based on the extraction timestamp.
For existing tables, this column will be added after revalidating the table and will be populated only for newly extracted rows.
This column does not apply to Materialized Views (MVs) or Analyzer tables.
Showing warnings for invalid joins
To improve visibility and streamline troubleshooting of join-related issues, Incorta provides visual indicators highlighting invalid joins caused by issues, such as data type mismatches or missing columns in a join's parent or child.
- Warnings in schema screens: The Schema Designer, Table Editor, and Schema Diagram Viewer now display a warning banner when invalid joins are detected.
- Highlighted invalid joins: Invalid joins are marked in the Joins lists for easy identification and resolution.
Collecting MV logs
To help schema managers troubleshoot MV issues, such as failures or performance problems, Incorta now stores the MV logs in a dedicated file saved per MV under the following path /<Incorta_installation>/tenants/{tenantName}/transformerJobsLogs/{Schema}/{MV}/
.
By default, Incorta keeps the details of the latest 10 load jobs per MV; however, this can be overridden by specifying another value for sql.spark.app.archivedLogs.maxEntriesPerMV
in the .properties
file of both the Loader and Analytics services. For Cloud installations, contact the Support team to set the required value.
- Download the MV logs of successful load jobs from the Load Job Details Viewer.
- Download the MV logs of unsuccessful load jobs from the Job Errors dialog.
Load job timeline visualization
The job tracking screen now includes a Gantt chart view that provides a visual timeline of load job execution. Tables are displayed on the vertical axis with tasks shown along a horizontal timeline, making it easier to monitor task progress and sequence. This update also introduces detailed visualization of data extraction durations to help identify performance bottlenecks.
Analyzer tables based on objects with security filters
You can now create Incorta Analyzer tables using base objects that have runtime security filters with user-defined session or global variables. However, these security filters will be ignored when loading or exploring the Analyzer table. To maintain the applied security measures, add the security filters directly to the Analyzer table.
Previously, the $user
system variable in the source object’s security filter would be evaluated incorrectly when loading or exploring the Analyzer table, leading to empty or inaccurate result sets.
Starting with this release, any security filter in the base object containing $user
will be ignored when loading or exploring the Analyzer table.
Architecture and Application Layer
Streamlining the primary Analytics configuration
This release significantly simplifies the configuration of the Advanced SQLi service in On-Premises, multi-Analytics environments. To reduce setup complexity, minimize configuration errors, and eliminate redundant effort when expanding your Analytics services, you can now designate the primary Analytics service directly when adding or editing the Advanced SQLi Service in the CMC.
Previously implemented manual configurations for the primary Analytics service will be ignored upon upgrade, and you must reconfigure it via CMC. Additionally, you must configure the Advanced SQLi service with the Analytics node and service in single- or multi-Analytics environments with custom installations. Otherwise, the Spark Metastore Sync will fail to initialize
To set the primary Analytics service:
- In the CMC > Clusters > <yourCluster> > Nodes, create a new Advanced SQLi service or edit the existing one.
- Select the Analytics Node and Analytics Service, enter the required details, and save the changes.
- Restart all Analytics services.
If the primary Analytics node or service is deleted or stopped, you must manually reassign a primary Analytics node or service in the CMC. Restarting all Analytics services is mandatory upon any update.
Configurations for Cloud clusters are automatically handled and require no additional effort from your side.
Track variables evaluation and SQLi queries in the Enhanced Audit file
- The evaluation of internal session variables and global variables is now tracked for improved traceability and debugging. Variable evaluations appear in the Action table in the Source column with the value of
VARIABLE_EVALUATION
. - SQLi queries executed on the Engine—whether through SQLi connections, Incorta SQL tables, or Incorta SQL views—are now tracked in the enhanced audit, improving traceability and facilitating monitoring and troubleshooting query activity.
Enhanced Analytics stability with new workload management options
This release introduces two new powerful options for CMC administrators to maintain Analytics service stability and responsiveness during periods of high demand. Accessible via CMC > Cluster Configurations > Server Configurations > Workload Management, these settings provide granular control over query rejection to prevent overload and preserve the performance of running tasks.
- Analytics Task Queue Limit Calculation (%): This setting determines the maximum number of queued tasks based on a percentage of the CPU cores. When exceeding the calculated limit, new insight rendering and dashboard search requests are temporarily rejected.
- Analytics Concurrent Service Max Wait Time (in seconds): When the wait time of queued tasks related to the Analytics concurrent service exceeds this threshold, new queries are temporarily rejected.
Dedicated caching controls for CSV and XLSX insight downloads
To improve performance and resource management during insight downloads in CSV and XLSX formats, this release introduces two new properties that control how the Analytics Service caches data on disk. The properties are available under CMC > Tenant Configurations > Tuning.
- Maximum Cached Entries on Disk: The maximum number of distinct insights (entries) that can be cached for CSV and XLSX downloads and shares.
- Maximum Cached Disk Size (In Gigabytes): The total disk space available for caching CSV and XLSX insights.
These new options, along with the Export to CSV/XLSX Caching Limit (In Megabytes) option, now govern caching insights downloaded in CSV or XLSX format.
Caching will be disabled if:
- Maximum Cached Entries on Disk is set to 0.
- The downloaded insight's size exceeds the Export to CSV/XLSX Caching Limit (In Megabytes) limit.
- If the overall cached insights reach the Maximum Cached Disk Size (In Gigabytes) threshold.
Spark SQL Views Enhancements
Support for multi-value variables
In this release, the new function, getVarList(<varName>),
is now available to return a list of values from a session or global variable, allowing Spark SQL Views to handle multi-value filters. This enhancement improves query accuracy, supports more interactive dashboards, and eliminates previous limitations with single-value filtering.
- The maximum number of values returned by
getVarList
is 1,000. - All values returned by
getVar
orgetVarList
are treated as strings.
Performance enhancements for filters based on Spark SQL View columns
This release enhances the performance of dashboards and insights that use filters based on Spark SQL View columns. Supported filters, such as equals, not equals, greater than, in, and between, are now pushed down to Spark for execution. This eliminates the need to transfer full datasets to the Incorta Engine for filtering.
As a result, you'll experience faster query execution across dashboards, prompts, dynamic fields, and filter option lists, as long as the filters do not depend on session, global, or presentation variables.
A CMC option for Spark Metastore forced sync
In this release, CMC administrators can now easily trigger a forced sync of the Spark Metastore directly from the CMC UI. To access this feature, navigate to:
CMC → Tenants → [Select a Tenant] → More Options (⋮) → Sync Spark Metastore → Force Sync Spark Metastore
With this enhancement, syncing the Spark Metastore no longer requires manually running the sync_spark_metadata_all_schemas.sh
script, offering a faster and more user-friendly approach.
This feature is exclusively available to CMC admins and cannot be accessed by cloud admins.
Improved connectivity with Tableau via Advanced SQLi
A new version (1.10.1) of the Incorta Custom Kyuubi Hive JDBC jar is now available to connect Incorta and Tableau via Advanced SQLi. It is strongly recommended to use this version after upgrading to 2025.7.0.
You can download the new jar version either from this link or from the Connect other Visualization Tools page > Tableau > Advanced SQL after the upgrade.
For details about the required steps to add the new jar, refer to Configure Tableau to connect to Incorta.
GetColumn function for dynamic column resolution (Preview)
In this release, a beta version of the getColumn
function is now available, allowing you to create more dynamic and reusable dashboards by selecting columns at runtime based on global variables, presentation variables, or text values. Instead of hardcoding specific schema, table, or column names, you can use this function to adjust insights automatically based on your selections or filters.
For more details, refer to Built-in Functions → getColumn.
Data extraction via Advanced SQLi and Public API enhancements
The extract to external table endpoint, /extraction/table
, now supports extracting verified business views to CSV as well as Parquet. CSV export enhances compatibility and flexibility by simplifying integration with downstream tools, enabling quick data validation, and supporting widely used formats like Excel and BI platforms.
To specify the format, use the new dataFormat
parameter in the endpoint request. Supported values are case-insensitive (CSV
and Parquet
). If a valid format is not provided, the export defaults to Parquet
.
Service status observability
The Nodes tab in the Cluster Management Console (CMC) now shows the exact status when starting up or stopping the Loader and Analytics services indicated via color codes.
The service statuses include the following:
- Final statuses:
- Started
- Started with Warnings
- Failed to Start
- Terminated UnExpectedly
- Not Responding
- Stopped
- Sleeping
- Error
- NA
- Intermediate states:
- Starting
- Shutting down
- Starting Tenants
- Processing
Incorta uses a dedicated port for each service to track the service status. The status observability port is specified in the service.properties
file per service. The defaults are 65531 for Analytics and 65532 for Loader. These ports should be available and accessible before starting the services. In the case of a multi-Analytics node, you must manually change the status observability port for one of the Analytics services in the service.properties
file.
Inspector Tool enhancements
A new version of the Inspector schema
A new and updated version of the Incorta Metadata New Suite Tools data application is now available in the Marketplace. This version integrates the new Inspector reports that were introduced in recent 2024.x releases, providing even deeper insights into your Incorta environment. Additionally, an updated version of the files containing these new reports is also available for direct download from the CMC, offering an alternative method to acquire the latest Inspector capabilities.
A new report for duplicate variables
To help ensure data integrity, a new duplicateVariableNames
report is now available via the Inspector Tool. This report helps you identify any duplicate session and global variable names that can lead to inaccurate insights.
You must run this report and resolve any identified duplicate variable names to maintain data accuracy.
The new Inspector schema and data application do not automatically include this report. To access it, manually edit your existing Inspector schemas and dashboards to add the duplicateVariableNames
report.
Dashboards, Visualizations, and Analytics
Publicly shared dashboards
Dashboard owners can now share dashboards with external stakeholders via a public link. This link provides flexible access, allowing the dashboard to be viewed as a standalone web page or seamlessly embedded into other applications.
Anyone possessing this link will be able to view the shared dashboard. All future edits made to the dashboard will be automatically published, ensuring external viewers always have access to the most current information.
Should there be a need to restrict access, you can unpublish dashboards at any time, immediately revoking external access.
Bubble and Scatter chart enhancements
This release introduces multiple enhancements to the Bubble and Scatter charts, including the following:
- A new tray for Bubble charts: Break By
- Lasso selection support in Bubble and Scatter charts
- Enhanced Analysis in Bubble charts using reference lines
New tray for Bubble charts: Break By
Previously, the Bubble chart only supported Color By for grouping and differentiation. With the new Break By functionality, you can now:
- Group (Break) points by a primary dimension without affecting the existing coloring. This allows for clear visual segmentation of your data.
- Subsequently, use the Color By tray to apply coloring based on a second distinct dimension or measure, enabling multi-dimensional analysis within the same chart.
This means you can now group your bubbles (e.g., by region) and then color them (e.g., by product category within each region).
- The Break By functionality requires that the X and Y dimensions must have an aggregation applied.
- When represented as an Aggregate Table, the Break By dimension will now precede the Color By dimension in the query order.
This enhancement provides a powerful new way to visualize and analyze complex datasets in the Bubble chart, offering deeper insights through layered grouping and coloring.
Lasso selection support in Bubble and Scatter charts
A powerful new Lasso selection feature has been introduced for Bubble and Scatter charts, enabling dashboard consumers to precisely select clusters of data points by drawing an irregular, free-form shape. This intuitive tool simplifies the selection of complex or non-rectangular groupings that are difficult to isolate with traditional methods. Any data points entirely or partially enclosed by the drawn shape will be selected, allowing you to instantly apply dashboard and insight filters based on your precise selection. After selecting the required data points, click within the free-form shape to filter the dashboard and insights accordingly.
Enhanced analysis in Bubble charts using reference lines
Bubble charts are now significantly more powerful with the introduction of advanced dynamic quadrant analysis capabilities through customizable reference lines. You can now divide charts horizontally and vertically based on constant values or calculated measurements, such as averages and medians, enabling more granular data segmentation.
This enhancement allows for the simultaneous addition of multiple reference lines of various types, offering greater analytical depth. Additionally, you gain extensive control over visualization, with the ability to apply styling options to reference lines, color them, and optionally display their labels and values.
Enhanced chart interactivity: Zoom functionality for Cartesian charts
To enable more granular data analysis, Incorta now introduces an intuitive zoom feature for most Cartesian charts, mirroring the highly effective functionality currently available in the Time Series charts.
This new capability provides a dedicated interface to zoom in on a specific range of values within the graph, allowing for a focused and detailed examination of particular data segments. This significantly enhances interactive exploration, making it easier to pinpoint trends, anomalies, or specific data points within a larger dataset.
The following are the chart types that support the zoom functionality:
- The Line, Bar, Column, and Area family charts
- Combo, Dual X-Axis, and Combo Dual Axis
- Stacked Column and Line
- Tornado
Enhanced personalization: Consistent views across UI, downloads, and reports
Starting with this release, your dashboard personalization settings are now consistently honored when downloading or sending reports, ensuring the view you have customized is the view shared. This includes your selected insights and columns, custom column order, and preferred tab layout.
Personalization is retained in the following scenarios:
- Dashboard downloads: When downloading insights or tabs in HTML, PDF, or XLSX formats and the dashboard is actively displayed in personalization mode.
- Sending dashboards or insights: When dashboards or insights are sent in HTML or PDF format, and the sending user has applied dashboard personalization settings.
- For bursting reports, the recipient user's personalization settings will be honored, ensuring each recipient sees the report tailored to their own saved preferences, rather than the sender's.
- To send the original, unpersonalized view, the sending user (or the recipient in the case of bursting reports) must first reset their personalization settings before initiating the send action.
Enhanced export options for dashboards
Incorta dashboards now support enhanced export options, allowing users to configure settings such as including column headers, specifying quoting behavior, choosing delimiters, setting file encoding, and defining null value replacements. Additionally, exports can now be sent directly to cloud data lake destinations, including Azure Data Lake Storage (ADLS), Google Cloud Storage (GCS), and Amazon S3.
Enhanced PDF export fidelity: Precise layout control
This release introduces new controls for PDF export rendering, ensuring that exported PDFs precisely match the desired dashboard view and providing greater fidelity and control over the exported layout.
In the CMC > Server Configurations > Email tab, you can now define the following options:
- Chromium Browser Dimensions: Specifies the screen size used during the dashboard export process. This option introduces a list of predefined screen sizes, in addition to an option to set a custom size.
- Chromium Browser Scale Factor: Specifies the zoom ratio used during the export process.
Customizable font controls
This release introduces additional text formatting options in charts, offering granular control over font size and color. You can adjust the font size and color for each component, including titles, legends, and values.
Dynamic subtotal labeling
This release enhances tabular insights by providing dynamic subtotal labeling. You can now use the actual grouping dimension value as the subtotal label, replacing generic labels with clear, context-specific identifiers. You can also append a customized prefix or suffix to the grouping dimension value.
Performance enhancement in the Slicer component
The List and Dropdown Slicer component now features an Apply button, allowing users to apply selected filters in a single action. This improvement enhances dashboard performance by consolidating filter selections into a single query, reducing the number of individual queries sent to the Analytics engine.
The system also proactively identifies and cancels unnecessary running queries, ensuring more efficient resource allocation and significantly improving performance.
Custom navigation links
You can now add a list of custom internal and external links to the navigation pane, providing quick access to your most important resources.
To configure custom links:
- Navigate to CMC > Tenant Configurations > Incorta Labs.
- In the Other Links section, add your links as a line-separated list.
- For each link, provide the following details, separated by commas:
- Link label: The display name for the link
- URL: The complete web address for the link
- Link target:
out
: Opens the link in a new browser tab (default)in
: Opens the link as embedded content in the Incorta platform workspace
Example:
Docs,https://docs.incorta.com,inReports,https://www.mycompany.com/reports/main-dashboard,out
To securely display embedded content from external domains, you must whitelist them in your Incorta environment. The process varies depending on your deployment type.
- For Cloud environments, contact the Support team.
- For On-Premises environments, edit the Analytics
node.properties
file and add the following for each domain you want to whitelist:
content.security.allow-list.script.ext=<domainURL>content.security.allow-list.connect.ext=<domainURL>content.security.allow-list.style.ext=<domainURL>content.security.allow-list.frame.ext=<domainURL>content.security.allow-list.base-uri=<domainURL>content.security.allow-list.font.ext=<domainURL>content.security.allow-list.media.ext=<domainURL>
Replace <domainURL>
with the full URL of the domain you are whitelisting. You must restart the Analytics service afterward.
Incorta Copilot
Training Copilot via reference questions
Schema Managers can now train Incorta Copilot by adding referenced business questions paired with verified answers to business views. This enhancement helps ensure consistent, accurate, and trusted results for frequently asked or complex questions that require non-trivial queries.
You can add referenced questions to a business view via the Data Catalog or by saving questions answered by Copilot.
To manually add a reference question to a business view:
- Navigate to the Data Catalog and select the business schema view you want to add reference questions to.
- On the Copilot Tuning tab, select New.
- In the New dialog, add the question and the corresponding SQL query, and then save the changes.
To add a question answered by Copilot to the view’s referenced questions:
- In Copilot, after receiving the answer to a posted question, select the Add this question to Referenced Questions button.
- In the New dialog, edit the question and SQL query as required, and then select Save.
When you set the context to a view, Copilot displays these saved questions. You can select a question to get an answer based on the corresponding, pre-validated query. Additionally, when receiving a question, Copilot semantically searches the referenced questions within the selected view to find a similar one and uses it as a guide for generating a more accurate and consistent response.
Edit SQL within Copilot
Incorta Copilot now allows users with Edit access to the underlying business schema to modify the SQL queries generated by Copilot in the Query Breakdown dialog. Once edited, the updated query is submitted as a new question, and Copilot responds based on the refined input.
This enhancement empowers users with greater flexibility, control, and accuracy in their data analysis, enabling them to refine and optimize queries to better align with their specific business needs and deliver more accurate insights.
Optimized response delivery
Copilot now generates the summary and insight separately and returns whichever is ready first, along with the underlying SQL query. This significantly improves performance and responsiveness and ensures faster feedback and a smoother user experience.
Number format enhancement in all Copilot answers
Incorta Copilot now offers standardized number formatting with the exclusion of scientific notation in advanced analytics features (such as clustering and forecasting) and SQL-based answers. Additionally, Copilot now utilizes Incorta's number format when defaulting to Incorta-native insights, ensuring a more consistent and user-friendly experience across all interactions.
Enhanced search capabilities
For more precise data discovery, you can now perform column-specific searches by first selecting a column using @<ColumnName>
and then searching with #<data>
, which limits the search to that column. If no column is selected, the #<data>
search continues to work on all data, providing greater control and efficiency in finding information.
Fixes and Enhancements
In addition to the new features and major enhancements mentioned above, this release introduces enhancements and fixes that help make Incorta more stable, engaging, and reliable.
Enhancements
Enhancement | Area |
---|---|
You can now delete a result set directly from the Analyzer. Important: This action will cause an error if any column from the deleted result set is referenced in the insight. | Analyzer |
The path to the offline Marketplace is now displayed in the CMC > Server Configurations > Clustering. | CMC |
The experience of sorting data in tabular insights within the dashboard viewer has been refined for more intuitive and efficient data analysis. Now, for all Aggregated, Listing, and Visual (SDK) tables, the initial click on any column header will default to a descending sort; a second click will switch to ascending; and a third will revert to the original order. | Dashboards |
A new Print Table option is now available to give you more control over printing insights. This feature invokes your browser or system's native Print dialog, allowing you to print insights directly as a PDF or to a physical printer with more print options, such as print range, paper size, and scaling percentage. | Dashboards |
You can now use your browser or system Print dialog to print dashboards and insights that have been sent or downloaded in HTML format, providing you with more flexibility and control. | Dashboards |
The SFTP data destination now supports SSH authentication and PGP encryption. | Data Destinations |
The Catalog listing endpoints, /catalog , /catalog/search , and /catalog/folder/{folderId} , now return the following as part of their responses: Parent ID (parentId ) Creation date and time (creationDate ) Modification date and time (modificationDate ) | Public API |
You can now schedule jobs to run on specific dates by explicitly selecting the months in which the job should execute. This provides greater flexibility and control over job scheduling. | Scheduler |
Enhanced performance for aggregated and grouped listing tables when sorting by columns that are different from those used in dimensions or measures. | Visualizations |
Fixes
Fixed Issue | Area |
---|---|
Data masking was not applied on Insights based on insight over Spark SQL result set. | Data Classification |
Data masking was not applied when being used in SQL queries with LATERAL subqueries in the Advanced SQLi. | Data Classification |
In rare cases, it was possible to create session or global variables with identical names. This has been fixed; variable names are now always unique, preventing potential conflicts and data inconsistencies. You can use the new duplicateVariableNames Inspector report to identify duplicate variables in your tenant. | Variables |