IS DISTINCT FROM for NULL-safe comparison in PostgreSQL

Introduction

Sometimes you want to compare two values and treat NULLs as real values, not unknowns. IS DISTINCT FROM helps you do that safely.

You want to check if two columns have different values, including when one or both are NULL.

You need to filter rows where a value changed, even if the old or new value is NULL.

You want to avoid confusing results when comparing NULLs with = or <> operators.

You are writing queries that must treat NULL as a real value for comparison.

You want to find rows where two fields are not the same, counting NULLs as different.

Syntax

PostgreSQL

expression1 IS DISTINCT FROM expression2

This operator returns true if the two expressions are different or if one is NULL and the other is not.

It returns false if both expressions are equal or both are NULL.

Examples

Returns false because both values are equal.

PostgreSQL

SELECT 5 IS DISTINCT FROM 5;

Returns true because the values are different.

PostgreSQL

SELECT 5 IS DISTINCT FROM 10;

Returns true because one value is NULL and the other is not.

PostgreSQL

SELECT NULL IS DISTINCT FROM 5;

Returns false because both values are NULL (treated as equal).

PostgreSQL

SELECT NULL IS DISTINCT FROM NULL;

Sample Program

This creates a temporary table with pairs of values including NULLs. Then it checks if each pair is distinct using IS DISTINCT FROM.

PostgreSQL

CREATE TEMP TABLE test_values (a INT, b INT);
INSERT INTO test_values VALUES (1, 1), (2, NULL), (NULL, 3), (NULL, NULL);

SELECT a, b, a IS DISTINCT FROM b AS is_diff FROM test_values ORDER BY a NULLS LAST;

Important Notes

Unlike = or <>, IS DISTINCT FROM never returns NULL.

This operator is very useful in data comparison and change detection tasks.

Summary

IS DISTINCT FROM compares two values treating NULLs as real values.

It returns true if values differ or one is NULL and the other is not.

It returns false if values are equal or both NULL.

Practice

1. What does the IS DISTINCT FROM operator do in PostgreSQL when comparing two values?

easy

A. It returns true if the values are different or one is NULL and the other is not.

B. It returns true only if both values are NULL.

C. It returns false if the values are different.

D. It treats NULL as equal to any value.

Solution

1. Step 1: Understand the behavior of IS DISTINCT FROM

   This operator treats NULL as a real value and compares two values safely even if one or both are NULL.

2. Step 2: Analyze the comparison results

   It returns true if the values differ or if one is NULL and the other is not, otherwise false.

3. Final Answer:

   It returns true if the values are different or one is NULL and the other is not. -> Option A

4. Quick Check:

   IS DISTINCT FROM returns true for different or NULL vs non-NULL [OK]

Hint: Think: NULL counts as a real value in IS DISTINCT FROM [OK]

Common Mistakes:

• Assuming NULL equals NULL
• Confusing IS DISTINCT FROM with = operator
• Thinking it returns true only when both are NULL

2. Which of the following is the correct syntax to check if column a is distinct from column b in PostgreSQL?

easy

A. a <> b OR a IS NULL OR b IS NULL

B. a != b

C. a IS DISTINCT FROM b

D. a IS NOT DISTINCT FROM b

Solution

1. Step 1: Recall the correct syntax for NULL-safe comparison

   The operator IS DISTINCT FROM is used as a IS DISTINCT FROM b to compare two values safely including NULLs.

2. Step 2: Evaluate other options

   a != b uses standard inequality which fails with NULLs. a <> b OR a IS NULL OR b IS NULL is a complex expression but not the standard syntax. a IS NOT DISTINCT FROM b checks for NOT DISTINCT, which is the opposite.

3. Final Answer:

   a IS DISTINCT FROM b -> Option C

4. Quick Check:

   Use IS DISTINCT FROM for NULL-safe inequality [OK]

Hint: Use IS DISTINCT FROM for NULL-safe comparisons [OK]

Common Mistakes:

• Using != which fails with NULLs
• Writing complex OR conditions instead of operator
• Confusing IS DISTINCT FROM with IS NOT DISTINCT FROM

3. Given the table items with columns id and value, what will this query return?

SELECT id FROM items WHERE value IS DISTINCT FROM NULL;

