

 Amazon Redshift unterstützt UDFs ab Patch 198 nicht mehr die Erstellung von neuem Python. Das bestehende Python UDFs wird bis zum 30. Juni 2026 weiterhin funktionieren. Weitere Informationen finden Sie im [Blog-Posting](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Gibt ein Array von Positionen (Indizes) zurück, an denen das angegebene Element im Eingabearray vorkommt. Die Indizes basieren auf 0, wobei 0 für das erste Element, 1 für das zweite Element usw. steht. Gibt ein leeres Array zurück, wenn das Element nicht gefunden wird.

## Syntax
<a name="array_positions-syntax"></a>

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

## Argumente
<a name="array_positions-arguments"></a>

 *Array*   
Ein SUPER-Ausdruck, der das Array angibt, in dem gesucht werden soll.

 *value*   
Ein Wert, der das Element angibt, nach dem gesucht werden soll.

 *null\$1match*   
Ein boolescher Wert, der angibt, wie NULL-Werte behandelt werden:  
+ *null\$1match* = FALSE: Die Suche nach NULL gibt NULL zurück. Wenn das Array NULL-Werte enthält und für einen Suchwert, der nicht NULL ist, keine Übereinstimmung gefunden wird, wird NULL zurückgegeben.
+ *null\$1match* = TRUE: NULLs werden als gültige, durchsuchbare Elemente behandelt. Wenn das Array NULL-Werte enthält und für einen Suchwert, der nicht NULL ist, keine Übereinstimmung gefunden wird, wird ein leeres Array zurückgegeben.
Der Standardwert ist „true“.  
Die standardmäßige NULL-Behandlung kann auch mit der Konfigurationsoption angegeben werden:  

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

## Rückgabetyp
<a name="array_positions-return-type"></a>

Die Funktion ARRAY\$1POSITIONS gibt einen SUPER-Typ zurück.

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

Die folgenden Beispiele zeigen die Funktion 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)
```

Die folgenden Beispiele zeigen das Funktionsverhalten, wenn *null\$1match* auf TRUE gesetzt ist.

```
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)
```

Die folgenden Beispiele zeigen das Funktionsverhalten, wenn *null\$1match* auf FALSE gesetzt ist. Beachten Sie, dass die Angabe des *null\$1match-Verhaltens* in der Funktion die Standardkonfigurationseinstellung überschreibt.

```
-- 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)
```

## Weitere Informationen finden Sie auch unter
<a name="array_positions-see-also"></a>
+ [Funktion ARRAY\$1POSITION](array_position.md)
+ [Funktion ARRAY\$1CONTAINS](array_contains.md)
+ [SUBARRAY-Funktion](r_subarray.md)