SUBSTRING(SSIS 식)SUBSTRING (SSIS Expression)

문자 식에서 지정된 위치부터 시작하여 지정된 길이만큼 반환합니다.Returns the part of a character expression that starts at the specified position and has the specified length. position 매개 변수와 length 매개 변수는 정수여야 합니다.The position parameter and the length parameter must evaluate to integers.

구문Syntax


SUBSTRING(character_expression, position, length)  

인수Arguments

character_expressioncharacter_expression
문자를 추출할 문자 식입니다.Is a character expression from which to extract characters.

positionposition
하위 문자열이 시작되는 지점을 지정하는 정수입니다.Is an integer that specifies where the substring begins.

lengthlength
부분 문자열의 길이를 문자 수로 지정하는 정수입니다.Is an integer that specifies the length of the substring as number of characters.

결과 형식Result Types

DT_WSTRDT_WSTR

주의Remarks

SUBSTRING은 1부터 시작하는 인덱스를 사용합니다.SUBSTRING uses a one-based index. position 이 1이면 부분 문자열은 character_expression의 첫 번째 문자로 시작합니다.If position is 1, the substring begins with the first character in character_expression.

SUBSTRING은 DT_WSTR 데이터 형식에서만 실행됩니다.SUBSTRING works only with the DT_WSTR data type. 문자열 리터럴이나 DT_STR 데이터 형식의 데이터 열인 character_expression 인수는 SUBSTRING이 연산을 수행하기 전에 DT_WSTR 데이터 형식으로 암시적으로 캐스팅됩니다.A character_expression argument that is a string literal or a data column with the DT_STR data type is implicitly cast to the DT_WSTR data type before SUBSTRING performs its operation. 다른 데이터 형식은 DT_WSTR 데이터 형식으로 명시적으로 캐스팅되어야 합니다.Other data types must be explicitly cast to the DT_WSTR data type. 자세한 내용은 Integration Services 데이터 형식캐스트(SSIS 식)를 참조하세요.For more information, see Integration Services Data Types and Cast (SSIS Expression).

인수가 Null이면 SUBSTRING 결과도 Null입니다.SUBSTRING returns a null result if the argument is null.

식의 모든 인수가 변수와 열을 사용할 수 있습니다.All arguments in the expression can use variables and columns.

length 인수는 문자열 길이를 초과할 수 있습니다.The length argument can exceed the length of the string. 이 경우 문자열의 나머지가 반환됩니다.In that case, the function returns the remainder of the string.

식 예Expression Examples

이 예에서는 문자 4부터 시작하여 문자열 리터럴의 두 문자가 반환됩니다.This example returns two characters, beginning with character 4, from a string literal. 반환 결과는 "ph"입니다.The return result is "ph".

SUBSTRING("elephant",4,2)  

이 예에서는 4번째 문자부터 시작하여 문자열 리터럴의 나머지가 반환됩니다.This example returns the remainder of a string literal, beginning at the fourth character. 반환 결과는 "phant"입니다.The return result is "phant". length 인수가 문자열 길이를 초과하는 것은 오류가 아닙니다.It is not an error for the length argument to exceed the length of the string.

SUBSTRING ("elephant",4,50)  

이 예에서는 MiddleName 열의 첫 문자가 반환됩니다.This example returns the first letter from the MiddleName column.

SUBSTRING(MiddleName,1,1)  

이 예에서는 positionlength 인수에 변수를 사용합니다.This example uses variables in the position and length arguments. Start 가 1이고 Length 가 5이면 Name 열의 처음 5문자가 반환됩니다.If Start is 1 and Length is 5, the function returns the first five characters in the Name column.

SUBSTRING(Name,@Start,@Length)  

이 예에서는 여섯 번째 문자부터 시작하여 PostalCode 변수의 마지막 네 문자가 반환됩니다.This example returns the last four characters from the PostalCode variable beginning at the sixth character.

SUBSTRING (@PostalCode,6,4)  

이 예에서는 문자열 리터럴의 길이가 0인 문자열이 반환됩니다.This example returns a zero-length string from a string literal.

SUBSTRING ("Redmond",4,0)  

관련 항목:See Also

함수(SSIS 식)Functions (SSIS Expression)