Share via

.show extents

  • Artikel

Hinweis

Datenshards werden als Blöcke bezeichnet, und alle Befehle verwenden "extent" oder "extents" als Synonym. Weitere Informationen zu Blöcken finden Sie unter Übersicht über Blöcke (Datenshards).

Die Befehlstypen .show extents sind wie folgt:

  • Anzeigen einiger oder aller Blöcke für einen bestimmten Tabellenbereich
  • Anzeigen einiger oder aller Blöcke für einen bestimmten Datenbankbereich
  • Anzeigen einiger oder aller Blöcke für den gesamten Cluster

Hinweis

Der .show extents Befehl kann viele Ressourcen verbrauchen, wenn er in einem Bereich (z. B. einer Datenbank oder einem Cluster) mit vielen Blöcken ausgeführt wird. Es wird empfohlen, die Befehlsvariante im niedrigsten möglichen Bereich zu verwenden. Der Tabellenbereich ist dem Datenbankbereich und dem Datenbankbereich gegenüber dem Clusterbereich vorzuziehen. Die Befehlsvariante, die Filtererweiterungen enthält, ist dem Filtern der Ergebnisse des Befehls mithilfe einer anderen Abfrage vorzuziehen.

Berechtigungen

Um Blöcke im Cluster anzuzeigen, müssen Sie über allDatabasesMonitor-Berechtigungen verfügen.

Um Blöcke für eine Datenbank anzuzeigen, müssen Sie über die Berechtigungen Datenbankbenutzer, Datenbank-Viewer oder Datenbankmonitor verfügen.

Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung.

Tabellenbereich

Syntax

Zeigt Informationen zu Blöcken (Datenshards) an, die in den angegebenen Tabellen vorhanden sind. Die Datenbank wird aus dem Kontext des Befehls übernommen. Wenn hot angegeben ist, werden nur Blöcke angezeigt, von denen erwartet wird, dass sie sich im heißen Cache befinden.

