カテゴリ:

条件式関数

[ NOT ] IN

引数が明示的リストのメンバーの1つであるか、サブクエリの結果であるかをテストします。

注釈

サブクエリ形式では、 IN は = ANY と同等で、 NOT IN は <> ALL と同等です。

Tip

検索最適化サービスを使用すると、この関数を呼び出すクエリのパフォーマンスを向上させることができます。詳細については、 検索最適化サービス をご参照ください。

構文

個々の値を比較するには、

<value> [ NOT ] IN ( <value_1> [ , <value_2> ...  ] )
Copy

行コンストラクター (括弧で囲まれた値のリスト)を比較するには、

( <value_A> [, <value_B> ... ] ) [ NOT ] IN (  ( <value_1> [ , <value_2> ... ] )  [ , ( <value_3> [ , <value_4> ... ] )  ...  ]  )
Copy

値をサブクエリによって返される値と比較するには、

<value> [ NOT ] IN ( <subquery> )
Copy

パラメーター

value

検索する値。

value_Avalue_B

検索する行コンストラクターの要素。

IN の右側の各値(例: (value3, value4))が、 IN の左側の値(例: (value_A, value_B))と同じ数の要素を持っていることを確認します。

value_#

value を比較する必要がある値。

比較する値が行コンストラクターの場合、各 value_# は行コンストラクターの個々の要素です。

subquery

value と比較できる値のリストを返すサブクエリ。

使用上の注意

  • ほとんどのコンテキストと同様に、 NULL は NULL と同等ではありません。 value が NULLの場合、リストまたはサブクエリに NULLが含まれているかどうかにかかわらず、関数の戻り値は NULLです。

    たとえば、次の場合は TRUE ではなく NULL を返します。

    SELECT NULL IN (1, 2, NULL) AS RESULT;
    
    Copy
  • 構文的には、 IN は関数ではなく演算子として扱われます。以下の例は、演算子として IN を使用する場合と、関数として f() を呼び出す場合の違いを示しています。

    SELECT
        f(a, b),
        x IN (y, z) ...
    
    Copy

    関数構文では IN を使用 できません。たとえば、前述の例を次のように書き直すことはできません。

    SELECT
        f(a, b),
        IN(x, (y, z)) ...
    
    Copy
  • IN は、 サブクエリ演算子 とも見なされます。

照合の詳細

Arguments with collation specifications are currently not supported.

単純なリテラルでの IN の使用

次の例は、単純なリテラルで INNOT IN を使用する方法を示しています。

SELECT 1 IN (1, 2, 3) AS RESULT;
+--------+
| RESULT |
|--------|
| True   |
+--------+
Copy
SELECT 4 NOT IN (1, 2, 3) AS RESULT;
+--------+
| RESULT |
|--------|
| True   |
+--------+
Copy

サブクエリでの IN の使用

SELECT 'a' IN (
    SELECT column1 FROM VALUES ('b'), ('c'), ('d')
    ) AS RESULT;
+--------+
| RESULT |
|--------|
| False  |
+--------+
Copy

テーブルでの IN の使用

これらの例は、テーブルで IN を使用する方法を示しています。以下のステートメントは、例で使用されるテーブルを作成します。

CREATE TABLE my_table (col_1 INTEGER, col_2 INTEGER, col_3 INTEGER);
INSERT INTO my_table (col_1, col_2, col_3) VALUES
    (1, 1, 1),
    (1, 2, 3),
    (4, 5, NULL);
Copy

次の例は、テーブルの単一列で IN を使用する方法を示しています。

SELECT col_1, col_2, col_3
    FROM my_table
    WHERE (col_1) IN (1, 10, 100, 1000)
    ORDER BY col_1, col_2, col_3;
+-------+-------+-------+
| COL_1 | COL_2 | COL_3 |
|-------+-------+-------|
|     1 |     1 |     1 |
|     1 |     2 |     3 |
+-------+-------+-------+
Copy

次の例は、テーブルの複数列で IN を使用する方法を示しています。

SELECT col_1, col_2, col_3
    FROM my_table
    WHERE (col_1, col_2, col_3) IN ( 
                                   (1,2,3), 
                                   (4,5,6)
                                   );
+-------+-------+-------+
| COL_1 | COL_2 | COL_3 |
|-------+-------+-------|
|     1 |     2 |     3 |
+-------+-------+-------+
Copy

次の例は、テーブルの複数列を読み取るサブクエリで IN を使用する方法を示しています。

SELECT (1, 2, 3) IN (
    SELECT col_1, col_2, col_3 FROM my_table
    ) AS RESULT;
+--------+
| RESULT |
|--------|
| True   |
+--------+
Copy

NULL の使用

NULL != NULLです。 IN の左側または右側の値に NULL が含まれている場合、次のクエリはいずれも一致を返しません。

SELECT NULL IN (1, 2, NULL) AS RESULT;
+--------+
| RESULT |
|--------|
| NULL   |
+--------+
Copy
SELECT (4, 5, NULL) IN ( (4, 5, NULL), (7, 8, 9) ) AS RESULT;
+--------+
| RESULT |
|--------|
| NULL   |
+--------+
Copy