IN (Transact-SQL)

適用於：Microsoft Fabric 中 Microsoft Fabric倉儲中的 SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體 Azure SynapseAnalytics Analytics Platform System （PDW）SQL 分析端點

判斷指定的值是否符合子查詢或清單中的任何值。

Transact-SQL 語法慣例

Syntax

test_expression [ NOT ] IN   
    ( subquery | expression [ ,...n ]  
    )   

引數

test_expression
這是任何有效的運算式。

subquery
這是有單一資料行結果集的子查詢。 這個資料行必須具備與 test_expression 相同的資料類型。

expression[ ,... n ]
這是要進行相符測試的運算式清單。 所有運算式的類型都必須與 test_expression 相同。

結果類型

布林值

結果值

如果 test_expression 的值等於 subquery 所傳回的任何值，或等於以逗號分隔清單中的任何 expression，結果值就是 TRUE；否則，結果值就是 FALSE。

使用 NOT IN 會否定 subquery 值或 expression。

備註

在 IN 子句中明確包括極大量的值 (數千個以逗號分隔的值) 會耗用資源，並傳回錯誤 8623 或 8632。 若要解決此問題，請將項目儲存在資料表的 IN 清單中，並在 IN 子句內使用 SELECT 子查詢。

錯誤 8623：

The query processor ran out of internal resources and could not produce a query plan. This is a rare event and only expected for extremely complex queries or queries that reference a very large number of tables or partitions. Please simplify the query. If you believe you have received this message in error, contact Customer Support Services for more information.

錯誤 8632：

Internal error: An expression services limit has been reached. Please look for potentially complex expressions in your query, and try to simplify them.

範例

A. 比較 OR 及 IN

下列範例會選取設計工程師、工具設計師或行銷助理等員工名單。

-- Uses AdventureWorks  
  
SELECT p.FirstName, p.LastName, e.JobTitle  
FROM Person.Person AS p  
JOIN HumanResources.Employee AS e  
    ON p.BusinessEntityID = e.BusinessEntityID  
WHERE e.JobTitle = 'Design Engineer'   
   OR e.JobTitle = 'Tool Designer'   
   OR e.JobTitle = 'Marketing Assistant';  
GO  

不過，您將利用 IN 來擷取相同的結果。

-- Uses AdventureWorks  
  
SELECT p.FirstName, p.LastName, e.JobTitle  
FROM Person.Person AS p  
JOIN HumanResources.Employee AS e  
    ON p.BusinessEntityID = e.BusinessEntityID  
WHERE e.JobTitle IN ('Design Engineer', 'Tool Designer', 'Marketing Assistant');  
GO  

以下是任何一項查詢的結果集。

FirstName   LastName      Title  
---------   ---------   ---------------------  
Sharon      Salavaria   Design Engineer                                     
Gail        Erickson    Design Engineer                                     
Jossef      Goldberg    Design Engineer                                     
Janice      Galvin      Tool Designer                                       
Thierry     D'Hers      Tool Designer                                       
Wanida      Benshoof    Marketing Assistant                                 
Kevin       Brown       Marketing Assistant                                 
Mary        Dempsey     Marketing Assistant                                 
  
(8 row(s) affected)  

B. 使用 IN 搭配子查詢

下列範例在 SalesPerson 資料表中，針對年度銷售配額超出 $250,000 之員工來尋找銷售人員的所有識別碼，之後，再從 Employee 資料表中，選取 EmployeeID 符合 SELECT 子查詢結果的所有員工姓名。

-- Uses AdventureWorks  
  
SELECT p.FirstName, p.LastName  
FROM Person.Person AS p  
    JOIN Sales.SalesPerson AS sp  
    ON p.BusinessEntityID = sp.BusinessEntityID  
WHERE p.BusinessEntityID IN  
   (SELECT BusinessEntityID  
   FROM Sales.SalesPerson  
   WHERE SalesQuota > 250000);  
GO  

以下為結果集。

FirstName   LastName                                             
---------   --------   
Tsvi         Reiter                                              
Michael      Blythe                                              
Tete         Mensa-Annan                                         
  
(3 row(s) affected)  

C. 使用 NOT IN 搭配子查詢

下列範例會尋找配額不超出 $250,000 的銷售人員。 NOT IN 會尋找不符合值清單項目的銷售人員。

-- Uses AdventureWorks  
  
SELECT p.FirstName, p.LastName  
FROM Person.Person AS p  
    JOIN Sales.SalesPerson AS sp  
    ON p.BusinessEntityID = sp.BusinessEntityID  
WHERE p.BusinessEntityID NOT IN  
   (SELECT BusinessEntityID  
   FROM Sales.SalesPerson  
   WHERE SalesQuota > 250000);  
GO  

範例：Azure Synapse Analytics 和 Analytics Platform System (PDW)

D. 使用 IN 和 NOT IN

下列範例會在 FactInternetSales 資料表中尋找符合 DimSalesReason 資料表中 SalesReasonKey 值的所有項目。

-- Uses AdventureWorks  
  
SELECT * FROM FactInternetSalesReason   
WHERE SalesReasonKey   
IN (SELECT SalesReasonKey FROM DimSalesReason);   

下列範例會在 FactInternetSalesReason 資料表中尋找不符合 DimSalesReason 資料表中 SalesReasonKey 值的所有項目。

-- Uses AdventureWorks  
  
SELECT * FROM FactInternetSalesReason   
WHERE SalesReasonKey   
NOT IN (SELECT SalesReasonKey FROM DimSalesReason);  

E. 搭配運算式清單使用 IN

下列範例會在 DimEmployee 資料表中針對名字為 Mike 或 Michael 的員工，尋找銷售人員的所有識別碼。

-- Uses AdventureWorks  
  
SELECT FirstName, LastName  
FROM DimEmployee  
WHERE FirstName IN ('Mike', 'Michael');  

另請參閱

CASE (Transact-SQL)
運算式 (Transact-SQL)
內建函數 (Transact-SQL)
運算子 (Transact-SQL)
SELECT (Transact-SQL)
WHERE (Transact-SQL)
ALL (Transact-SQL)
SOME | ANY (Transact-SQL)