IN (Transact-SQL)
S’applique à : 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric
Détermine si une valeur donnée correspond à la valeur d'une liste ou d'une sous-requête.
Conventions de la syntaxe Transact-SQL
Syntaxe
test_expression [ NOT ] IN
( subquery | expression [ ,...n ]
)
Arguments
test_expression
Toute expression valide.
subquery
Sous-requête avec un jeu de résultats d'une colonne. Cette colonne doit avoir le même type de données que test_expression.
expression[ ,... n ]
Liste d'expressions utilisée pour vérifier une correspondance. Toutes les expressions doivent avoir le même type de données que test_expression.
Types des résultats
Booléen
Valeur des résultats
Si la valeur de test_expression est égale à une valeur retournée par la sous-requête ou à l’une des expressions de la liste séparée par des virgules, le résultat est TRUE. Dans le cas contraire, ce résultat est FALSE.
L’utilisation de NOT IN inverse la valeur de la sous-requête ou l’expression.
Attention
Toute valeur Null retournée par la sous-requête ou l’expression comparée à test_expression en utilisant IN ou NOT IN retourne UNKNOWN. L'utilisation de valeurs Null avec IN ou NOT IN peut produire des résultats inattendus.
Remarques
Incluant explicitement un très grand nombre de valeurs (plusieurs milliers de valeurs séparées par des virgules) entre parenthèses, une clause IN peut consommer des ressources et retourner des erreurs 8623 ou 8632. Pour contourner ce problème, stockez les éléments dans la liste IN dans une table et utilisez une sous-requête SELECT dans une clause IN.
Error 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.
Erreur 8632 :
Internal error: An expression services limit has been reached. Please look for potentially complex expressions in your query, and try to simplify them.
Exemples
R. Comparaison des opérateurs OR et IN
L'exemple suivant sélectionne une liste des noms d'employés qui sont ingénieurs concepteurs, concepteurs d'outils ou assistants marketing.
-- 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
Vous obtenez toutefois les mêmes résultats en utilisant 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
Voici le jeu de résultats obtenu pour l'une ou l'autre des requêtes.
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. Utilisation de l'opérateur IN avec une sous-requête
L'exemple suivant recherche tous les ID des vendeurs dans la table SalesPerson pour les employés dont le quota de ventes annuel est supérieur à 250 000 $. Il sélectionne ensuite, dans la table Employee, les noms de tous les employés dont l'EmployeeID correspond aux résultats issus de la sous-requête 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
Voici le jeu de résultats.
FirstName LastName
--------- --------
Tsvi Reiter
Michael Blythe
Tete Mensa-Annan
(3 row(s) affected)
C. Utilisation de l'opérateur NOT IN avec une sous-requête
L'exemple suivant recherche les vendeurs qui n'ont pas de quota supérieur à 250 000 $. NOT IN identifie les vendeurs qui ne correspondent pas aux éléments de la liste de valeurs.
-- 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
Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)
D. Utilisation des clauses IN et NOT IN
L’exemple suivant recherche toutes les entrées dans la table FactInternetSales qui correspondent à des valeurs SalesReasonKey dans la table DimSalesReason.
-- Uses AdventureWorks
SELECT * FROM FactInternetSalesReason
WHERE SalesReasonKey
IN (SELECT SalesReasonKey FROM DimSalesReason);
L’exemple suivant recherche toutes les entrées dans la table FactInternetSalesReason qui ne correspondent pas à des valeurs SalesReasonKey dans la table DimSalesReason.
-- Uses AdventureWorks
SELECT * FROM FactInternetSalesReason
WHERE SalesReasonKey
NOT IN (SELECT SalesReasonKey FROM DimSalesReason);
E. Utilisation de la clause IN avec une liste d’expressions
L’exemple suivant recherche tous les ID des vendeurs figurant dans la table DimEmployee dont le prénom est Mike ou Michael.
-- Uses AdventureWorks
SELECT FirstName, LastName
FROM DimEmployee
WHERE FirstName IN ('Mike', 'Michael');
Voir aussi
CASE (Transact-SQL)
Expressions (Transact-SQL)
Fonctions intégrées (Transact-SQL)
Opérateurs (Transact-SQL)
SELECT (Transact-SQL)
WHERE (Transact-SQL)
ALL (Transact-SQL)
SOME | ANY (Transact-SQL)