Partilhar via

plug-in basket

  • Artigo

O basket plug-in encontra padrões frequentes de atributos nos dados e devolve os padrões que ultrapassam um limiar de frequência nesses dados. Um padrão representa um subconjunto das linhas que têm o mesmo valor numa ou mais colunas. O basket plug-in baseia-se no algoritmo Apriori originalmente desenvolvido para extração de dados de análise de cestos.

Syntax

T | evaluatebasket([ Limiar,Colunade, PesoMaxDimensions,CustomWildcard,CustomWildcard, ... ])

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Tipo Necessário Descrição
Limite long Um double no intervalo de 0,015 a 1 que define a proporção mínima das linhas a considerar frequente. Os padrões com uma proporção mais pequena não serão devolvidos. O valor predefinido é 0,05. Para utilizar o valor predefinido, introduza o til: ~.

Exemplo: T | evaluate basket(0.02)
Colunade Peso string O nome da coluna a utilizar para considerar cada linha na entrada de acordo com o peso especificado. Tem de ser um nome de uma coluna de tipo numérico, como int, long, real. Por predefinição, cada linha tem um peso de 1. Para utilizar o valor predefinido, introduza o til: ~. Uma utilização comum de uma coluna de peso é ter em conta a amostragem ou o registo/agregação dos dados que já estão incorporados em cada linha.

Exemplo: T | evaluate basket('~', sample_Count)
MaxDimensions int Define o número máximo de dimensões não correlacionadas por cesto, limitadas por predefinição, para minimizar o runtime da consulta. A predefinição é 5. Para utilizar o valor predefinido, introduza o til: ~.

Exemplo: T | evaluate basket('~', '~', 3)
CustomWildcard string Define o valor de caráter universal para um tipo específico na tabela de resultados que indicará que o padrão atual não tem uma restrição nesta coluna. A predefinição é null exceto para colunas de cadeia cujo valor predefinido é uma cadeia vazia. Se a predefinição for um bom valor nos dados, deve ser utilizado um valor universal diferente, como *. Para utilizar o valor predefinido, introduza o til: ~.

Exemplo: T | evaluate basket('~', '~', '~', '*', int(-1), double(-1), long(0), datetime(1900-1-1))

Nota

Para especificar um parâmetro opcional que siga um parâmetro opcional, confirme que fornece um valor para o parâmetro opcional anterior. Para obter mais informações, veja Trabalhar com parâmetros opcionais.

Devoluções

O basket plug-in devolve padrões frequentes que ultrapassam um limiar de proporção. O limiar predefinido é 0,05.

Cada padrão é representado por uma linha nos resultados. A primeira coluna é o ID do segmento. As duas colunas seguintes são a contagem e a percentagem de linhas, da consulta original que correspondem ao padrão. As colunas restantes estão relacionadas com a consulta original, com um valor específico da coluna ou um valor universal, que é por predefinição nulo, o que significa um valor variável.

Nota

O algoritmo utiliza a amostragem para determinar os valores frequentes iniciais. Por conseguinte, os resultados podem diferir ligeiramente entre múltiplas execuções para padrões cuja frequência esteja próxima do limiar.

Exemplo

Executar a consulta

StormEvents
| where monthofyear(StartTime) == 5
| extend Damage = iff(DamageCrops + DamageProperty > 0 , "YES" , "NO")
| project State, EventType, Damage, DamageCrops
| evaluate basket(0.2)

Saída

SegmentId de palavras Percentagem Estado EventType Danos DamageCrops
0 4574 77.7 NO 0
1 2278 38.7 Granizo NO 0
2 5675 96,4 0
3 2371 40.3 Granizo 0
4 1279 21.7 Vento trovoada 0
5 2468 41.9 Granizo
6 1310 22.3 SIM
7 1291 21.9 Vento trovoada

Exemplo com carateres universais personalizados

Executar a consulta

StormEvents
| where monthofyear(StartTime) == 5
| extend Damage = iff(DamageCrops + DamageProperty > 0 , "YES" , "NO")
| project State, EventType, Damage, DamageCrops
| evaluate basket(0.2, '~', '~', '*', int(-1))

Saída

SegmentId de palavras Percentagem Estado EventType Danos DamageCrops
0 4574 77.7 * * NO 0
1 2278 38.7 * Granizo NO 0
2 5675 96,4 * * * 0
3 2371 40.3 * Granizo * 0
4 1279 21.7 * Vento trovoada * 0
5 2468 41.9 * Granizo * -1
6 1310 22.3 * * SIM -1
7 1291 21.9 * Vento trovoada * -1