Teradata Package for Python Function Reference on VantageCloud Lake - array_except - Teradata Package for Python - Look here for syntax, methods and examples for the functions included in the Teradata Package for Python.
Teradata® Package for Python Function Reference on VantageCloud Lake
- Deployment
- VantageCloud
- Edition
- Lake
- Product
- Teradata Package for Python
- Release Number
- 20.00.00.11
- Published
- August 2026
- ft:locale
- en-US
- ft:lastEdition
- 2026-08-13
- dita:id
- TeradataPython_FxRef_Lake_2000
- Product Category
- Teradata Vantage
- teradataml.dataframe.sql.DataFrameColumn.array_except = array_except(self, other)
- DESCRIPTION:
Return elements from this array that are not in the other array.
PARAMETERS:
other:
Required Argument.
Specifies the other array to subtract from this array.
Types: ColumnExpression OR str
RETURNS:
ColumnExpression
EXAMPLES:
>>> from teradataml import *
>>> load_example_data("array", "array_table")
# Create a DataFrame on 'array_table'.
>>> df = DataFrame("array_table")
>>> df
arr1 arr2 arr3
id
1 (10,20,30,40,50) (23,200,215,40,21) ('ab','bc','cd','ab','ef')
4 (180,28,38,48,58) (30,NULL,NULL,250,27) ('mn','no',NULL,'op','pq')
2 (150,25,35,45,55) (28,50,95,90,26) ('xy','yz','za','ab','xy')
6 (16,261,36,46,56) (29,170,160,46,25) ('uv','xy','ab','xy','yz')
3 (12,22,320,42,52) (25,22,140,200,23) ('pq','ab','ab','st','tu')
5 (14,24,34,44,54) (26,NULL,NULL,180,24) ('ij','jk',NULL,'kl','lm')
# Example 1: Get elements from arr1 that are not in arr2.
>>> res = df.assign(except_arr = df.arr1.array_except(df.arr2))
>>> res
arr1 arr2 arr3 except_arr
id
1 (10,20,30,40,50) (23,200,215,40,21) ('ab','bc','cd','ab','ef') (10,20,30,50)
4 (180,28,38,48,58) (30,NULL,NULL,250,27) ('mn','no',NULL,'op','pq') (180,28,38,48,58)
6 (16,261,36,46,56) (29,170,160,46,25) ('uv','xy','ab','xy','yz') (16,261,36,56)
2 (150,25,35,45,55) (28,50,95,90,26) ('xy','yz','za','ab','xy') (150,25,35,45,55)
5 (14,24,34,44,54) (26,NULL,NULL,180,24) ('ij','jk',NULL,'kl','lm') (14,34,44,54)
3 (12,22,320,42,52) (25,22,140,200,23) ('pq','ab','ab','st','tu') (12,320,42,52)