다음을 통해 공유

SUBSTRING - Cosmos DB의 쿼리 언어(Azure 및 패브릭)

  • 적용 대상: ✅ Azure Cosmos DB, ✅ Cosmos DB in Microsoft Fabric

이 함수는 SUBSTRING 지정된 위치와 지정된 길이에서 시작하는 문자열 식의 일부를 반환합니다.

시작 위치 및 길이를 사용하여 문자열의 일부를 반환하는 Azure Cosmos DB 시스템 함수입니다.

구문

SUBSTRING(<string_expr>, <numeric_expr_1>, <numeric_expr_2>)

Arguments

Description
string_expr 문자열 식입니다.
numeric_expr_1 시작 문자를 나타내는 0부터 시작하는 숫자 식입니다. 값은 0 첫 번째 문자를 참조합니다.
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": ""
  }
]

비고

  • 이 함수는 0부터 시작하는 인덱싱을 사용합니다. 즉 0 , 문자열의 첫 번째 문자를 참조합니다.
  • (length)가 음수이면 numeric_expr_2 함수는 빈 문자열을 반환합니다.
  • 문자열의 끝에 부분 문자열을 반환하려면 함수를 LENGTH 사용하여 나머지 문자(예: SUBSTRING(str, start, LENGTH(str) - start))를 계산합니다.
  • 이 함수는 범위 인덱스 사용의 이점을 활용합니다. 자세한 내용은 범위 인덱스를 참조하세요.
  • Last updated on