Assuming items has rows:
(1, NULL), (2, 10), (3, NULL), (4, 20)

medium

A. [1, 2, 3, 4]

B. [2, 4]

C. [1, 3]

D. [] (empty list)

Solution

1. Step 1: Understand the condition value IS DISTINCT FROM NULL

   This condition returns true if value is not NULL, because NULL is treated as a real value.

2. Step 2: Apply condition to each row

   Rows with value 10 and 20 are distinct from NULL, so ids 2 and 4 match.

3. Final Answer:

   [2, 4] -> Option B

4. Quick Check:

   IS DISTINCT FROM NULL filters non-NULL values [OK]

Hint: IS DISTINCT FROM NULL means NOT NULL [OK]

Common Mistakes:

• Thinking it returns rows with NULL values
• Confusing IS DISTINCT FROM with IS NULL
• Assuming it returns all rows

4. You wrote this query but it returns no rows:

SELECT * FROM users WHERE email IS DISTINCT FROM NULL;

What is the likely mistake?

medium

A. The email column has only NULL values

B. Using IS DISTINCT FROM NULL instead of IS NOT NULL

C. IS DISTINCT FROM cannot be used with NULL

D. The table users is empty

Solution

1. Step 1: Understand what email IS DISTINCT FROM NULL means

   This condition returns true for all rows where email is NOT NULL.

2. Step 2: Analyze why no rows are returned

   If no rows are returned, it means no rows satisfy the condition, so all email values are NULL or the table is empty.

3. Step 3: Eliminate other options

   Using IS DISTINCT FROM NULL instead of IS NOT NULL is incorrect because IS DISTINCT FROM NULL is valid. The table users is empty is possible but less likely. IS DISTINCT FROM cannot be used with NULL is false because the operator supports NULL.

4. Final Answer:

   The email column has only NULL values -> Option A

5. Quick Check:

   No rows means no non-NULL emails [OK]

Hint: No rows means condition never true; check NULL presence [OK]

Common Mistakes:

• Thinking IS DISTINCT FROM NULL is invalid syntax
• Assuming table is empty without checking
• Confusing IS DISTINCT FROM NULL with IS NULL

5. You want to find all pairs of rows in table records where col1 and col2 differ, treating NULLs as real values. Which query correctly finds these pairs?

hard

A. SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 IS NOT DISTINCT FROM r2.col1 AND r1.col2 IS NOT DISTINCT FROM r2.col2;

B. SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 <> r2.col1 OR r1.col2 <> r2.col2;

C. SELECT * FROM records r1 JOIN records r2 ON r1.id = r2.id WHERE r1.col1 IS DISTINCT FROM r2.col1 AND r1.col2 IS DISTINCT FROM r2.col2;

D. SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 IS DISTINCT FROM r2.col1 OR r1.col2 IS DISTINCT FROM r2.col2;

Solution

1. Step 1: Understand the goal

   We want pairs where col1 or col2 differ, treating NULLs as real values.

2. Step 2: Analyze each option

   SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 IS DISTINCT FROM r2.col1 OR r1.col2 IS DISTINCT FROM r2.col2; uses IS DISTINCT FROM with OR, correctly finding pairs differing in either column. SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 <> r2.col1 OR r1.col2 <> r2.col2; uses <> which fails with NULLs. SELECT * FROM records r1 JOIN records r2 ON r1.id = r2.id WHERE r1.col1 IS DISTINCT FROM r2.col1 AND r1.col2 IS DISTINCT FROM r2.col2; joins on equal ids, so no pairs. SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 IS NOT DISTINCT FROM r2.col1 AND r1.col2 IS NOT DISTINCT FROM r2.col2; finds pairs where columns are NOT distinct, opposite of goal.

3. Final Answer:

   SELECT * FROM records r1 JOIN records r2 ON r1.id <> r2.id WHERE r1.col1 IS DISTINCT FROM r2.col1 OR r1.col2 IS DISTINCT FROM r2.col2 -> Option D

4. Quick Check:

   Use IS DISTINCT FROM with OR for NULL-safe difference [OK]

Hint: Use IS DISTINCT FROM with OR to find any column differences [OK]

Common Mistakes:

• Using <> which fails with NULLs
• Joining on equal ids instead of different ids
• Using IS NOT DISTINCT FROM which finds equal rows