[ ] (대괄호 기호) 연산자

  • 아티클

적용 대상:검사 표시됨 예 Databricks SQL 검사 예 Databricks Runtime으로 표시됨

인덱스 또는 키가 지정된 배열 요소 또는 맵 값을 반환합니다.

구문

expr [ keyExpr ]

여기서 대괄호를 사용하는 것은 리터럴 텍스트이며 선택적 구문을 나타내지 않습니다.

인수

  • expr: ARRAY 또는 MAP 식입니다.
  • keyExpr: 가 ARRAY이면 expr 정수 숫자입니다. 그렇지 않으면 MAP의 키 형식과 일치하는 식입니다.

반환

결과 형식은 ARRAY의 요소 형식 또는 MAP의 값 형식입니다.

ARRAY의 첫 번째 요소는 인덱스 0에 있습니다.

이 keyExpr MAP expr Azure Databricks에 유효한 키가 아니면 null을 반환합니다.

이 keyExpr ARRAY expr Azure Databricks에 바인딩되지 않으면 INVALID_ARRAY_INDEX오류가 발생합니다.

참고

Databricks Runtime에서 spark.sql.ansi.enabled 가 false이면 연산자는 범위를 벗어난 오류 대신 를 반환 NULL 합니다.

예

> SELECT a[2] FROM VALUES(array(10, 20, 30)) AS T(a);
  30

> SELECT m[1] FROM VALUES(map(1, 'Hello', 2, 'World')) AS T(m);
  Hello