Partilhar via

bag_pack()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Cria um objeto de recipiente de propriedades dinâmico a partir de uma lista de chaves e valores.

Apelidos obsoletos: pack(), pack_dictionary()

Sintaxe

bag_pack(chave1, valor1, chave2, valor2,... )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
chave string ✔️ O nome da chave.
value Qualquer tipo de dados escalares ✔️ O valor de chave.

Observação

As cadeias de caracteres de chave e valor são uma lista alternada, o comprimento total da lista deve ser par.

Devoluções

Retorna um dynamic objeto de recipiente de propriedades das entradas de chave e valor listadas.

Exemplos

Exemplo 1

O exemplo a seguir cria e retorna um recipiente de propriedades de uma lista alternada de chaves e valores.

print bag_pack("Level", "Information", "ProcessID", 1234, "Data", bag_pack("url", "www.bing.com"))

Resultados

print_0
{"Nível":"Informações","ProcessID":1234,"Dados":{"url":"www.bing.com"}}

Exemplo 2

O exemplo a seguir cria um recipiente de propriedades e extrai o valor do recipiente de propriedades usando o operador '.'.

datatable (
    Source: int,
    Destination: int,
    Message: string
) [
    1234, 100, "AA", 
    4567, 200, "BB",
    1212, 300, "CC" 
]
| extend MyBag=bag_pack("Dest", Destination, "Mesg", Message)
| project-away Source, Destination, Message
| extend MyBag_Dest=MyBag.Dest, MyBag_Mesg=MyBag.Mesg

Resultados

Minha bolsa MyBag_Dest MyBag_Mesg
{"Dest":100,"Mesg":"AA"} 100 AA
{"Dest":200,"Mesg":"BB"} 200 BB
{"Dest":300,"Mesg":"CC"} 300 CC

Exemplo 3

O exemplo a seguir usa duas tabelas, SmsMessages e MmsMessages, e retorna suas colunas comuns e um recipiente de propriedades das outras colunas. As tabelas são criadas ad-hoc como parte da consulta.

Mensagens SMS

Número de origem Número do alvo Contagem de caracteres
555-555-1234 555-555-1212 46
555-555-1234 555-555-1213 50
555-555-1212 555-555-1234 32

Mensagens Mms

Número de origem Número do alvo Tamanho do anexo Tipo de anexo Nome do anexo
555-555-1212 555-555-1213 200 jpeg Foto 1
555-555-1234 555-555-1212 250 jpeg Foto 2
555-555-1234 555-555-1213 300 png Foto 3 
let SmsMessages = datatable (
    SourceNumber: string,
    TargetNumber: string,
    CharsCount: string
) [
    "555-555-1234", "555-555-1212", "46", 
    "555-555-1234", "555-555-1213", "50",
    "555-555-1212", "555-555-1234", "32" 
];
let MmsMessages = datatable (
    SourceNumber: string,
    TargetNumber: string,
    AttachmentSize: string,
    AttachmentType: string,
    AttachmentName: string
) [
    "555-555-1212", "555-555-1213", "200", "jpeg", "Pic1",
    "555-555-1234", "555-555-1212", "250", "jpeg", "Pic2",
    "555-555-1234", "555-555-1213", "300", "png", "Pic3"
];
SmsMessages 
| join kind=inner MmsMessages on SourceNumber
| extend Packed=bag_pack("CharsCount", CharsCount, "AttachmentSize", AttachmentSize, "AttachmentType", AttachmentType, "AttachmentName", AttachmentName) 
| where SourceNumber == "555-555-1234"
| project SourceNumber, TargetNumber, Packed

Resultados

Número de origem Número do alvo Abarrotado
555-555-1234 555-555-1213 {"CharsCount":"50","AttachmentSize":"250","AttachmentType":"jpeg","AttachmentName":"Pic2"}
555-555-1234 555-555-1212 {"CharsCount":"46","AttachmentSize":"250","AttachmentType":"jpeg","AttachmentName":"Pic2"}
555-555-1234 555-555-1213 {"CharsCount":"50","AttachmentSize":"300","AttachmentType":"png","AttachmentName":"Pic3"}
555-555-1234 555-555-1212 {"CharsCount":"46","AttachmentSize":"300","AttachmentType":"png","AttachmentName":"Pic3"}