Operatore partition

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

L'operatore partition partiziona i record della tabella di input in più tabelle secondarie in base ai valori di una colonna chiave. L'operatore esegue una sottoquery in ogni sottotabella e produce una singola tabella di output che rappresenta l'unione dei risultati di tutte le sottoquery.

Questo operatore è utile quando è necessario eseguire una sottoquery solo su un subset di righe appartenenti alla stessa chiave di partizione e non eseguire query sull'intero set di dati. Queste sottoquery possono includere funzioni di aggregazione, funzioni finestra, primi N e altri.

L'operatore partition supporta diverse strategie di operazione di sottoquery:

• Nativo : usare con un'origine dati implicita con migliaia di valori di partizione chiave.
• Shuffle : usare con un'origine implicita con milioni di valori di partizione chiave.
• Legacy: usare con un'origine implicita o esplicita per 64 o meno valori di partizione chiave.

Sintassi

T partition | [ hint.strategy=Strategia ] [ Hint ] by Trasformazione colonnaSubQuery ( )

T partition | [ ] [ hint.strategy=legacy Hints ] by Column { SubQueryWithSource }

Altre informazioni sulle convenzioni di sintassi.

Parametri

Hint supportati

Valori restituiti

L'operatore restituisce un'unione dei risultati delle singole sottoquery.

Strategie

L'operatore partition supporta diverse strategie di operazione di sottoquery: nativa, casuale e legacy.

Strategia nativa

Questa strategia deve essere applicata quando il numero di valori distinti della chiave di partizione non è grande, approssimativamente nelle migliaia.

La sottoquery deve essere una trasformazione tabulare che non specifica un'origine tabulare. L'origine è implicita e viene assegnata in base alle partizioni sottotable. Nella sottoquery è possibile usare solo determinati operatori supportati. Non esiste alcuna restrizione sul numero di partizioni.

Per usare questa strategia, specificare hint.strategy=native.

Strategia casuale

Questa strategia deve essere applicata quando il numero di valori distinti della chiave di partizione è elevato, in milioni.

La sottoquery deve essere una trasformazione tabulare che non specifica un'origine tabulare. L'origine è implicita e viene assegnata in base alle partizioni sottotable. Nella sottoquery è possibile usare solo determinati operatori supportati. Non esiste alcuna restrizione sul numero di partizioni.

Per usare questa strategia, specificare hint.strategy=shuffle. Per altre informazioni sulla strategia e sulle prestazioni casuali, vedere Query casuali.

Operatori supportati per le strategie native e shuffle

L'elenco di operatori seguente può essere usato nelle sottoquery con le strategie native o shuffle:

• count
• distinct
• extend
• serie make-series
• mv-apply
• mv-expand
• parse
• parse-where
• project
• project-away
• project-keep
• project-rename
• project-reorder
• ridurre
• sample
• sample-distinct
• scan
• search
• Serializzare
• ordinamento
• summarize
• take
• top
• top-hitters
• top-nested
• where

Strategia legacy

Per motivi cronologici, la legacy strategia è la strategia predefinita. È tuttavia consigliabile favorire le strategie native o casuali , poiché l'approccio legacy è limitato a 64 partizioni ed è meno efficiente.

In alcuni scenari, la legacy strategia potrebbe essere necessaria a causa del supporto per l'inclusione di un'origine tabulare nella sottoquery. In questi casi, la sottoquery può fare riferimento solo alla colonna chiave, Column, dall'origine tabulare di input T. Per fare riferimento alla colonna, utilizzare la sintassi toscalar(Column).

Se la sottoquery è una trasformazione tabulare senza un'origine tabulare, l'origine è implicita ed è basata sulle partizioni sottotable.

Per usare questa strategia, specificare o omettere hint.strategy=legacy qualsiasi altra indicazione di strategia.

Esempi

Trovare i valori principali

In alcuni casi, è più efficiente e più facile scrivere una query usando l'operatore rispetto all'operatore partition top-nested . La query seguente esegue una sottoquery calcolando summarize e top per ognuno State a partire da W: "WYOMING", "WASHINGTON", "WEST VIRGINIA" e "WISCONSIN".

StormEvents
| where State startswith 'W'
| partition hint.strategy=native by State 
    (
    summarize Events=count(), Injuries=sum(InjuriesDirect) by EventType, State
    | top 3 by Events 
    ) 

Output

Strategia nativa

La query seguente restituisce i primi 2 EventType valori per TotalInjuries ognuno State che inizia con 'W':

StormEvents
| where State startswith 'W'
| partition hint.strategy = native by State
    (
    summarize TotalInjueries = sum(InjuriesDirect) by EventType
    | top 2 by TotalInjueries
    )

Output

Strategia casuale

La query seguente restituisce i primi 3 DamagedProperty valori foreach EpisodeId e le colonne EpisodeId e State.

StormEvents
| partition hint.strategy=shuffle by EpisodeId
    (
    top 3 by DamageProperty
    | project EpisodeId, State, DamageProperty
    )
| count

Output

Strategia legacy con origine esplicita

La query seguente esegue due sottoquery:

• Quando x == 1, la query restituisce tutte le righe da StormEvents con InjuriesIndirect == 1.
• Quando x == 2, la query restituisce tutte le righe da StormEvents con InjuriesIndirect == 2.

Il risultato finale è l'unione di queste due sottoquery.

range x from 1 to 2 step 1
| partition hint.strategy=legacy by x {StormEvents | where x == InjuriesIndirect}
| count 

Output

Riferimento alla partizione

Nell'esempio seguente viene illustrato come usare l'operatore as per assegnare un "nome" a ogni partizione di dati e quindi riutilizzare tale nome all'interno della sottoquery. Questo approccio è rilevante solo per la legacy strategia.

T
| partition by Dim
(
    as Partition
    | extend MetricPct = Metric * 100.0 / toscalar(Partition | summarize sum(Metric))
)