Skip to content

Commit 0075e7c

Browse files
Merge pull request #2849 from MicrosoftDocs/main639069265688772797sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 85df00b + e17533d commit 0075e7c

1 file changed

Lines changed: 15 additions & 6 deletions

File tree

data-explorer/kusto/management/show-extents.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -22,12 +22,21 @@ The types of `.show extents` commands are as follows:
2222
* Show some or all extents for the entire [cluster](#cluster-scope)
2323

2424
> [!NOTE]
25-
> The `.show extents` command may consume a lot of resources if it runs on a scope
26-
> (such as a database or a cluster) with many extents. We recommended
27-
> using the command variant at the lowest possible scope. Table-scope
28-
> is preferable over database-scope, and database-scope over cluster-scope. The
29-
> command variant that includes filtering extents is preferable to filtering the results
30-
> of the command using another query.
25+
> The `.show extents` command may consume a lot of resources, and even
26+
> exceed internal limits if run at a scope (such as a database or a cluster)
27+
> that has many extents (more than 5 millions.)
28+
>
29+
> For purposes of monitoring the number of extents, it's **strongly recommended**
30+
> that alternative methods (such as using [.show databases datastats](./show-databases.md),
31+
> [.show database datastats](./show-database.md), or [.show tables details](./show-tables-command.md),
32+
> and [.show table details](./show-table-details-command.md)) be used. Another efficient way
33+
> to retrieve the number of extents is to use a metric exposed through Azure Monitor ("Total Extents").
34+
>
35+
> If detailed listing of extents is required, be sure to use the "smallest"
36+
> appropriate command scope (table) over the "larger" ones (database, cluster).
37+
>
38+
> Also, prefer using the command variant that includes extent filtering capabilities as part of the
39+
> command's syntax to using the command and processing its results by "piping" them to a query.
3140
3241
## Permissions
3342

0 commit comments

Comments
 (0)