Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# ARRAY\$1POSITIONS 関数
<a name="array_positions"></a>

指定された要素が入力配列に表示される位置 (インデックス) の配列を返します。インデックスは 0 ベースで、0 は最初の要素を示し、1 は 2 番目の要素を示します。要素が見つからない場合は、空の配列を返します。

## 構文
<a name="array_positions-syntax"></a>

```
ARRAY_POSITIONS( array, value [, null_match] )
```

## 引数
<a name="array_positions-arguments"></a>

 *array*   
検索する配列を指定する SUPER 式。

 *値*   
検索する要素を指定する値。

 *null\$1match*   
NULL 値の処理方法を指定するブール値:  
+ *null\$1match* = FALSE: NULL を検索すると、NULL が返されます。配列に NULL 値が含まれており、NULL 以外の検索値に一致するものが見つからない場合は、NULL が返されます。
+ *null\$1match* = TRUE: NULL は、有効な、検索可能な要素として扱われます。配列に NULL 値が含まれており、NULL 以外の検索値に一致するものが見つからない場合は、空の配列が返されます。
デフォルトは TRUE です。  
デフォルトの NULL 処理は、設定オプションで指定することもできます。  

```
-- same as null_match = TRUE
SET default_array_search_null_handling to TRUE;
```

## 戻り型
<a name="array_positions-return-type"></a>

ARRAY\$1POSITIONS 関数は、SUPER データ型を返します。

## 例
<a name="array_positions-example"></a>

次の例は、ARRAY\$1POSITIONS 関数を示しています。

```
SELECT ARRAY_POSITIONS(ARRAY('red', 'green', 'red'), 'red');
 array_positions 
-----------------
 [0,2]
(1 row)

SELECT ARRAY_POSITIONS(ARRAY(1, 2, 3), 4);
 array_positions 
-----------------
 []
(1 row)
```

次の例は、*null\$1match* を TRUE に設定した場合の関数の動作を示しています。

```
SET default_array_search_null_handling to TRUE;

-- NULL search is enabled
SELECT ARRAY_POSITIONS(ARRAY('red', NULL, 'green', NULL), NULL);
 array_positions 
-----------------
 [1,3]
(1 row)

-- The array can contain NULLs
SELECT ARRAY_POSITIONS(ARRAY('red', NULL, 'green'), 'blue', TRUE);
 array_positions 
-----------------
 []
(1 row)
```

次の例は、*null\$1match* を FALSE に設定した場合の関数の動作を示しています。関数内で *null\$1match* 動作を指定すると、デフォルト設定が上書きされることに注意してください。

```
-- same as null_match = TRUE
SET default_array_search_null_handling to TRUE;

-- NULL search is disabled. The default behavior is overridden
SELECT ARRAY_POSITIONS(ARRAY('red', 'green'), NULL, FALSE);
 array_positions 
-----------------
 
(1 row)

-- same as null_match = FALSE
SET default_array_search_null_handling to FALSE;

-- The array contains NULL and a match is found
SELECT ARRAY_POSITIONS(ARRAY('red', NULL, 'green'), 'green');
 array_positions 
-----------------
 [2]
(1 row)

-- The array contains NULL but no match is found
SELECT ARRAY_POSITIONS(ARRAY('red', NULL, 'green'), 'blue');
 array_positions 
-----------------
 
(1 row)
```

## 関連情報
<a name="array_positions-see-also"></a>
+ [ARRAY\$1POSITION 関数](array_position.md)
+ [ARRAY\$1CONTAINS 関数](array_contains.md)
+ [SUBARRAY 関数](r_subarray.md)