extract_all() (모두 추출)

적용 대상: ✅Microsoft Fabric

원본 문자열에서 정규식 에 대한 모든 일치 항목을 가져옵니다. 필요에 따라 일치하는 그룹의 하위 집합을 검색합니다.

print extract_all(@"(\d+)", "a set of numbers: 123, 567 and 789") // results with the dynamic array ["123", "567", "789"]

사용되지 않는 별칭: extractall()

문법

extract_all( regex, [captureGroups,] 근원)

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

반품

• regex가 원본에서 일치 항목을 찾은 경우: 표시된 캡처 그룹 captureGroups 또는 regex의 모든 캡처 그룹에 대한 모든 일치 항목을 포함하여 동적 배열을 반환합니다.
• captureGroups 수가 1이면 반환된 배열에 일치하는 값의 단일 차원이 있습니다.
• captureGroups 수가 1을 초과하는 경우: 반환된 배열은 captureGroups 선택당 다중 값 일치 항목의 2차원 컬렉션이거나 captureGroups를 생략하면 regex에 있는 모든 캡처 그룹입니다.
• 일치하는 항목이 없는 경우: null.

예시

다음 예제에서는 GUID의 16진수 표현(16진수 2자리)을 반환하여 단일 그룹 캡처를 추출합니다.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"([\da-f]{2})", Id) 

출력

다음 예제에서는 세 개의 캡처링 그룹이 있는 정규식을 사용하여 각 GUID 부분을 첫 글자, 마지막 문자 및 중간에 있는 항목으로 분할합니다.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", Id)

출력

다음 예제에서는 캡처링 그룹의 하위 집합을 선택합니다.

정규식은 첫 글자, 마지막 문자 및 나머지 모든 문자와 일치합니다.

captureGroups 매개 변수는 첫 번째 부분과 마지막 부분만 선택하는 데 사용됩니다.

print Id="82b8be2d-dfa7-4bd1-8f63-24ad26d31449"
| extend guid_bytes = extract_all(@"(\w)(\w+)(\w)", dynamic([1,3]), Id) 

출력

다음 예제에서는 captureGroups가 캡처 그룹 인덱스와 명명된 캡처 그룹 참조를 모두 사용하여 일치하는 값을 가져오는 방법을 보여 줍니다.

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) 

출력

관련 콘텐츠

• extract 함수
• extract-json 함수
• 구문 분석 연산자