wikinotes

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
{{tag>tutotriel sql postgresql db database}}


====== PostgreSQL IN ======

Notes et traduction du tutoriel [[https://neon.tech/postgresql/tutorial|PostgreSQL Tutorial]]

L'opérateur ''IN'' permet de vérifier si une valeur se trouve parmi une liste de valeurs :

<code sql>
value IN (value1,value2,...)
</code>

L'opérateur ''IN'' retourne vrai si "value" est égale à l'une des valeurs de la liste : "value1", "value2" etc.

  * La liste des valeurs est une liste littérale incluant nombres et chaînes de caractères.
  * En plus des valeurs littérales, l' opérateur ''IN'' accepte une liste de valeurs retournée par une requête (confère [[https://neon.tech/postgresql/postgresql-tutorial/postgresql-subquery/|tutoriel sous-requête]]). 

Du point de vue fonctionnel, utiliser l'opérateur ''IN'' est équivalent à combiner des expressions booléennes avec l'opérateur ''OR'':

<code sql>
value IN (value1,value2,...)

# Equivaut
value = value1 OR value = value2 OR ...
</code>

Par exemple :

<code sql>
SELECT
  film_id,
  title
FROM
  film
WHERE
  film_id in (1, 2, 3);

-- Requête équivalente
SELECT
  film_id,
  title
FROM
  film
WHERE
  film_id = 1
  OR film_id = 2
  OR film_id = 3;
</code>

L'usage de ''IN'' rend la première forme plus condensée et plus lisible.

Ci-dessous un exemple avec des chaînes de caractères :

<code sql>
SELECT
  first_name,
  last_name
FROM
  actor
WHERE
  last_name IN ('Allen', 'Chase', 'Davis')
ORDER BY
  last_name;
</code>

Un autre exemple un peut particulier avec une valeur de type timestamp :
<code sql>
SELECT
  payment_id,
  amount,
  payment_date
FROM
  payment
WHERE
  payment_date::date IN ('2007-02-15', '2007-02-16');
</code>

La requête retourne:
<code>
payment_id | amount |        payment_date
------------+--------+----------------------------
      17503 |   7.99 | 2007-02-15 22:25:46.996577
      17504 |   1.99 | 2007-02-16 17:23:14.996577
      17505 |   7.99 | 2007-02-16 22:41:45.996577
      17512 |   4.99 | 2007-02-16 00:10:50.996577
...
</code>

Ici le champ ''payment_date'' est de type **timestamp** contenant une partie date et une partie heure. Pour pouvoir comparer la valeur ''payment_date'' avec une liste de dates, il faut d'abord changer son type via l'opérateur de transtypage ''::'' (cast operator)

<code sql>
-- Convertir le timestamp en date
payment_date::date
</code>

Par exemple si le timestamp vaut ''2007-02-15 22:25:46.996577'', l'opérateur de transtypage le convertit en ''2007-02-15''.

===== L'opérateur NOT IN =====

L'opérateur ''NOT IN'' retourne vrai si la valeur est différente de tous les éléments de la liste.

Utiliser l'opérateur NOT IN est équivalent à utiliser une combinaison d'expression booléennes avec des opérateurs ''AND'' :

<code sql>
value NOT IN (value1, value2, ...)

-- Equivaut
value <> value1 AND value <> value2 AND ...
</code>

Par exemple :

<code sql>
SELECT
  film_id,
  title
FROM
  film
WHERE
  film_id NOT IN (1, 2, 3)
ORDER BY
  film_id;
  
-- Requête équivalente
SELECT
  film_id,
  title
FROM
  film
WHERE
  film_id <> 1
  AND film_id <> 2
  AND film_id <> 3
ORDER BY
  film_id;
</code>


===== Résumé =====

  * Utiliser l'opérateur ''IN'' pour vérifier si une valeur se trouve dans une liste de valeurs ;
  * Utiliser l'opérateur ''NOT'' pour inverser la comparaison et vérifier qu'un valeur est bien absente d'une liste de valeurs.

[[230_clause_fetch|◁ Précédent]] |
[[000_start|⌂ Retour au sommaire]] |
[[240_between|Suivant ▷]]
wikinotes

Outils pour utilisateurs

Outils du site

Outils de la page
