Manage Null Values
In general terms, a null value is a definition that points to nothing. A container for a value, such as a row-column combination or a variable, exists, but the container points to no actual value.
Important notes on null values
Nota
In the platform, null values are a subset of the category identifying missing values. For technical reasons, however, Designer Cloud displays null values as missing values and visually treats them as the same. Internally, they are understood to be different values.
Implications:
Null values are visually represented as missing values.
In the data quality bar, null and missing values are represented in the dark bar (missing values).
Computationally, they are different types of values.
Most functions applied to null and missing values return the same results.
For example, the
ISMISSINGfunction returnstruefor null and missing values.However, the
ISNULLfunction returnstruefor a null value andfalsefor a missing value. See below.
If you use a function to generate null values, they are displayed as missing values, although they are recorded as nulls.
For example, the following transform generates a column of null values, which are represented as missing values in the data quality bar.
Transformation Name
New formulaParameter: Formula
NULL()
Parameter: New column name
nulls
When a set of results is generated, both null and missing values are written as missing values, unless the output format has a specific schema associated with it.
Locate null values
Null values are displayed with missing values in the Missing values category of the data quality bar (in gray).
You can use the following transform to distinguish between null and missing values. This transform generates a new column of values, which are set to true if the value in isActive is a null value:
Transformation Name | |
|---|---|
Parameter: Formula | ISNULL(isActive) |
Parameter: New column name | nulls2 |
High percentage of nulls
On import, if a column has a high enough percentage of null values, the platform may retype the column as a String column, which may yield mismatched values in addition to the missing values that were imported from null values.
Null values in transformations
Functions:
Applying a null value as an input to a scalar function returns a null value, propagating the null value.
In aggregate or window functions, null values are ignored, as a single null value could corrupt an entire column of calculations.
Transforms:
In a join, a null value in one dataset never matches with a null value in another dataset. Rows with null values in join key columns are never included in the output. See Join Types.
Write null values
If needed, you can write a null value to a set of data. In the following example, all missing values in a column are replaced by nulls, using the NULL function.
Nota
The NULL function is typically used to pass null values into functions that have been designed to specifically address them.
The following example tests all columns in the range between column1 and column255 for whether a missing value is detected. If so, a null value is written. Otherwise, the column value is written back to the column:
Transformation Name | |
|---|---|
Parameter: Columns | column1~column255 |
Parameter: Formula | IF(ISMISSING([$col]), null(), $col) |
The above transform writes null values, but these values are converted to missing values on export.