/NULLIF - Connect_ETL - 9.13

Connect ETL Data Transformation Language (DTL) Guide

Product type
Software
Portfolio
Integrate
Product family
Connect
Product
Connect > Connect (ETL, Sort, AppMod, Big Data)
Version
9.13
Language
English
Product name
Connect ETL
Title
Connect ETL Data Transformation Language (DTL) Guide
Copyright
2023
First publish date
2003
Last updated
2023-09-11
Published on
2023-09-11T19:01:45.019000

To specify that empty fields are to be treated as NULL.

Format

/NULLIF null_specification [, null_specification . . .]

where

null_specification  = {CHARACTER} {NUMBER } {DATETIME } EMPTY

Location

The option may appear anywhere in the task definition.

Notes

This option sets the default nullability of displayable source fields in Connect ETL. Fields of each displayable data type can, by default, be treated as NULL when the fields are empty. Data types that are considered displayable include character, date/time, and displayable numeric types. The following is a list of the displayable numeric data types that can be considered empty and therefore are treated as NULL when this option is specified:
Edited numeric (EN)
Scientific notation (SN)
Decimal, embedded leading sign (LZ, LP)
Decimal, embedded trailing sign (ZD, TP)
Decimal, separate leading sign (LS)
Decimal, separate trailing sign (TS)
Decimal, unsigned (AN)

Delimited fields are considered empty when they have a length of 0 (two delimiters next to each other), or when they are filled with spaces and/or tabs. Positional fields are considered empty when they are filled with spaces and/or tabs.

If this option is not specified for a specific data type, all displayable source fields of that data type will default to being not nullable.

Nullability can also be set on a per-field basis, as described in /DELIMITEDRECORDLAYOUT and /RECORDLAYOUT.

Example

/nullif number empty
By default, all empty displayable numeric source fields are treated as if the value is NULL.
/nullif character empty, datetime empty

By default, all empty character and date/time source fields are treated as if the value is NULL.