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\$1POSITION
<a name="array_position"></a>

Gibt die Position (Index) des ersten Vorkommens eines angegebenen Elements in einem Array zurück. Der Index basiert auf 0, wobei 0 für das erste Element, 1 für das zweite Element usw. steht. Gibt -1 zurück, wenn das Element nicht im Array gefunden wird.

Die Funktion gibt nur die Position des ersten Vorkommens zurück. Um alle Vorkommen zu finden, sollten Sie die [Funktion ARRAY\$1POSITIONS](array_positions.md) Funktion verwenden.

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

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

## Argumente
<a name="array_position-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 -1 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_position-return-type"></a>

Die Funktion ARRAY\$1POSITION gibt einen INT-Typ zurück.

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

Die folgenden Beispiele zeigen die Funktion ARRAY\$1POSITION.

```
SELECT ARRAY_POSITION(ARRAY('red', 'green'), 'red');
 array_position 
----------------
              0
(1 row)

SELECT ARRAY_POSITION(ARRAY(1, 2, 3), 4);
 array_position 
----------------
             -1
(1 row)

-- only the position of the first occurrence is returned
SELECT ARRAY_POSITION(ARRAY('red', 'green', 'red'), 'red');
 array_position 
----------------
              0
(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_POSITION(ARRAY('red', NULL, 'green'), NULL);
 array_position 
----------------
              1
(1 row)

-- The array can contain NULLs
SELECT ARRAY_POSITION(ARRAY('red', NULL, 'green'), 'blue', TRUE);
 array_position 
----------------
             -1
(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_POSITION(ARRAY('red', 'green'), NULL, FALSE);
 array_position 
----------------
               
(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_POSITION(ARRAY('red', NULL, 'green'), 'green');
 array_position 
----------------
              2
(1 row)

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

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