Função DIFFERENCE - Amazon Redshift
SintaxeArgumentosTipo de retornoExemplos

O Amazon Redshift não permitirá mais a criação de funções definidas pelo usuário (UDFs) do Python a partir de 1.º de novembro de 2025. Se quiser usar UDFs do Python, você deve criá-las antes dessa data. As UDFs do Python existentes continuarão a funcionar normalmente. Para ter mais informações, consulte a publicação de blog .

Função DIFFERENCE

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

DIFFERENCE(string1, string2)

Argumentos

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

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

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