.show extents

Nota

Le partizioni di dati sono denominate extent e tutti i comandi usano "extent" o "extent" come sinonimo. Per altre informazioni sugli extent, vedere Panoramica degli extent (partizioni di dati).

I tipi di .show extents comandi sono i seguenti:

• Mostra alcuni o tutti gli extent per un ambito di tabella specifico
• Visualizzare alcuni o tutti gli extent per un ambito di database specifico
• Mostra alcuni o tutti gli extent per l'intero cluster

Nota

Il .show extents comando può usare molte risorse se viene eseguito in un ambito ,ad esempio un database o un cluster, con molti extent. È consigliabile usare la variante di comando nell'ambito più basso possibile. L'ambito di tabella è preferibile rispetto all'ambito del database e all'ambito del database nell'ambito del cluster. La variante del comando che include extent di filtro è preferibile filtrare i risultati del comando usando un'altra query.

Autorizzazioni

Per visualizzare gli extent nel cluster, è necessario disporre delle autorizzazioni AllDatabasesMonitor.

Per visualizzare gli extent in un database, è necessario disporre delle autorizzazioni Utente database, Visualizzatore database o Monitoraggio database.

Per altre informazioni, vedere Controllo degli accessi in base al ruolo.

Ambito tabella

Sintassi

Mostra informazioni sugli extent (partizioni di dati) presenti nelle tabelle specificate. Il database viene ricavato dal contesto del comando. Se hot viene specificato, mostra solo gli extent previsti nella cache ad accesso frequente.

.showtable TableName extents [ ExtentId [,( ...])] [hot] [where tags (has|contains|!has|!contains) TagName [ (has!contains|||contains!has) TagName [,and tags ...]]]

.showtables (TableName [, ...]) extents [( ExtentId [, ...])] [hot] [where tags (hascontains||!has|!contains) TagName [ (has!contains|||contains!has) TagName [,and tags ...]]]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
TableName	string	✔️	Nome della tabella.
ExtentId	string		ID dell'extent da visualizzare.
Tag	string		Nome di un tag da filtrare in base a quanto specificato.

Consigli

• L'uso delle funzionalità di filtro predefinite nel comando è preferibile rispetto all'aggiunta di un filtro basato su query, ad esempio l'aggiunta | where DatabaseName == '...' di e TableName == '...'.
• Se viene specificato l'elenco facoltativo di ID extent, il set di dati restituito è limitato solo a tali extent.
  • Questo metodo è più veloce rispetto al filtro (aggiungendo | where ExtentId in(...)) ai risultati dei comandi "bare".
• Se tags vengono specificati filtri:
  • L'elenco restituito è limitato a tali extent la cui raccolta di tag rispetta tutti i filtri di tag forniti.
  • Questo metodo è più veloce rispetto al filtro (aggiunta | where Tags has '...' and Tags contains '...' a) dei risultati dei comandi "bare".
  • has i filtri sono filtri di uguaglianza. Gli extent che non sono contrassegnati con uno dei tag specificati vengono filtrati.
  • !has i filtri sono filtri negativi di uguaglianza. Gli extent contrassegnati con uno dei tag specificati vengono filtrati.
  • contains i filtri sono filtri di sottostringa senza distinzione tra maiuscole e minuscole. Gli extent che non hanno le stringhe specificate come sottostringa dei tag vengono filtrati.
  • !contains i filtri sono filtri negativi senza distinzione tra maiuscole e minuscole. Gli extent con le stringhe specificate come sottostringa di uno dei relativi tag vengono filtrati.

Ambito del database

Mostra informazioni sugli extent (partizioni di dati) presenti nel database specificato. Se hot viene specificato , mostra solo gli extent previsti nella cache ad accesso frequente.

Sintassi

.showdatabase DatabaseName extents [ ExtentId [,( ...])] [hot] [where tags (has|contains|!has|!contains) TagName [ (has!contains|||contains!has) TagName [,and tags ...]]]

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
DatabaseName	string	✔️	Nome del database.
ExtentId	string		ID dell'extent da visualizzare.
Tag	string		Nome di un tag da filtrare in base a quanto specificato.

Ambito del cluster

Sintassi

.showcluster extents [hot]

Altre informazioni sulle convenzioni di sintassi.

Mostra informazioni sugli extent (partizioni di dati) presenti nel cluster. Se hot viene specificato , mostra solo gli extent previsti nella cache ad accesso frequente.

Valori restituiti

Parametro di output	Tipo	Descrizione
ExtentId	guid	ID dell'extent
DatabaseName	string	Database a cui appartiene l'extent
TableName	string	Tabella a cui appartengono gli extent
MaxCreatedOn	datetime	Data e ora di creazione dell'extent. Per un extent unito, il numero massimo di tempi di creazione tra gli extent di origine
OriginalSize	Double	Dimensioni originali in byte dei dati extent
ExtentSize	Double	Dimensioni dell'extent in memoria (compresso + indice)
CompressedSize	Double	Dimensioni compresse dei dati extent in memoria
IndexSize	Double	Dimensioni dell'indice dei dati extent
Blocchi	long	Numero di blocchi di dati nell'extent
Segments	long	Numero di segmenti di dati nell'extent
ExtentContainerId	string	ID del contenitore extent in cui si trova l'extent
RowCount	long	Numero di righe nell'extent
MinCreatedOn	datetime	Data e ora di creazione dell'extent. Per un extent unito, il tempo minimo di creazione tra gli extent di origine
Tag	string	Tag, se presenti, definiti per l'extent
Tipologia	string	Tipo di motore di archiviazione che ha creato l'extent
DeletedRowCount	long	Numero di righe eliminate nell'extent

Esempi

Extent con tag

L'extent E nella tabella T viene contrassegnato con tag aaa, BBBe ccc.

• Questa query restituisce E:

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

• Questa query non restituisce E perché non è contrassegnata con aa:

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

• Questa query restituisce E:

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

Mostra volume di extent creati

Visualizzare il volume di extent creati all'ora in un database specifico

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

Mostra volume di dati in arrivo per tabella all'ora

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

Visualizzare la distribuzione delle dimensioni dei dati in base alla tabella

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

Mostra tutti gli extent nel database denominato 'GamesDB'

.show database GamesDB extents

Mostra tutti gli extent nella tabella denominata 'Games'

.show table Games extents

Mostra tutti gli extent in tabelle specifiche

Mostra tutti gli extent nelle tabelle denominate 'TaggingGames1' e 'TaggingGames2', contrassegnati con 'tag1' e 'tag2'

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