Função NLS_UPPER() no Oracle

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

É semelhante ao UPPER() 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_UPPER(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_UPPER('coffee time') AS Result
FROM DUAL;

Resultado:

        RESULT 
______________ 
COFFEE TIME

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

SELECT NLS_UPPER('Coffee Time') AS Result
FROM DUAL;

Resultado:

        RESULT 
______________ 
COFFEE TIME

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

SELECT NLS_UPPER('COFFEE TIME') AS Result
FROM DUAL;

Resultado:

        RESULT 
______________ 
COFFEE TIME

Especificar um agrupamento

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

SELECT 
    NLS_UPPER('fasilə') AS r1,
    NLS_UPPER('fasilə', 'NLS_SORT = XAZERBAIJANI') AS r2
FROM DUAL;

Resultado:

       R1        R2 
_________ _________ 
FASILƏ    FASİLƏ

Observe que a segunda coluna usa uma letra maiúscula pontilhada 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_UPPER('fasilə', '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_UPPER(null, 'NLS_SORT = XAZERBAIJANI') AS r1,
    NLS_UPPER('fasilə', null) AS r2,
    NLS_UPPER(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_UPPER() sem passar nenhum argumento retorna um erro:

SELECT NLS_UPPER()
FROM DUAL;

Resultado:

Error starting at line : 1 in command -
SELECT NLS_UPPER()
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_UPPER('coffee', 'NLS_SORT = XAZERBAIJANI', 'time')
FROM DUAL;

Resultado:

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