ARRAY_PREPEND

ARRAY_PREPEND

새 요소와 소스 배열의 모든 요소를 포함하는 배열을 반환해요. 새 요소는 배열의 시작 부분에 배치돼요.

출처: Snowflake ARRAY_PREPEND 함수 문서

본문

참고 항목: ARRAY_APPEND, ARRAY_INSERT

구문 (Syntax)

ARRAY_PREPEND(  ,  )

인자 (Arguments)

  • array — 소스 배열이에요.
  • new_element — 앞에 추가할(prepend) 요소예요.

반환 값 (Returns)

업데이트된 배열을 반환해요.

사용 노트 (Usage Notes)

  • 함수에 구조적 배열(structured array)을 전달하면, 함수는 같은 타입의 구조적 배열을 반환해요.
  • array가 구조적 ARRAY이면, 새 요소의 타입은 ARRAY의 타입으로 강제 변환(coercible)될 수 있어야 해요.

예제 (Examples)

아래 예제는 앞에 추가된 요소가 배열의 시작 부분에 배치되는 것을 보여줘요:

SELECT ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'hello');
+-------------------------------------------------+
| ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'HELLO') |
|-------------------------------------------------|
| [                                               |
|   "hello",                                      |
|   0,                                            |
|   1,                                            |
|   2,                                            |
|   3                                             |
| ]                                               |
+-------------------------------------------------+

더 알아보기