Skip to content

Commit 0d45df0

Browse files
committed
docs(pivotgrid): Explain differences between local and XMLA binding
1 parent a0df573 commit 0d45df0

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

components/pivotgrid/data-binding.md

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,15 +20,22 @@ The PivotGrid supports different data sources via its `DataProviderType` paramet
2020
* [`Local`](#local) (default)
2121
* [`Xmla`](#xmla)
2222

23+
### Usage Differences
24+
25+
The available data providers differ in several ways:
26+
27+
* XMLA binding is more complex to setup, but more flexible.
28+
* Local data with a `DateTime` property does not support automatic aggregations by date periods like years, months, weeks, and so on.
29+
* XMLA binding supports [load on demand](slug:pivotgrid-overview#pivotgrid-parameters), which offloads all calculations to the external data source. Local binding receives all data at once and performs all aggregate calculations in-memory. Large amounts of local data may impact the performance, especially in WebAssembly apps.
30+
* When using load on demand, XMLA binding supports custom aggregate functions that are defined and performed in the OLAP cube. Local data supports only the [predefined aggregate types in the `PivotGridAggregateType` enum](slug:telerik.blazor.pivotgridaggregatetype).
31+
* When using local data, all defined measures in `<PivotGridMeasures>` render by default in the PivotGrid. Users can uncheck and hide the measures they don't need from the [PivotGrid Configurator](slug:pivotgrid-configurator).
2332

2433
## Local
2534

26-
When bound to local data, the Pivot Grid requires its `Data` parameter to provide all the data at once as `IEnumerable<TItem>`. The component will perform all aggregate calculations in-memory and there is no [load on demand](slug:pivotgrid-overview#pivotgrid-parameters).
35+
When bound to local data, the Pivot Grid requires its `Data` parameter to provide all the data at once as `IEnumerable<TItem>`.
2736

2837
If the local data changes programmatically, you need to reset the collection instance or [call the PivotGrid `Rebind()` method](slug:pivotgrid-overview#pivotgrid-reference-and-methods). See the common documentation about [refreshing component data](slug:common-features-data-binding-overview#refresh-data) for details.
2938

30-
> Large amounts of local data may impact the performance, especially in WebAssembly applications.
31-
3239
>caption PivotGrid bound to Local data provider
3340
3441
<div class="skip-repl"></div>

0 commit comments

Comments
 (0)