D toc |
---|
Excerpt |
---|
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
Info | ||||
---|---|---|---|---|
NOTE: In the platform, null values are a subset of the category identifying missing values.For technical reasons, however,
|
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
ISMISSING
function returnstrue
for null and missing values. - However, the
ISNULL
function returnstrue
for a null value andfalse
for a missing value. See below.
- For example, the
- 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.
D trans Type step p01Name Formula p01Value NULL() p02Name New column name p02Value nulls SearchTerm New formula
- Most functions applied to null and missing values return the same results.
- 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:
D trans | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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.
Info |
---|
NOTE: The |
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:
D trans | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
The above transform writes null values, but these values are converted to missing values on export.
D s also | ||||
---|---|---|---|---|
|