.show extents

Notitie

Gegevensshards worden gebieden genoemd en alle opdrachten gebruiken 'extent' of 'extents' als synoniem. Zie Overzicht van gebieden (gegevensshards) voor meer informatie over gebieden.

De typen .show extents opdrachten zijn als volgt:

• Sommige of alle gebieden voor een specifiek tabelbereik weergeven
• Sommige of alle gebieden voor een specifiek databasebereik weergeven
• Sommige of alle gebieden voor het hele cluster weergeven

Notitie

De .show extents opdracht kan veel resources verbruiken als deze wordt uitgevoerd op een bereik (zoals een database of een cluster) met veel gebieden. We raden u aan de opdrachtvariant te gebruiken in het laagst mogelijke bereik. Tabelbereik heeft de voorkeur boven databasebereik en databasebereik boven clusterbereik. De opdrachtvariant die filtertermen bevat, heeft de voorkeur boven het filteren van de resultaten van de opdracht met behulp van een andere query.

Machtigingen

Als u gebieden in het cluster wilt zien, moet u over AllDatabasesMonitor-machtigingen beschikken.

Als u gebieden in een database wilt zien, moet u beschikken over de machtigingen Databasegebruiker, DatabaseViewer of Databasemonitor.

Zie op rollen gebaseerd toegangsbeheer voor meer informatie.

Tabelbereik

Syntax

Geeft informatie weer over gebieden (gegevensshards) die aanwezig zijn in de opgegeven tabellen. De database wordt uit de context van de opdracht gehaald. Als hot is opgegeven, worden alleen gebieden weergegeven die naar verwachting in de hot-cache zijn.

.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 [, ...]]]

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
TableName	string	✔️	De naam van de tabel.
ExtentId	string		De id van het gebied dat moet worden weergegeven.
Tag	string		De naam van een tag om op te filteren zoals opgegeven.

Aanbevelingen

• Het gebruik van ingebouwde filtermogelijkheden in de opdracht heeft de voorkeur boven het toevoegen van een filter op basis van query's (zoals toevoegen | where DatabaseName == '...' en TableName == '...').
• Als de optionele lijst met gebieds-id's wordt opgegeven, is de geretourneerde gegevensset beperkt tot alleen die gebieden.
  • Deze methode is sneller dan filteren (toevoegen | where ExtentId in(...)) aan de resultaten van 'bare'-opdrachten.
• Als tags er filters zijn opgegeven:
  • De geretourneerde lijst is beperkt tot die gebieden waarvan de tagsverzameling voldoet aan alle opgegeven tagsfilters.
  • Deze methode is sneller dan het filteren (toevoegen | where Tags has '...' and Tags contains '...' aan) van de resultaten van 'bare' opdrachten.
  • has filters zijn gelijkheidsfilters. Gebieden die niet zijn getagd met een van de opgegeven tags, worden uitgefilterd.
  • !has filters zijn negatieve filters voor gelijkheid. Gebieden die zijn gelabeld met een van de opgegeven tags, worden uitgefilterd.
  • contains filters zijn niet-hoofdlettergevoelige subtekenreeksfilters. Gebieden die niet de opgegeven tekenreeksen als subtekenreeks van een van hun tags hebben, worden uitgefilterd.
  • !contains filters zijn niet-hoofdlettergevoelige negatieve filters voor subtekenreeksen. Gebieden met de opgegeven tekenreeksen als subtekenreeks van een van hun tags worden uitgefilterd.

Databasebereik

Geeft informatie weer over gebieden (gegevensshards) die aanwezig zijn in de opgegeven database. Als hot is opgegeven, worden alleen gebieden weergegeven die naar verwachting in de hot-cache zijn.

Syntax

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

Meer informatie over syntaxisconventies.

Parameters

Naam	Type	Vereist	Beschrijving
Databasenaam	string	✔️	De naam van de database.
ExtentId	string		De id van het gebied dat moet worden weergegeven.
Tag	string		De naam van een tag om op te filteren zoals opgegeven.

Clusterbereik

Syntax

.showclusterextents [hot]

Meer informatie over syntaxisconventies.

Geeft informatie weer over gebieden (gegevensshards) die aanwezig zijn in het cluster. Als hot is opgegeven: geeft alleen gebieden weer die naar verwachting in de hot-cache staan.

Retouren

Uitvoerparameter	Type	Description
ExtentId	guid	Id van het gebied
DatabaseName	string	Database waartoe de omvang behoort
TableName	string	Tabel waartoe de gebieden behoren
MaxCreatedOn	datetime	De datum en tijd waarop de omvang is gemaakt. Voor een samengevoegde omvang, het maximum aantal aanmaaktijden tussen bronregio's
OriginalSize	Dubbel	Oorspronkelijke grootte in bytes van de omvang van gegevens
Omvang	Dubbel	Grootte van het gebied in het geheugen (gecomprimeerd + index)
Gecomprimeerde grootte	Dubbel	Gecomprimeerde grootte van de hoeveelheid gegevens in het geheugen
IndexGrootte	Dubbel	Indexgrootte van de mategegevens
Blokken	long	Aantal gegevensblokken in het gebied
Segmenten	long	Aantal gegevenssegmenten in het bereik
ExtentContainerId	string	Id van de mate van container waarin het gebied zich bevindt
RowCount	long	Aantal rijen in het gebied
MinCreatedOn	datetime	Datum/tijd waarop de omvang is gemaakt. Voor een samengevoegde omvang geldt de minimale aanmaaktijd tussen de bronregio's
Tags	string	Tags, indien van toepassing, gedefinieerd voor het bereik
Soort	string	Het type opslagengine dat de omvang heeft gemaakt
DeletedRowCount	long	Aantal verwijderde rijen in het gebied

Voorbeelden

Gelabelde omvang

Het bereik E in de tabel T is gelabeld met tags aaa, BBBen ccc.

• Deze query retourneert E:

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

• Deze query retourneert E niet omdat deze niet is gelabeld met aa:

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

• Deze query retourneert E:

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

Volume van gemaakte gebieden weergeven

Het volume weergeven van gebieden dat per uur wordt gemaakt in een specifieke database

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

De hoeveelheid gegevens weergeven die per tabel per uur binnenkomt

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

Verdeling van gegevensgrootte per tabel weergeven

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

Alle gebieden in de database met de naam 'GamesDB' weergeven

.show database GamesDB extents

Alle gebieden weergeven in de tabel met de naam 'Games'

.show table Games extents

Alle gebieden in specifieke tabellen weergeven

Alle gebieden weergeven in de tabellen met de namen 'TaggingGames1' en 'TaggingGames2', gelabeld met zowel 'tag1' als 'tag2'

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