적용 대상:
Databricks SQL Databricks Runtime 13.3 LTS 이상
확장된 array을 반환합니다. 여기서 elem은 index 위치에 삽입됩니다.
구문
array_insert(array, index, elem)
논쟁
-
array: ARRAY입니다. -
index: 삽입elem할 위치를 지정하는 0이 아닌 INTEGER 식입니다. 인덱스가 음수elem이면 배열의 끝을 기준으로 삽입됩니다. -
elem: 의 요소와 동일한 형식의 식입니다array.
반품
array와 동일한 유형의 ARRAY입니다.
참고
index로 시작하는 모든 요소는 elem에 index을 배치하기 위해 한 위치씩 이동됩니다.
index가 array의 카디널리티를 벗어날 경우, 배열은 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"]