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 DIFFERENCE
<a name="DIFFERENCE"></a>

A função DIFFERENCE compara os códigos American Soundex de duas strings. A função retorna um `INTEGER` para indicar o número de caracteres correspondentes entre os códigos Soundex. 

 Um código Soundex é uma string com quatro caracteres. Um código Soundex representa como uma palavra soa em vez de como ela é escrita. Por exemplo, `Smith` e `Smyth` têm o mesmo código Soundex. 

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

```
DIFFERENCE(string1, string2)
```

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

 *string1*   
Uma string `CHAR`, uma string `VARCHAR` ou uma expressão que é avaliada implicitamente como um tipo `CHAR` ou `VARCHAR`.

 *string2*   
Uma string `CHAR`, uma string `VARCHAR` ou uma expressão que é avaliada implicitamente como um tipo `CHAR` ou `VARCHAR`.

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

 INTEGER   
A função DIFFERENCE retorna um valor `INTEGER` de 0 a 4 que conta o número de caracteres correspondentes nos códigos American Soundex das duas strings. Um código Soundex tem quatro caracteres, então a função DIFFERENCE retornará `4` quando todos os quatro caracteres dos valores do código American Soundex das strings forem iguais. DIFFERENCE retornará `0` se uma das duas strings estiver vazia. A função retornará `1` se nenhuma string contiver caracteres válidos. A função DIFFERENCE converte apenas caracteres ASCII em letras minúsculas ou maiúsculas em inglês, incluindo a–z e A–Z. A DIFFERENCE ignora outros caracteres.

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

Para comparar os valores do Soundex das strings `%` e `@`, use o exemplo a seguir. A função retornará `1` porque nenhuma string contém caracteres válidos.

```
SELECT DIFFERENCE('%', '@');

+------------+
| difference |
+------------+
|          1 |
+------------+
```

Para comparar os valores do Soundex de `Amazon` e uma string vazia, use o exemplo a seguir. A função retornará `0` porque uma das duas strings está vazia.

```
SELECT DIFFERENCE('Amazon', '');

+------------+
| difference |
+------------+
|          0 |
+------------+
```

Para comparar os valores do Soundex das strings `Amazon` e `Ama`, use o exemplo a seguir. A função retornará `2` porque dois caracteres dos valores do Soundex das strings são iguais.

```
SELECT DIFFERENCE('Amazon', 'Ama');

+------------+
| difference |
+------------+
|          2 |
+------------+
```

Para comparar os valores do Soundex das strings `Amazon` e `+-*/%Amazon`, use o exemplo a seguir. A função retornará `4` porque todos os quatro caracteres dos valores do Soundex das strings são iguais. Observe que a função ignora os caracteres inválidos `+-*/%` na segunda string.

```
SELECT DIFFERENCE('Amazon', '+-*/%Amazon');

+------------+
| difference |
+------------+
|          4 |
+------------+
```

Para comparar os valores do Soundex das strings `AC/DC` e `Ay See Dee See`, use o exemplo a seguir. A função retornará `4` porque todos os quatro caracteres dos valores do Soundex das strings são iguais.

```
SELECT DIFFERENCE('AC/DC', 'Ay See Dee See');

+------------+
| difference |
+------------+
|          4 |
+------------+
```