Freigeben über


replace_strings()

Gilt für: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Ersetzt alle Zeichenfolgen-Übereinstimmungen durch angegebene Zeichenfolgen.

Informationen zum Ersetzen einer einzelnen Zeichenfolge finden Sie unter replace_string().

Syntax

replace_strings(Text-Nachschlagevorgänge, , werden umgeschrieben)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich BESCHREIBUNG
text string ✔️ Die Quellzeichenfolge.
Lookups dynamic ✔️ Das Array, das Nachschlagezeichenfolgen enthält. Arrayelement, das keine Zeichenfolge ist, wird ignoriert.
Schreibt dynamic ✔️ Das Array, das Umschreibungen enthält. Arrayelement, das keine Zeichenfolge ist, wird ignoriert (keine Ersetzung vorgenommen).

Gibt zurück

Gibt Text zurück, nachdem alle Übereinstimmungen von Nachschlagevorgängen durch Auswertungen von Umschreibungen ersetzt wurden. Bei Übereinstimmungen kommt es nicht zu Überschneidungen.

Beispiele

Einfacher Ersatz

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
        )
`Message` Ergebnis
Ein Zaubertrick kann eine Katze in einen Hund verwandeln Ein Zaubertrick kann einen Hund in eine Taube verwandeln

Ersetzen durch eine leere Zeichenfolge

Der Ersatz durch eine leere Zeichenfolge entfernt die entsprechende Zeichenfolge.

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
        )
`Message` Ergebnis
Ein Zaubertrick kann eine Katze in einen Hund verwandeln Ein Zaubertrick kann eine Katze verschwinden

Ersatzauftrag

Die Reihenfolge der Übereinstimmungselemente ist wichtig: Die frühere Übereinstimmung hat vorrang. Beachten Sie den Unterschied zwischen Ergebnis1 und Ergebnis2: 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
        )
`Message` Ergebnis 1 Ergebnis 2
Dies ist ein Beispiel für die Verwendung von replace_strings() Dies war ein Beispiel für die Verwendung von replace_strings() Thwas war ein Beispiel für die Verwendung von replace_strings()

Nicht-Zeichenfolgenersetzung

Ersetzen Sie Elemente, die keine Zeichenfolgen sind, werden nicht ersetzt, und die ursprüngliche Zeichenfolge wird beibehalten. Die Übereinstimmung gilt weiterhin als gültig, und andere mögliche Ersetzungen werden für die übereinstimmende Zeichenfolge nicht ausgeführt. Im folgenden Beispiel wird "This" nicht durch die Numerische 12345ersetzt, und sie verbleibt in der Ausgabe, die von einer möglichen Übereinstimmung mit "is" nicht betroffen ist.

 print Message="This is an example of using replace_strings()"
| extend Outcome = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic([12345, 'was']) // Replacements
        )
`Message` Ergebnis
Dies ist ein Beispiel für die Verwendung von replace_strings() Dies war ein Beispiel für die Verwendung von replace_strings()
  • Informationen zum Ersetzen einer einzelnen Zeichenfolge finden Sie unter replace_string().
  • Eine Ersetzung basierend auf regulärem Ausdruck finden Sie unter replace_regex().
  • Informationen zum Ersetzen einer Reihe von Zeichen finden Sie unter translate().