이 함수는 SUBSTRING 지정된 위치와 지정된 길이 또는 문자열의 끝에서 시작하는 문자열 식의 일부를 반환합니다.
시작 위치 및 길이를 사용하여 문자열의 일부를 반환하는 NoSQL용 Azure Cosmos DB 시스템 함수입니다.
구문
SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)
Arguments
| Description | |
|---|---|
string_expr |
문자열 식입니다. |
numeric_expr_1 |
시작 문자를 나타내는 숫자 식입니다. |
numeric_expr_2 |
반환할 최대 문자 string_expr 수를 나타내는 숫자 식입니다. |
반환 형식
문자열 식을 반환합니다.
예시
이 섹션에는 이 쿼리 언어 구문을 사용하는 방법에 대한 예제가 포함되어 있습니다.
문자열에서 부분 문자열 추출
이 예제 SUBSTRING 에서 함수는 다양한 길이와 시작 위치의 부분 문자열을 반환하는 데 사용됩니다.
SELECT VALUE {
substringPrefix: SUBSTRING("AdventureWorks", 0, 9),
substringSuffix: SUBSTRING("AdventureWorks", 9, 5),
substringTotalLength: SUBSTRING("AdventureWorks", 0, LENGTH("AdventureWorks")),
substringEmptyString: SUBSTRING("AdventureWorks", 0, -1)
}
[
{
"substringPrefix": "Adventure",
"substringSuffix": "Works",
"substringTotalLength": "AdventureWorks",
"substringEmptyString": ""
}
]
비고
- 이 함수는 범위 인덱스 사용의 이점을 활용합니다. 자세한 내용은 범위 인덱스를 참조하세요.