Fonction DIFFERENCE - Amazon Redshift
SyntaxeArgumentsType de retourExemples

Amazon Redshift ne prendra plus en charge la création de nouveaux Python UDFs à compter du 1er novembre 2025. Si vous souhaitez utiliser Python UDFs, créez la version UDFs antérieure à cette date. Le Python existant UDFs continuera à fonctionner normalement. Pour plus d'informations, consultez le billet de blog.

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

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

DIFFERENCE(string1, string2)

Arguments

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

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

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 |
+------------+