Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Fonction DIFFERENCE
<a name="DIFFERENCE"></a>

La fonction DIFFERENCE compare les codes Soundex américains de deux chaînes. La fonction renvoie un `INTEGER` pour indiquer le nombre de caractères correspondants entre les codes Soundex. 

 Un code Soundex est une chaîne de quatre caractères. Un code Soundex représente la sonorité d’un mot plutôt que son orthographe. Par exemple, `Smith` et `Smyth` ont le même code Soundex. 

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

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

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

 *string1*   
Chaîne `CHAR`, chaîne `VARCHAR` ou expression qui équivaut implicitement à un type `CHAR` ou `VARCHAR`.

 *string2*   
Chaîne `CHAR`, chaîne `VARCHAR` ou expression qui équivaut implicitement à un type `CHAR` ou `VARCHAR`.

## Type de retour
<a name="DIFFERENCE-return-type"></a>

 INTEGER   
La fonction DIFFERENCE renvoie une valeur `INTEGER` comprise entre 0 et 4 qui compte le nombre de caractères correspondants dans les codes Soundex américains des deux chaînes. Un code Soundex comporte 4 caractères, donc la fonction DIFFERENCE renvoie `4` quand les 4 caractères des valeurs de code Soundex américain des chaînes sont identiques. DIFFERENCE renvoie `0` si l’une des deux chaînes est vide. La fonction renvoie `1` si aucune des chaînes ne contient de caractères valides. La fonction DIFFERENCE convertit uniquement les caractères ASCII alphabétiques anglais minuscules ou majuscules, y compris a–z et A–Z. DIFFERENCE ignore les autres caractères.

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

Pour comparer les valeurs Soundex des chaînes `%` et `@`, utilisez l’exemple suivant. La fonction renvoie `1` car aucune des chaînes ne contient de caractères valides.

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

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

Pour comparer les valeurs Soundex de `Amazon` et d’une chaîne vide, utilisez l’exemple suivant. La fonction renvoie `0` car l’une des deux chaînes est vide.

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

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

Pour comparer les valeurs Soundex des chaînes `Amazon` et `Ama`, utilisez l’exemple suivant. La fonction renvoie `2` car 2 caractères des valeurs Soundex des chaînes sont identiques.

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

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

Pour comparer les valeurs Soundex des chaînes `Amazon` et `+-*/%Amazon`, utilisez l’exemple suivant. La fonction renvoie `4` car les quatre caractères des valeurs Soundex des chaînes sont identiques. Notez que la fonction ignore les caractères non valides `+-*/%` dans la deuxième chaîne.

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

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

Pour comparer les valeurs Soundex des chaînes `AC/DC` et `Ay See Dee See`, utilisez l’exemple suivant. La fonction renvoie `4` car les quatre caractères des valeurs Soundex des chaînes sont identiques.

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

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