O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função STRPOS
<a name="r_STRPOS"></a>

Retorna a posição de uma substring em uma string especificada. 

Consulte [Função CHARINDEX](r_CHARINDEX.md) e [Função POSITION](r_POSITION.md) para ver funções semelhantes.

## Sintaxe
<a name="r_STRPOS-synopsis"></a>

```
STRPOS(string, substring )
```

## Argumentos
<a name="r_STRPOS-arguments"></a>

 *string*   
O primeiro parâmetro de entrada é a string `CHAR` ou `VARCHAR` a ser pesquisada. 

 *substring*   
O segundo parâmetro é a substring a procurar dentro da *string*. 

## Tipo de retorno
<a name="r_STRPOS-return-type"></a>

INTEGER  
A função STRPOS retorna um `INTEGER` correspondente à posição da *substring* (baseada em 1, não baseada em zero). A posição é baseada no número de caracteres, e não bytes, de forma que caracteres multibyte são contados como caracteres simples.

## Observações de uso
<a name="r_STRPOS_usage_notes"></a>

STRPOS retornará `0` se a *substring* não for localizada dentro da *string*. 

```
SELECT STRPOS('dogfish', 'fist');

+--------+
| strpos |
+--------+
|      0 |
+--------+
```

## Exemplos
<a name="r_STRPOS-examples"></a>

Para mostrar a posição de `fish` em `dogfish`, use o exemplo a seguir. 

```
SELECT STRPOS('dogfish', 'fish');

+--------+
| strpos |
+--------+
|      4 |
+--------+
```

O exemplo a seguir usa dados da tabela SALES do banco de dados de amostra TICKIT. Para obter mais informações, consulte [Banco de dados de exemplo](c_sampledb.md). 

Para retornar o número de transações de vendas com uma COMMISSION acima de 999,00 da tabela SALES, use o exemplo a seguir. 

```
SELECT DISTINCT STRPOS(commission, '.'),
COUNT (STRPOS(commission, '.'))
FROM sales
WHERE STRPOS(commission, '.') > 4
GROUP BY STRPOS(commission, '.')
ORDER BY 1, 2;

+--------+-------+
| strpos | count |
+--------+-------+
|      5 |   629 |
+--------+-------+
```