다음을 통해 공유

array_insert 기능

  • 아티클

적용 대상: 예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 13.3 LTS 이상

index 위치에 elem가 삽입된 확장된 array를 반환합니다.

구문

array_insert(array, index, elem)

인수

  • array: ARRAY입니다.
  • index: 삽입 elem할 위치를 지정하는 0이 아닌 INTEGER 식입니다. 인덱스가 음수 elem 이면 배열의 끝을 기준으로 삽입됩니다.
  • elem: 의 요소와 동일한 형식의 식입니다 array.

반품

array와 동일한 유형의 ARRAY입니다.

주의

로 시작하는 index 모든 요소는 한 위치로 이동하여 공백index을 elem 만듭니다. 이 경우 index 배열의 array 카디널리티가 s로 NULL채워집니다.

예제

> SELECT array_insert(array('a', 'b', 'c'), 1, 'z');
 ["z","a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 0, 'z');
 Error

> SELECT array_insert(array('a', 'b', 'c'), -1, 'z');
 ["a","b","c","z"]

> SELECT array_insert(array('a', 'b', 'c'), 5, 'z');
 ["a","b","c",NULL,"z"]

> SELECT array_insert(array('a', 'b', 'c'), -5, 'z');
 ["z",NULL,"a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 2, cast(NULL AS STRING));
 ["a",NULL,"b","c"]