replace_strings()
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 12345
ersetzt, 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() |
Zugehöriger Inhalt
- 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().