Oracle
 sql >> Base de Dados >  >> RDS >> Oracle

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: