Rozsahy .show

Přepněte služby pomocí rozevíracího seznamu Verze . Přečtěte si další informace o navigaci.
Platí pro: ✅ Microsoft Fabric ✅ Azure Data Explorer

Poznámka:

Horizontální oddíly dat se nazývají rozsahy a všechny příkazy používají jako synonymum "extent" nebo "extents". Další informace o rozsahech najdete v tématu Přehled rozsahů (horizontálních oddílů dat).

.show extents Typy příkazů jsou následující:

  • Zobrazení některých nebo všech rozsahů pro konkrétní obor tabulky
  • Zobrazení některých nebo všech rozsahů pro konkrétní obor databáze
  • Zobrazení některých nebo všech rozsahů pro celý cluster

Poznámka:

Příkaz .show extents může spotřebovávat velké množství prostředků a dokonce i překročit interní limity, pokud běží v oboru (například v databázi nebo clusteru), který má mnoho rozsahů (více než 5 milionů).)

Pro účely monitorování počtu rozsahů důrazně doporučujeme použít alternativní metody (například použití . show databasestats, .show datastats, .show datastats nebo .show tables details a .show table details). Dalším efektivním způsobem, jak načíst počet rozsahů, je použít metriku vystavenou prostřednictvím služby Azure Monitor (celkový počet rozsahů).

Pokud se vyžaduje podrobný výpis rozsahů, nezapomeňte použít nejmenší odpovídající obor příkazů (tabulku) nad "většími" rozsahy (databáze, cluster).

Také raději použijte variantu příkazu, která zahrnuje možnosti filtrování rozsahu v rámci syntaxe příkazu, aby příkaz používal a zpracoval výsledky tak, že je "piping" do dotazu.

Oprávnění

Pokud chcete zobrazit rozsahy v clusteru, musíte mít AllDatabasesMonitor oprávnění.

Chcete-li zobrazit rozsahy databáze, musíte mít Database UserDatabase Viewer, nebo Database Monitor oprávnění.

Další informace najdete v tématu řízení přístupu na základě role.

Obor tabulky

Syntaxe

Zobrazuje informace o rozsahech (horizontálních oddílech dat), které jsou přítomné v zadaných tabulkách. Databáze se přebírá z kontextu příkazu. Pokud hot je zadáno, zobrazí pouze rozsahy, u které se očekává, že budou v horké mezipaměti.

.show table TableNameextents [ ExtentId(...]] [,] [)hot (wheretagshas|contains|!has) | [!contains ...]]]

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

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Požadováno Popis
TableName string ✔️ Název tabulky.
ExtentId string ID rozsahu, který se má zobrazit.
Tag string Název značky, podle které chcete filtrovat podle zadaného nastavení.

Doporučení

  • Použití integrovaných možností filtrování v příkazu je upřednostňované před přidáním filtru založeného na dotazu (například přidávání | where DatabaseName == '...' a TableName == '...').
  • Pokud je k dispozici volitelný seznam ID rozsahu, je vrácená datová sada omezena pouze na tyto rozsahy.
    • Tato metoda je rychlejší než filtrování (přidávání | where ExtentId in(...)) k výsledkům "holých" příkazů.
  • Pokud tags jsou zadány filtry:
    • Vrácený seznam je omezen na rozsahy, jejichž kolekce značek dodržuje všechny poskytnuté filtry značek.
    • Tato metoda je rychlejší než filtrování (přidávání | where Tags has '...' and Tags contains '...' do) výsledků "holých" příkazů.
    • has filtry jsou filtry rovnosti. Rozsahy, které nejsou označené některou ze zadaných značek, se odfiltrují.
    • !has filtry jsou záporné filtry rovnosti. Rozsahy označené některou ze zadaných značek se odfiltrují.
    • contains filtry nerozlišují malá a velká písmena. Rozsahy, které nemají zadané řetězce jako podřetězce žádné z jejich značek, se odfiltrují.
    • !contains filtry nerozlišují negativní filtry s rozlišováním malých a velkých písmen. Rozsahy, které mají zadané řetězce jako podřetězce libovolné z jejich značek, se odfiltrují.

Obor databáze

Zobrazuje informace o rozsahech (horizontálních oddílech dat), které jsou přítomné v zadané databázi. Pokud hot je zadáno – zobrazuje pouze rozsahy, které se očekávaly v horké mezipaměti.

Syntaxe

.show database DatabaseNameextents [ ExtentId(...]] [,] [)hot (wheretagshas|contains|!has) | [!contains ...]]]

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název Typ Požadováno Popis
Název databáze string ✔️ Název databáze.
ExtentId string ID rozsahu, který se má zobrazit.
Tag string Název značky, podle které chcete filtrovat podle zadaného nastavení.

Obor clusteru

Syntaxe

.show cluster extents [hot]

Přečtěte si další informace o konvencích syntaxe.

Zobrazuje informace o rozsahech (horizontálních oddílech dat), které jsou přítomné v clusteru.

Pokud hot je zadáno – zobrazuje pouze rozsahy, u které se očekává, že budou v horké mezipaměti.

Návraty

Výstupní parametr Typ Popis
ExtentId guid ID rozsahu
DatabaseName string Databáze, do které rozsah patří.
TableName string Tabulka, do které rozsahy patří.
MaxCreatedOn datetime Datum a čas vytvoření rozsahu V případě sloučeného rozsahu je maximální doba vytváření mezi zdrojovými rozsahy.
OriginalSize Hodnota s dvojitou přesností Původní velikost vbajch
ExtentSize Hodnota s dvojitou přesností Velikost rozsahu v paměti (komprimované + index).
Komprimace Hodnota s dvojitou přesností Komprimovaná velikost dat rozsahu v paměti.
IndexSize Hodnota s dvojitou přesností Velikost indexu dat rozsahu
Bloky long Počet datových bloků v rozsahu
Segments long Počet datových segmentů v rozsahu
ExtentContainerId string ID kontejneru rozsahu, ve které je rozsah.
RowCount long Počet řádků v rozsahu
MinCreatedOn datetime Datum a čas vytvoření rozsahu V případě sloučeného rozsahu je minimální čas vytvoření mezi zdrojovými rozsahy.
Značky string Značky, pokud nějaké, definované pro rozsah.
Druh string Druh modulu úložiště, který rozsah vytvořil.
DeletedRowCount long Počet odstraněných řádků v rozsahu

Příklady

Označený rozsah

Rozsah E v tabulce T je označen značkami aaa, BBBa ccc.

  • Tento dotaz vrátí E:

      .show table T extents where tags has 'aaa' and tags contains 'bb'
    
  • Tento dotaz se nevrací E , protože není označený aa:

      .show table T extents where tags has 'aa' and tags contains 'bb'
    
  • Tento dotaz vrátí E:

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

Zobrazit objem vytvořených rozsahů

Zobrazení objemu vytvářených rozsahů za hodinu v konkrétní databázi

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

Zobrazení objemu dat přicházejících podle tabulky za hodinu

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

Zobrazení distribuce velikosti dat podle tabulky

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

Zobrazit všechny rozsahy v databázi s názvem GamesDB

.show database GamesDB extents

Zobrazit všechny rozsahy v tabulce s názvem Games

.show table Games extents

Zobrazit všechny rozsahy v konkrétních tabulkách

Zobrazit všechny rozsahy v tabulkách s názvem TaggingGames1 a TaggingGames2, označené značkami 1 i tag2

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