Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Przełącz usługi przy użyciu rozwijanej listy Wersja. Dowiedz się więcej o nawigacji.
Dotyczy: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel
Pobierz wszystkie dopasowania dla wyrażenia regularnego z ciągu źródłowego. Opcjonalnie pobierz podzbiór pasujących grup.
print extract_all(@"(\d+)", "a set of numbers: 123, 567 and 789") // results with the dynamic array ["123", "567", "789"]
Przestarzałe aliasy: extractall()
Składnia
extract_all(
źródło regex [captureGroups] ,,)
Dowiedz się więcej na temat konwencji składni.
Parametry
| Nazwisko | Typ | Wymagania | opis |
|---|---|---|---|
| regex | string |
✔️ | Wyrażenie regularne zawierające od jednego do 16 grup przechwytywania. |
| captureGroups | dynamic |
Tablica wskazująca grupy przechwytywania do wyodrębnienia. Prawidłowe wartości to od 1 do liczby przechwytywania grup w wyrażeniu regularnym. Nazwane grupy przechwytywania są również dozwolone. Zobacz przykłady. | |
| źródło | string |
✔️ | Ciąg do wyszukania. |
Zwraca
- Jeśli wyrażenie regularne znajdzie dopasowanie w źródle: Zwraca tablicę dynamiczną zawierającą wszystkie dopasowania względem wskazanych grup przechwytywania grup przechwytywania lub wszystkich grup przechwytywania w regex.
- Jeśli liczba grup przechwytywania wynosi 1: zwracana tablica ma jeden wymiar dopasowanych wartości.
- Jeśli liczba grup przechwytywania jest większa niż 1: Zwracana tablica jest dwuwymiarową kolekcją dopasowań wielowartościowych dla zaznaczenia grup przechwytywania lub wszystkich grup przechwytywania znajdujących się w regex, jeśli pominięto element captureGroups.
- Jeśli nie ma dopasowania:
null.
Przykłady
Poniższy przykład wyodrębnia przechwytywanie pojedynczej grupy, zwracając reprezentację szesnastkową (dwie cyfry szesnastkowej) identyfikatora GUID.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"([\da-f]{2})", Id)
Wyjście
| identyfikator | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | ["82","b8","be","2d","df","a7","4b","d1","8f","63","24","ad","26","d3","14","49"] |
W poniższym przykładzie użyto wyrażenia regularnego z trzema grupami przechwytywania, aby podzielić każdą część identyfikatora GUID na pierwszą literę, ostatnią literę i cokolwiek znajduje się w środku.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", Id)
Wyjście
| identyfikator | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | [["8","2b8be2","d"],["d","fa","7"],["4","bd","1"],["8","f6","3"],["2","4ad26d3144","9"]] |
Poniższy przykład wybiera podzbiór przechwytywania grup.
Wyrażenie regularne jest zgodne z pierwszą literą, ostatnią literą i resztą.
Parametr captureGroups służy do wybierania tylko pierwszych i ostatnich części.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", dynamic([1,3]), Id)
Wyjście
| identyfikator | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | [["8","d"],["d","7"],["4","1"],["8","3"],["2","9"]] |
W poniższym przykładzie pokazano, jak funkcja captureGroups używa zarówno indeksów grup przechwytywania, jak i nazwanych odwołań do grup przechwytywania w celu pobrania pasujących wartości.
print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(?P<first>\w)(?P<middle>\w+)(?P<last>\w)", dynamic(['first',2,'last']), Id)
Wyjście
| identyfikator | guid_bytes |
|---|---|
| 82b8be2d-dfa7-4bd1-8f63-24ad26d31449 | [["8","2b8be2","d"],["d","fa","7"],["4","bd","1"],["8","f6","3"],["2","4ad26d3144","9"]] |