Função NLS_LOWER() no Oracle

No Oracle, o NLS_LOWER() A função retorna seu argumento com todas as letras em minúsculas.

É semelhante ao LOWER() função, exceto que ela aceita um segundo argumento que permite especificar o agrupamento. O agrupamento lida com requisitos linguísticos especiais para conversões de maiúsculas e minúsculas.

Sintaxe

A sintaxe fica assim:

NLS_LOWER(char [, 'nlsparam' ])

Onde ambos char e 'nlsparam' pode ser de qualquer um dos tipos de dados CHAR , VARCHAR2 , NCHAR , NVARCHAR2 , CLOB , ou NCLOB .

O 'nlsparam' argumento pode ter a seguinte forma:

'NLS_SORT = sort'

Onde sort é um agrupamento nomeado.

Se você omitir esse argumento, o agrupamento determinado da função será usado.

Exemplo

Aqui está um exemplo simples para demonstrar:

SELECT NLS_LOWER('HOMER SYMPTOM') AS Result
FROM DUAL;

Resultado:

          RESULT 
________________ 
homer symptom

O mesmo se aplica quando o argumento usa maiúsculas e minúsculas:

SELECT NLS_LOWER('Homer Symptom') AS Result
FROM DUAL;

Resultado:

          RESULT 
________________ 
homer symptom

E se o argumento já estiver em minúsculas, o resultado será o mesmo da entrada:

SELECT NLS_LOWER('homer symptom') AS Result
FROM DUAL;

Resultado:

          RESULT 
________________ 
homer symptom

Especificar um agrupamento

Aqui está um exemplo que demonstra como especificar um agrupamento pode alterar os resultados:

SELECT 
    NLS_LOWER('BALIQ') AS r1,
    NLS_LOWER('BALIQ', 'NLS_SORT = XAZERBAIJANI') AS r2
FROM DUAL;

Resultado:

      R1       R2 
________ ________ 
baliq    balıq

Observe que a segunda coluna usa uma letra minúscula sem ponto i personagem, que adere ao sistema de escrita do Azerbaijão.

Observe que NLS_SORT substitui o agrupamento do primeiro argumento apenas no momento da execução. Portanto, a instrução a seguir retorna o agrupamento do primeiro argumento, não o segundo:

SELECT
    COLLATION(NLS_LOWER('BALIQ', 'NLS_SORT = XAZERBAIJANI')) AS Collation
FROM DUAL;

Resultado:

        COLLATION 
_________________ 
USING_NLS_COMP

O assunto dos agrupamentos pode ser bastante complexo. Consulte o Apêndice C no Oracle Database Globalization Support Guide para obter as regras de determinação de ordenação e as regras de derivação de ordenação para esta função.

Valores nulos

Passando null retorna null :

SELECT
    NLS_LOWER(null, 'NLS_SORT = XAZERBAIJANI') AS r1,
    NLS_LOWER('BALIQ', null) AS r2,
    NLS_LOWER(null, null) AS r3
FROM DUAL;

Resultado:

     R1      R2      R3 
_______ _______ _______ 
null    null    null

Por padrão, SQLcl e SQL*Plus retornam um espaço em branco sempre que null ocorre como resultado de um SQL SELECT demonstração.

No entanto, você pode usar SET NULL para especificar uma string diferente a ser retornada. Aqui eu especifiquei que a string null deve ser devolvido.

Contagem incorreta de argumentos

Chamando NLS_LOWER() sem passar nenhum argumento retorna um erro:

SELECT NLS_LOWER()
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT NLS_LOWER()
FROM DUAL
Error at Command Line : 1 Column : 8
Error report -
SQL Error: ORA-00938: not enough arguments for function
00938. 00000 -  "not enough arguments for function"
*Cause:    
*Action:

E passar muitos argumentos resulta em um erro:

SELECT NLS_LOWER('Homer', 'NLS_SORT = XAZERBAIJANI', 'Symptom')
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT NLS_LOWER('Homer', 'NLS_SORT = XAZERBAIJANI', 'Symptom')
FROM DUAL
Error at Command Line : 1 Column : 54
Error report -
SQL Error: ORA-00939: too many arguments for function
00939. 00000 -  "too many arguments for function"
*Cause:    
*Action: