@@ -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