Оператор BETWEEN (Transact-SQL)

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure конечной точке аналитики платформы Аналитики Azure Synapse Analytics (PDW) в Microsoft Fabric Хранилище в Microsoft Fabric

Определяет диапазон для проверки.

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

Синтаксис

test_expression [ NOT ] BETWEEN begin_expression AND end_expression  

Аргументы

test_expression
Выражение для проверки на принадлежность диапазону в пределах от begin_expression до end_expression. Выражение test_expression должно иметь тот же тип данных, что и begin_expression и end_expression.

Логическое НЕ
Указывает, что результат предиката должен быть инвертирован.

begin_expression
Любое допустимое выражение expression. Выражение begin_expression должно иметь тот же тип данных, что и test_expression и end_expression.

end_expression
Любое допустимое выражение expression. Выражение end_expression должно иметь тот же тип данных, что и test_expression и begin_expression.

И
Служит заполнителем, который указывает на то, что значение test_expression должно находиться в диапазоне от begin_expression до end_expression.

Типы результата

Boolean

Значение результата

Оператор BETWEEN возвращает значение TRUE, если значение аргумента test_expression больше значения аргумента begin_expression или равно ему и меньше значения аргумента end_expression или равно ему.

Оператор NOT BETWEEN возвращает значение TRUE, если значение аргумента test_expression меньше значения аргумента begin_expression или больше значения аргумента end_expression.

Замечания

Для задания исключающего диапазона используйте операторы "больше" (>) и "меньше" (<). Если любой параметр предиката BETWEEN или NOT BETWEEN имеет значение NULL, результат не определен (UNKNOWN).

Примеры

А. Использование оператора BETWEEN

В приведенном ниже примере возвращаются сведения о ролях базы данных. Первый запрос возвращает все роли. Во втором примере с помощью предложения BETWEEN роли ограничиваются указанными значениями database_id.

SELECT principal_id, name 
FROM sys.database_principals
WHERE type = 'R';

SELECT principal_id, name 
FROM sys.database_principals
WHERE type = 'R'
AND principal_id BETWEEN 16385 AND 16390;
GO  

Вот результирующий набор.

principal_id	name
------------  ---- 
0	            public
16384	        db_owner
16385	        db_accessadmin
16386	        db_securityadmin
16387	        db_ddladmin
16389	        db_backupoperator
16390	        db_datareader
16391	        db_datawriter
16392	        db_denydatareader
16393	        db_denydatawriter

principal_id	name
------------  ---- 
16385	        db_accessadmin
16386	        db_securityadmin
16387	        db_ddladmin
16389	        db_backupoperator
16390	        db_datareader

B. Использование операторов > и < вместо BETWEEN

В следующем примере используются операторы «больше» (>) и «меньше» (<); так как они позволяют задавать исключающий диапазон, здесь выводятся только девять строк вместо десяти из предыдущего примера.

-- Uses AdventureWorks  
  
SELECT e.FirstName, e.LastName, ep.Rate  
FROM HumanResources.vEmployee e   
JOIN HumanResources.EmployeePayHistory ep   
    ON e.BusinessEntityID = ep.BusinessEntityID  
WHERE ep.Rate > 27 AND ep.Rate < 30  
ORDER BY ep.Rate;  
GO  

Вот результирующий набор.

FirstName   LastName             Rate  
---------   -------------------  ---------  
Paula       Barreto de Mattos    27.1394  
Janaina     Bueno                27.4038  
Dan         Bacon                27.4038  
Ramesh      Meyyappan            27.4038  
Karen       Berg                 27.4038  
David       Bradley              28.7500  
Hazem       Abolrous             28.8462  
Ovidiu      Cracium              28.8462  
Rob         Walters              29.8462  

C. Использование оператора NOT BETWEEN

В следующем примере выводятся все строки вне указанного диапазона от 27 до 30.

-- Uses AdventureWorks  
  
SELECT e.FirstName, e.LastName, ep.Rate  
FROM HumanResources.vEmployee e   
JOIN HumanResources.EmployeePayHistory ep   
    ON e.BusinessEntityID = ep.BusinessEntityID  
WHERE ep.Rate NOT BETWEEN 27 AND 30  
ORDER BY ep.Rate;  
GO  

D. Использование оператора BETWEEN со значениями типа datetime

В приведенном ниже примере возвращаются строки, в которых значения типа datetime находятся между '20011212' и '20020105' включительно.

-- Uses AdventureWorks  
  
SELECT BusinessEntityID, RateChangeDate  
FROM HumanResources.EmployeePayHistory  
WHERE RateChangeDate BETWEEN '20011212' AND '20020105';  

Вот результирующий набор.

BusinessEntityID RateChangeDate  
----------- -----------------------  
3           2001-12-12 00:00:00.000  
4           2002-01-05 00:00:00.000  

Запрос извлекает ожидаемые строки, так как значения даты в запросе и значения типа datetime, хранящиеся в столбце RateChangeDate, были заданы без указания времени. Если время не указано, по умолчанию оно принимается равным 0:00. Обратите внимание, что строка, время в которой позднее 0:00 05.01.2002, не будет возвращена данным запросом, так как она не попадает в диапазон.

См. также

> (больше) (Transact-SQL)
< (меньше) (Transact-SQL)
Выражения (Transact-SQL)
Встроенные функции (Transact-SQL)
Операторы (Transact-SQL)
SELECT (Transact-SQL)
WHERE (Transact-SQL)