IS [NOT] DISTINCT FROM (Transact-SQL)

Область применения: SQL Server 2022 (16.x) База данных SQL Azure Управляемый экземпляр SQL Azure конечную точку аналитики SQL в хранилище Microsoft Fabric в Microsoft Fabric

Сравнивает равенство двух выражений и гарантирует истинный или ложный результат, даже если один или оба операнда имеют значение NULL.

IS [NOT] DISTINCT FROM — это предикат, который используется в условиях поиска предложений WHERE и HAVING, в условиях соединения предложений FROM и других конструкциях, где требуется логическое значение.

Соглашения о синтаксисе Transact-SQL

Синтаксис

expression IS [NOT] DISTINCT FROM expression

Аргументы

выражение

Любое допустимое выражение.

Выражение может являться столбцом, константой, функцией, переменной, скалярным вложенным запросом или любым сочетанием имен столбцов, констант и функций, связанных операторами или вложенным запросом.

Замечания

Сравнение значения NULL с любым другим значением, включая другое значение NULL, будет иметь неизвестный результат. IS [NOT] DISTINCT FROM всегда возвращает значение true или false, так как оно будет обрабатывать значения NULL как известные значения при использовании в качестве оператора сравнения.

В следующей таблице используются значения A и B, чтобы продемонстрировать поведение IS [NOT] DISTINCT FROM:

A B A = B A IS NOT DISTINCT FROM B
0 0 Истина Истина
0 1 False Ложь
0 NULL Неизвестно False
NULL NULL Неизвестно Истина

При выполнении запроса, содержащего IS [NOT] DISTINCT FROM для связанных серверов, текст запроса, отправляемый на связанный сервер, будет отличаться в зависимости от того, можем ли мы определить, что связанный сервер имеет возможность проанализировать синтаксис.

Если мы определим, что связанный сервер может анализировать IS [NOT] DISTINCT FROM, мы декодируем синтаксис как есть. Если мы определим, что связанный сервер может анализировать IS [NOT] DISTINCT FROM, мы декодируем синтаксис как есть:

A IS DISTINCT FROM B декодирует: ((A <> B OR A IS NULL OR B IS NULL) AND NOT (A IS NULL AND B IS NULL))

A IS NOT DISTINCT FROM B декодирует: (NOT (A <> B OR A IS NULL OR B IS NULL) OR (A IS NULL AND B IS NULL))

Примеры

А. Использование IS DISTINCT FROM

В следующем примере возвращаются строки, в которых поле id отличается от целочисленного значения 17.

DROP TABLE IF EXISTS #SampleTempTable;
GO
CREATE TABLE #SampleTempTable (id INT, message nvarchar(50));
INSERT INTO #SampleTempTable VALUES (null, 'hello') ;
INSERT INTO #SampleTempTable VALUES (10, null);
INSERT INTO #SampleTempTable VALUES (17, 'abc');
INSERT INTO #SampleTempTable VALUES (17, 'yes');
INSERT INTO #SampleTempTable VALUES (null, null);
GO

SELECT * FROM #SampleTempTable WHERE id IS DISTINCT FROM 17;
DROP TABLE IF EXISTS #SampleTempTable;
GO

Результаты исключают все строки, в которых id совпадает со значением 17.

id          message
----------- ---------
NULL        hello
10          NULL
NULL        NULL

B. Использование IS NOT DISTINCT FROM

В следующем примере возвращаются строки, в которых поле id не отличается от целочисленного значения 17.

DROP TABLE IF EXISTS #SampleTempTable;
GO
CREATE TABLE #SampleTempTable (id INT, message nvarchar(50));
INSERT INTO #SampleTempTable VALUES (null, 'hello') ;
INSERT INTO #SampleTempTable VALUES (10, null);
INSERT INTO #SampleTempTable VALUES (17, 'abc');
INSERT INTO #SampleTempTable VALUES (17, 'yes');
INSERT INTO #SampleTempTable VALUES (null, null);
GO

SELECT * FROM #SampleTempTable WHERE id IS NOT DISTINCT FROM 17;
DROP TABLE IF EXISTS #SampleTempTable;
GO

Результаты возвращают только строки, в которых id совпадает со значением 17.

id          message
----------- --------
17          abc
17          yes

C. Использование IS DISTINCT FROM для значения NULL

В следующем примере возвращаются строки, в которых поле id отличается от значения NULL.

DROP TABLE IF EXISTS #SampleTempTable;
GO
CREATE TABLE #SampleTempTable (id INT, message nvarchar(50));
INSERT INTO #SampleTempTable VALUES (null, 'hello') ;
INSERT INTO #SampleTempTable VALUES (10, null);
INSERT INTO #SampleTempTable VALUES (17, 'abc');
INSERT INTO #SampleTempTable VALUES (17, 'yes');
INSERT INTO #SampleTempTable VALUES (null, null);
GO

SELECT * FROM #SampleTempTable WHERE id IS DISTINCT FROM NULL;
DROP TABLE IF EXISTS #SampleTempTable;
GO

Результаты возвращают только строки, в которых id не равно значению NULL.

id          message
----------- --------
10          NULL
17          abc
17          yes

D. Использование IS NOT DISTINCT FROM для значения NULL

В указанном ниже примере возвращаются строки, в которых поле id не отличается от значения NULL.

DROP TABLE IF EXISTS #SampleTempTable;
GO
CREATE TABLE #SampleTempTable (id INT, message nvarchar(50));
INSERT INTO #SampleTempTable VALUES (null, 'hello') ;
INSERT INTO #SampleTempTable VALUES (10, null);
INSERT INTO #SampleTempTable VALUES (17, 'abc');
INSERT INTO #SampleTempTable VALUES (17, 'yes');
INSERT INTO #SampleTempTable VALUES (null, null);
GO

SELECT * FROM #SampleTempTable WHERE id IS NOT DISTINCT FROM NULL;
DROP TABLE IF EXISTS #SampleTempTable;
GO

Результаты возвращают только строки, в которых id равно значению NULL.

id          message
----------- --------
NULL        hello
NULL        NULL

См. также