[ NOT ] IN¶

構文¶

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

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

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

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

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

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

パラメーター¶

value

検索する値。

value_A、 value_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 は、 サブクエリ演算子 とも見なされます。

• IN を使用するクエリでは、スプレッド演算子（**）を使用することで、 配列 を個々の値のリストに展開することができます。詳細情報と例については、 展開演算子 をご参照ください。

照合順序の詳細¶

Arguments with collation specifications currently aren't supported.

例¶

以下の例では、 IN 関数を使用しています。

SELECT 1 IN (1, 2, 3) AS RESULT; 

+--------+ | RESULT | |--------| | True | +--------+ 

SELECT 4 NOT IN (1, 2, 3) AS RESULT; 

+--------+ | RESULT | |--------| | True | +--------+ 

SELECT 'a' IN ( SELECT column1 FROM VALUES ('b'), ('c'), ('d') ) AS RESULT; 

+--------+ | RESULT | |--------| | False | +--------+ 

CREATE OR REPLACE TABLE in_function_demo ( col_1 INTEGER, col_2 INTEGER, col_3 INTEGER); INSERT INTO in_function_demo (col_1, col_2, col_3) VALUES (1, 1, 1), (1, 2, 3), (4, 5, NULL); 

SELECT col_1, col_2, col_3 FROM in_function_demo 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 | +-------+-------+-------+ 

SELECT col_1, col_2, col_3 FROM in_function_demo WHERE (col_1, col_2, col_3) IN ( (1,2,3), (4,5,6)); 

+-------+-------+-------+ | COL_1 | COL_2 | COL_3 | |-------+-------+-------| | 1 | 2 | 3 | +-------+-------+-------+ 

SELECT (1, 2, 3) IN ( SELECT col_1, col_2, col_3 FROM in_function_demo ) AS RESULT; 

+--------+ | RESULT | |--------| | True | +--------+ 

SELECT NULL IN (1, 2, NULL) AS RESULT; 

+--------+ | RESULT | |--------| | NULL | +--------+ 

SELECT (4, 5, NULL) IN ( (4, 5, NULL), (7, 8, 9) ) AS RESULT; 

+--------+ | RESULT | |--------| | NULL | +--------+