Partilhar via

replace_strings()

  • Artigo

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

Substitui todas as correspondências de strings por strings especificadas.

Para substituir uma string individual, consulte replace_string().

Sintaxe

replace_strings(reescritas de pesquisas de texto ,, )

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
text string ✔️ A cadeia de caracteres de origem.
Pesquisas dynamic ✔️ A matriz que inclui cadeias de caracteres de pesquisa. O elemento de matriz que não é uma cadeia de caracteres é ignorado.
Regrava dynamic ✔️ A matriz que inclui regravações. O elemento de matriz que não é uma cadeia de caracteres é ignorado (nenhuma substituição é feita).

Devoluções

Retorna texto após substituir todas as correspondências de pesquisas por avaliações de reescritas. Correspondências não se sobrepõem.

Exemplos

Substituição simples

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['cat', 'dog']), // Lookup strings
        dynamic(['dog', 'pigeon']) // Replacements
        )
Mensagem Resultado
Um truque de mágica pode transformar um gato em um cachorro Um truque de mágica pode transformar um cachorro em um pombo

Substituição por uma string vazia

A substituição por uma string vazia remove a string correspondente.

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['turn', ' into a dog']), // Lookup strings
        dynamic(['disappear', '']) // Replacements
        )
Mensagem Resultado
Um truque de mágica pode transformar um gato em um cachorro Um truque de mágica pode desaparecer um gato

Pedido de substituição

A ordem dos elementos de correspondência é importante: a correspondência anterior tem precedência. Observe a diferença entre Outcome1 e Outcome2: This vs Thwas.

 print Message="This is an example of using replace_strings()"
| extend Outcome1 = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic(['This', 'was']) // Replacements
        ),
        Outcome2 = replace_strings(
        Message,
        dynamic(['is', 'This']), // Lookup strings
        dynamic(['was', 'This']) // Replacements
        )
Mensagem Desfecho1 Desfecho2
Este é um exemplo de uso de replace_strings() Este foi um exemplo de uso de replace_strings() Este foi um exemplo de uso de replace_strings()

Substituição sem cadeia de caracteres

Os elementos de substituição que não são cadeias de caracteres não são substituídos e a cadeia de caracteres original é mantida. A correspondência ainda é considerada válida e outras substituições possíveis não são executadas na string correspondente. No exemplo a seguir, 'This' não é substituído pelo numérico 12345e permanece na saída sem ser afetado por uma possível correspondência com 'is'.

 print Message="This is an example of using replace_strings()"
| extend Outcome = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic([12345, 'was']) // Replacements
        )
Mensagem Resultado
Este é um exemplo de uso de replace_strings() Este foi um exemplo de uso de replace_strings()

Conteúdo relacionado