Skip to content

Commit 5f02e8a

Browse files
Merge pull request #2708 from MicrosoftDocs/main638907878391662106sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents f4fe2c9 + f798a2f commit 5f02e8a

File tree

1 file changed

+4
-6
lines changed

1 file changed

+4
-6
lines changed

data-explorer/kusto/query/materialize-function.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,16 +34,14 @@ The `materialize()` function is useful in the following scenarios:
3434
> Materialize has a cache size limit of **5 GB**. This limit is per cluster node and is mutual for all queries running concurrently. If a query uses `materialize()` and the cache can't hold any more data, the query will abort with an error.
3535
3636
>[!TIP]
37-
> Another way to perform materialization of tabular expression is by using the `hint.materialized` flag
38-
> of the [as operator](as-operator.md) and [partition operator](partition-operator.md). They all share a
39-
> single materialization cache.
40-
41-
>[!TIP]
42-
>
37+
>* Another way to perform materialization of tabular expression is by using the `hint.materialized` flag of the [as operator](as-operator.md) and [partition operator](partition-operator.md). They all share a single materialization cache.
4338
>* Push all possible operators that reduce the materialized dataset and keep the semantics of the query. For example, use common filters on top of the same materialized expression.
4439
>* Use materialize with join or union when their operands have mutual subqueries that can be executed once. For example, join/union fork legs. See [example of using join operator](#examples-of-query-performance-improvement).
4540
>* Materialize can only be used in let statements if you give the cached result a name. See [example of using let statements](#examples-of-using-materialize)).
4641
42+
>[!CAUTION]
43+
> Benchmark your queries with and without materialize() to see if it improves performance for your data and query patterns. In some cases, materialize() can increase memory usage without providing significant performance gains, so testing helps you choose the best approach.
44+
4745
## Examples of query performance improvement
4846

4947
The following example shows how `materialize()` can be used to improve performance of the query.

0 commit comments

Comments
 (0)