Freigeben über


extract()

Gilt für: ✅Microsoft Fabric

Ruft eine Übereinstimmung für einen regulären Ausdruck aus einer Quellzeichenfolge ab.

Konvertiert optional die extrahierte Teilzeichenfolge in den angegebenen Typ.

Syntax

extract( regex,captureGroup,Quelle [,typeLiteral])

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Typ Erforderlich Beschreibung
regex string ✔️ Ein regulärer Ausdruck.
captureGroup int ✔️ Die zu extrahierende Erfassungsgruppe. 0 steht für die gesamte Übereinstimmung, 1 für den Wert, der mit der ersten "('Klammer')" im regulären Ausdruck übereinstimmt, und 2 oder mehr für nachfolgende Klammern.
Quelle string ✔️ Die zu durchsuchende Zeichenfolge.
typeLiteral string Die extrahierte Teilzeichenfolge wird, sofern angegeben, in diesen Typ konvertiert. Beispiel: typeof(long).

Gibt zurück

Wenn mit regex eine Übereinstimmung in source gefunden wird: die mit der angegebenen Erfassungsgruppe captureGroup abgeglichene Teilzeichenfolge, optional konvertiert in typeLiteral.

Wenn keine Übereinstimmung vorhanden ist oder bei der Typkonvertierung ein Fehler auftritt: null.

Beispiele

Das folgende Beispiel extrahiert den Benutzernamen, die E-Mail, das Alter aus der Zeichenfolge. Der reguläre Ausdruck wird verwendet, um die Informationen zu extrahieren.

let _data = datatable(Text: string)
[
"User: James, Email: James@example.com, Age: 29",
"User: David, Age: 35"
];
_data |
extend UserName = extract("User: ([^,]+)", 1, Text),
       EmailId = extract(@"Email: (\S+),", 1, Text),
       Age = extract(@"\d+", 0, Text)

Ausgabe-

Text UserName EmailId Age
Benutzer: James, E-Mail: James@example.com, Alter: 29 James James@example.com 29
Benutzer: David, Alter: 35 David 35

Im folgenden Beispiel wird der Monat aus der Zeichenfolge Dates extrahiert und eine Tabelle mit der Datumszeichenfolge und dem Monat als Int-Typ zurückgegeben.

let Dates = datatable(DateString: string)
[
    "15-12-2024",
    "21-07-2023",
    "10-03-2022"
];
Dates
| extend Month = extract(@"-(\d{2})-", 1, DateString, typeof(int))
| project DateString, Month

Ausgabe-

DateString Month
15-12-2024 12
21-07-2023 7
10-03-2022 3