NULL_IF

If there is a true Boolean value in the condition parameter, then return null; otherwise, return the second argument

Syntax

NULL_IF(condition, value)

Arguments

Name	Type	Description	Default Value
condition	Boolean	If this is true, return null. Otherwise, return the second argument
value	any	This will be returned as-is if the first argument does not contain true.

Examples

condition	value	Output
true	'foo'	null
false	'foo'	foo
null::Boolean	'foo'	foo

Transformation job example

SQL

CREATE JOB function_operator_example
    ADD_MISSING_COLUMNS = true
AS INSERT INTO default_glue_catalog.upsolver_samples.orders_transformed_data 
  MAP_COLUMNS_BY_NAME
    SELECT condition, value,
        NULL_IF(condition, value) AS Output
    FROM default_glue_catalog.upsolver_samples.orders_raw_data
    LET condition = true,
        value = 'foo'
    WHERE $commit_time BETWEEN run_start_time() AND run_end_time()
    LIMIT 1;

Query result

condition	value	Output
true	'foo'	null