다음을 통해 공유


REGEXP_SUBSTR(Transact-SQL) 미리 보기

적용 대상: SQL Server 2025(17.x)Microsoft Fabric에서Azure SQL DatabaseAzure SQL Managed Instance SQL 데이터베이스 미리 보기

비고

미리 보기 기능으로, 이 문서에 제시된 기술에는 Microsoft Azure 미리 보기에 대한 보충 사용 약관이 적용됩니다.

정규식 패턴과 일치하는 문자열의 부분 문자열을 한 번 반환합니다. 일치하는 항목이 없으면 반환됩니다 NULL.

REGEXP_SUBSTR
     (
      string_expression,
      pattern_expression [, start [, occurrence [, flags [, group ] ] ] ]
     )

주장들

string_expression

문자열의 식입니다.

문자열의 상수, 변수 또는 열일 수 있습니다.

데이터 형식: char, nchar, varchar 또는 nvarchar.

비고

, REGEXP_LIKEREGEXP_COUNT 함수는 REGEXP_INSTRstring_expression 매개 변수에 대해 LOB 형식(varchar(max)nvarchar(max))을 최대 2MB까지 지원합니다.

패턴_표현식

일치시킬 정규식 패턴입니다. 일반적으로 텍스트 리터럴입니다.

데이터 형식: char, nchar, varchar 또는 nvarchar. pattern_expression 최대 문자 길이는 8,000바이트입니다.

start

검색 문자열 내에서 검색의 시작 위치를 지정합니다. 선택 사항입니다. 유형이 int 또는 bigint입니다.

번호 매기기는 1부터 시작합니다. 즉, 식의 첫 번째 문자는 1 값이어야 합니다 >= 1. 시작 식이 보다 1작으면 오류를 반환합니다. 시작 식이 string_expression 길이보다 크면 함수가 반환됩니다 NULL. 기본값은 1입니다.

발생

검색하거나 바꿀 원본 문자열 내에서 패턴 식의 발생을 지정하는 식(양의 정수)입니다. 기본값은 1입니다. string_expression 첫 번째 문자를 검색합니다. 양의 정수 n의 경우 pattern_expression 첫 번째 발생 후 첫 번째 문자로 시작하는 n번째 항목을 검색합니다.

플래그

일치 항목을 검색하는 데 사용되는 한정자를 지정하는 하나 이상의 문자입니다. varchar 또는 char 형식이며 최대 30자입니다.

예: ims. 기본값은 c입니다. 빈 문자열 (' ') 이 제공되면 기본값 ('c')으로 처리됩니다. 또는 다른 문자 식을 제공합니다 c . 플래그에 모순된 문자가 여러 개 있는 경우 SQL Server는 마지막 문자를 사용합니다.

예를 들어 regex를 지정 ic 하면 대/소문자를 구분하는 일치 항목이 반환됩니다.

값에 지원되는 플래그 값에 나열된 문자가 아닌 문자가 포함된 경우 쿼리는 다음 예제와 같은 오류를 반환합니다.

Invalid flag provided. '<invalid character>' are not valid flags. Only {c,i,s,m} flags are valid.
지원되는 플래그 값
깃발 설명
i 대/소문자를 구분하지 않습니다(기본값 false)
m 여러 줄 모드: ^$ 시작/끝 텍스트 외에 시작/끝 선 일치(기본값 false)
s 일치 . 허용\n(기본값false)
c 대/소문자 구분(기본값 true)

그룹

반환할 string_expression 내의 위치를 결정하는 pattern_expression 캡처 그룹(하위 식)을 지정합니다. 캡처 그룹(하위 식)은 괄호로 묶인 패턴 조각이며 중첩될 수 있습니다. 캡처 그룹은 왼쪽 괄호가 나타나는 순서대로 번호가 매겨집니다. 그룹의 데이터 형식은 정수이고 값은 0보다 크거나 같아야 하며 pattern_expression 캡처 그룹(하위 식)의 수보다 크면 안 됩니다. 기본 그룹 값은 0으로, 위치가 전체 패턴과 일치하는 문자열을 기반으로 했음을 나타냅니다.

반환 값

문자열입니다.

예시

전자 메일 주소에서 도메인 이름을 추출합니다.

SELECT REGEXP_SUBSTR(EMAIL, '@(.+)$', 1, 1, 'i', 1) AS DOMAIN
FROM CUSTOMERS;

문장에서 모음으로 시작하는 첫 번째 단어를 찾습니다.

SELECT REGEXP_SUBSTR(COMMENT, '\b[aeiou]\w*', 1, 1, 'i') AS WORD
FROM FEEDBACK;

신용 카드 번호의 마지막 4자리 숫자를 가져옵니다.

SELECT REGEXP_SUBSTR(CARD_NUMBER, '\d{4}$') AS LAST_FOUR
FROM PAYMENTS;