다음을 통해 공유


SUBSTRING(SSIS 식)

적용 대상: Azure Data Factory의 SQL Server SSIS Integration Runtime

지정된 위치에서 시작하여 지정된 길이를 갖는 문자 식의 부분을 반환합니다. position 매개 변수와 길이 매개 변수는 정수로 평가되어야 합니다.

구문

  
SUBSTRING(character_expression, position, length)  

인수

character_expression
문자를 추출할 문자 식입니다.

위치
하위 문자열이 시작되는 지점을 지정하는 정수입니다.

length
문자 수로 문자열의 길이를 지정하는 정수입니다.

결과 형식

DT_WSTR

설명

SUBSTRING은 1부터 시작하는 인덱스를 사용합니다. position 이 1이면 부분 문자열은 character_expression의 첫 번째 문자로 시작합니다.

SUBSTRING은 DT_WSTR 데이터 형식에서만 실행됩니다. 문자열 리터럴이나 DT_STR 데이터 형식의 데이터 열인 character_expression 인수는 SUBSTRING이 연산을 수행하기 전에 DT_WSTR 데이터 형식으로 암시적으로 캐스팅됩니다. 다른 데이터 형식은 DT_WSTR 데이터 형식으로 명시적으로 캐스팅되어야 합니다. 자세한 내용은 Integration Services 데이터 형식캐스트(SSIS 식)를 참조하세요.

인수가 null이면SUBSTRING 결과도 null입니다.

이 식의 모든 인수는 변수 및 열을 사용할 수 있습니다.

길이 인수는 문자열의 길이를 초과할 수 있습니다. 이 경우 함수는 문자열의 나머지를 반환합니다.

식 예제

이 예제에서는 문자열 리터럴에서 문자 4부터 시작하는 두 문자를 반환합니다. 반환 결과는 "ph"입니다.

SUBSTRING("elephant",4,2)  

이 예에서는 4번째 문자부터 시작하여 문자열 리터럴의 나머지가 반환됩니다. 반환 결과는 "phant"입니다. 길이 인수가 문자열의 길이 를 초과하는 것은 오류가 아닙니다.

SUBSTRING ("elephant",4,50)  

다음은 MiddleName 열의 첫 번째 문자를 반환하는 예제입니다.

SUBSTRING(MiddleName,1,1)  

이 예제에서는 위치길이 인수에 변수를 사용합니다. 시작이 1이고 길이가 5이면 함수는 이름 열의 처음 5자를 반환합니다.

SUBSTRING(Name,@Start,@Length)  

다음은 여섯 번째 문자부터 PostalCode 변수의 마지막 4자를 반환하는 예제입니다.

SUBSTRING (@PostalCode,6,4)  

이 예에서는 문자열 리터럴의 길이가 0인 문자열이 반환됩니다.

SUBSTRING ("Redmond",4,0)  

참고 항목

함수(SSIS 식)