You are viewing documentation about an older version (1.12.1). View latest version

snowflake.snowpark.functions.array_prepend

snowflake.snowpark.functions.array_prepend(array: Union[Column, str], element: Union[Column, str]) Column[source]

Returns an ARRAY containing the new element as well as all elements from the source ARRAY. The new element is positioned at the beginning of the ARRAY.

Parameters:
  • ARRAY. (array Column containing the source) –

  • prepended. (element Column containing the element to be) –

Example::
>>> from snowflake.snowpark import Row
>>> df = session.create_dataframe([Row(a=[1, 2, 3])])
>>> df.select(array_prepend("a", lit(4)).alias("result")).show()
------------
|"RESULT"  |
------------
|[         |
|  4,      |
|  1,      |
|  2,      |
|  3       |
|]         |
------------
Copy