Document toolboxDocument toolbox

Using aggregates

Applies to: Kyvos Enterprise  Kyvos Cloud (SaaS on AWS) Kyvos AWS Marketplace

Kyvos Azure Marketplace   Kyvos GCP Marketplace Kyvos Single Node Installation (Kyvos SNI)


Note

Kyvos comes with certain built-in semantic models to help you monitor the Kyvos system. To analyze query details, see the Built-in Kyvos semantic models for monitoring  section for more details. 

An aggregate represents the summarization of measure data at a certain granularity of the dimensions (for example, at specific levels and attributes of dimensions of a semantic model). Aggregates are precalculated summaries that improve query response time by preparing some answers before questions are asked. 

Kyvos uses query history and processes over time to create an aggregation strategy. As users continue to query, Kyvos learns which aggregates need to be built and the system slowly and gradually recommends deepening aggregates for a semantic model based on query pattern and data pattern analysis. The objective is to improve query performance under the constraint of keeping aggregates’ size (i.e. the total semantic model size) in control.

Get Recommendations

The Recommendations review includes suggesting an aggregation strategy. When you use Get Recommendations on a semantic model, you can recommend building only the aggregation strategy or only newer aggregates. When you get recommendations for an already processed semantic model, the system recommends newer aggregates and removes previous aggregates that are not in use.

  • When you see the Aggregation Strategy from Get Recommendations, you can accept the recommendations or show the recommended aggregates to see what's proposed.

  • When you do a Scheduling semantic model processes, you can choose to process using the system-recommended aggregation strategy. 

  • You can also schedule an Update Aggregates process for an already processed semantic model, which updates the semantic model with the newer aggregation strategy. 

Note

  • With the Kyvos 2023.1 release onwards, during the Update Aggregate process, if some cuboids are successful and others fail, the process is marked as a  Partial Success  with the percentage of successful cuboids displayed on the Job Summary. Additionally, the newly created cuboid is now marked as browsable. 

  • You can also view the log details of the input cuboid versus the output cuboid along with Measure Datasets by using the Download Logs option on the Job Summary page. 

  • On the Update Aggregate process summary screen, you will see various details, including updated partition details, advanced properties, error/warnings, and cuboid details when the semantic model is partially built.

Aggregation Strategy

You can define an aggregation strategy when designing a semantic model. You can also specify recommendations for physical view, partitions, and advanced properties.

Start by selecting which mode you want to use for your aggregation strategy, Expert or Smart

  • Expert (user-driven) is configuration-driven and allows you to tune your semantic model performance by setting up key materialization values and the precompute threshold level. The application displays recommendations based on historical queries and data profiles if needed. You can view how many dimensions or hierarchy materializations are selected from the summary screen. You can view details, make changes, or learn more by clicking the i symbol. You can also see the degree of materialization and the precompute threshold. For all of these items, you can see whether it is the default, inherited, or modified. Use this option if you want to have more control over what aggregates to be built. 

  • Smart (system-driven) is query-based, allowing you to filter or analyze historical queries and work with data profile information. You can set the materialization level and specify whether to use fresh aggregates or to add additional aggregates in addition to any existing ones. Use this option if you want to get quick insights with a low learning curve. You will be prompted to regenerate aggregates after changes to the semantic model design.

Note

  • Switching from the smart aggregation strategy mode will clear existing aggregates on saving the semantic model. 

  • Changing the Aggregation Strategy Mode requires a full process. It may also result in the failure of subsequent incremental processes.

For processed semantic models, you can also use the Recommend me link to learn more. You will see the recommendations, descriptions, and reasons. At a glance, you can also see what will be added, modified, moved, or deleted. You can modify the recommendations by clicking the Actions menu (...) or click Accept

To define the aggregation strategy during semantic model design, perform the following steps: 


Related topics

Copyright Kyvos, Inc. All rights reserved.