.showtableTablenameextents [(ExtentId [, ...])] [hot] [wheretags (has!has|contains!contains||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

.showtables(TableName [, ...])extents [(ExtentId [, ...])] [hot] [wheretags (has!has|contains!contains||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
TableName string ✔️ Der Name der Tabelle.
ExtentId string Die ID des anzuzeigenden Umfangs.
Tag string Der Name eines Tags, nach dem wie angegeben gefiltert werden soll.

Empfehlungen

  • Die Verwendung integrierter Filterfunktionen im Befehl wird gegenüber dem Hinzufügen eines abfragebasierten Filters (z. B. hinzufügen | where DatabaseName == '...' und TableName == '...') bevorzugt.
  • Wenn die optionale Liste der Erweiterungs-IDs angegeben wird, ist das zurückgegebene Dataset nur auf diese Blöcke beschränkt.
    • Diese Methode ist schneller als das Filtern (Hinzufügen | where ExtentId in(...)von ) zu den Ergebnissen von "bare" Befehlen.
  • Wenn tags Filter angegeben sind:
    • Die zurückgegebene Liste ist auf die Bereiche beschränkt, deren Tagssammlung allen bereitgestellten Tagsfiltern gehorcht.
    • Diese Methode ist schneller als das Filtern (Hinzufügen | where Tags has '...' and Tags contains '...' zu) der Ergebnisse von "bare"-Befehlen.
    • has Filter sind Gleichheitsfilter. Blöcke, die nicht mit einem der angegebenen Tags gekennzeichnet sind, werden herausgefiltert.
    • !has Filter sind Gleichheitsfilter. Blöcke, die mit einem der angegebenen Tags gekennzeichnet sind, werden herausgefiltert.
    • contains filter sind Teilzeichenfolgenfilter, bei denen die Groß-/Kleinschreibung nicht beachtet wird. Blöcke, die nicht über die angegebenen Zeichenfolgen als Teilzeichenfolge ihrer Tags verfügen, werden herausgefiltert.
    • !contains bei Filtern handelt es sich um negative Filter, bei denen die Teilzeichenfolge nicht beachtet wird. Blöcke, die über die angegebenen Zeichenfolgen als Teilzeichenfolge eines ihrer Tags verfügen, werden herausgefiltert.

Datenbankbereich

Zeigt Informationen zu Blöcken (Datenshards) an, die in der angegebenen Datenbank vorhanden sind. Wenn hot angegeben ist: Zeigt nur Blöcke an, die erwartet werden, dass sie sich im heißen Cache befinden.

Syntax

.showdatabaseDatabasenameextents [(ExtentId [, ...])] [hot] [wheretags (has!has|contains!contains||) TagName [andtags (has|contains||!contains!has) TagName [, ...]]]

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich BESCHREIBUNG
DatabaseName string ✔️ Der Name der Datenbank.
ExtentId string Die ID des anzuzeigenden Umfangs.
Tag string Der Name eines Tags, nach dem wie angegeben gefiltert werden soll.

Clusterbereich

Syntax

.showclusterextents [hot]

Erfahren Sie mehr über Syntaxkonventionen.

Zeigt Informationen zu Blöcken (Datenshards) an, die im Cluster vorhanden sind. Wenn hot angegeben ist– zeigt nur Blöcke an, die sich voraussichtlich im heißen Cache befinden.

Gibt zurück

Ausgabeparameter type BESCHREIBUNG
ExtentId guid ID des Umfangs
DatabaseName string Datenbank, zu der der Umfang gehört
TableName string Tabelle, zu der die Blöcke gehören
MaxCreatedOn datetime Datum und Uhrzeit der Erstellung des Umfangs. Bei einem zusammengeführten Bereich die maximale Erstellungszeit zwischen Quellausdehnungen
OriginalSize Double Originalgröße in Byte der Ausdehnungsdaten
ExtentSize Double Größe des Bereichs im Arbeitsspeicher (komprimiert + Index)
CompressedSize Double Komprimierte Größe der Ausdehnungsdaten im Arbeitsspeicher
IndexSize Double Indexgröße der Ausdehnungsdaten
Blöcke long Anzahl der Datenblöcke im Umfang
Segmente long Anzahl der Datensegmente im Umfang
ExtentContainerId string ID des Bereichscontainers, in dem sich der Bereich befindet
RowCount long Anzahl der Zeilen im Bereich
MinCreatedOn datetime Datum und Uhrzeit der Erstellung des Umfangs. Für einen zusammengeführten Bereich die minimale Erstellungszeit unter den Quellausdehnungen
Tags string Tags, falls vorhanden, für den Bereich definiert
Variante string Die Art der Speicher-Engine, die den Bereich erstellt hat
DeletedRowCount long Anzahl der gelöschten Zeilen im Bereich

Beispiele

Markierte Ausdehnung

Die Blöcke E in der Tabelle T sind mit Tags aaa, BBBund cccgekennzeichnet.

  • Diese Abfrage gibt zurück E:

      .show table T extents where tags has 'aaa' and tags contains 'bb'

  • Diese Abfrage wird nicht zurückgegeben E , da sie nicht mit aagekennzeichnet ist:

      .show table T extents where tags has 'aa' and tags contains 'bb'

  • Diese Abfrage gibt zurück E:

      .show table T extents where tags contains 'aaa' and tags contains 'bb'

Anzeigen des Volumens der erstellten Blöcke

Anzeigen der Menge der Blöcke, die pro Stunde in einer bestimmten Datenbank erstellt werden

.show database MyDatabase extents | summarize count(ExtentId) by MaxCreatedOn bin=time(1h) | render timechart

Anzeigen des Datenvolumens, das nach Tabelle pro Stunde eintrifft

.show database MyDatabase extents  
| summarize sum(OriginalSize) by TableName, MaxCreatedOn bin=time(1h)  
| render timechart

Anzeigen der Datengrößenverteilung nach Tabelle

.show database MyDatabase extents | summarize sum(OriginalSize) by TableName

Alle Blöcke in der Datenbank mit dem Namen "GamesDB" anzeigen

.show database GamesDB extents

Alle Blöcke in der Tabelle mit dem Namen "Games" anzeigen

.show table Games extents

Anzeigen aller Blöcke in bestimmten Tabellen

Alle Blöcke in den Tabellen "TaggingGames1" und "TaggingGames2" anzeigen, die sowohl mit "tag1" als auch "tag2" gekennzeichnet sind

.show tables (TaggingGames1,TaggingGames2) extents where tags has 'tag1' and tags has 'tag2'