GE - Como Fazer - Verificação de Character Set do Oracle para Atualização do CIGAM11

De CIGAM WIKI

Voltar

Como Fazer > Utilidades/Diversos > Verificação de Character Set do Oracle para Atualização do CIGAM11

A partir de uma evolução no CIGAM11, passou a ser realizada a verificação dos conjuntos de caracteres (NLS) configurados no banco de dados Oracle.
Essa validação é necessária pois divergências nesses parâmetros podem causar inconsistências e falhas durante a atualização de versão do sistema.

Objetivo

Orientar como identificar e tratar divergências de conjuntos de caracteres (Character Set) no banco de dados Oracle utilizados pelo CIGAM11, garantindo que o ambiente esteja compatível para atualização de versão.

Pré-requisitos

Antes de iniciar o procedimento:

  • Ter acesso ao banco de dados Oracle com privilégios para executar consultas.
  • Entender que determinados parâmetros só podem ser definidos no momento da criação do database.

Identificando o Character Set no Oracle

A verificação dos parâmetros de configuração do banco Oracle pode ser feita por meio da consulta SQL abaixo: 

  SELECT parameter, value
  FROM nls_database_parameters
  WHERE parameter IN ('NLS_CHARACTERSET', 'NLS_NCHAR_CHARACTERSET');

Os parâmetros esperados para o ambiente CIGAM11 são:

  • NLS_CHARACTERSET = AL16UTF16
  • NLS_NCHAR_CHARACTERSET = WE8MSWIN1252

Análise do Resultado

Após executar a consulta:

  • Se os valores estiverem de acordo com o esperado, não é necessária nenhuma ação adicional.
  • Se os valores estiverem divergentes, o banco de dados não atende aos requisitos técnicos para atualização do CIGAM11.
⚠️ Importante:
Os parâmetros NLS_CHARACTERSET e NLS_NCHAR_CHARACTERSET só podem ser definidos no momento da criação do database e não podem ser alterados posteriormente em um banco já em produção.

Correção da Divergência

Quando os valores são divergentes do esperado:

1. Será necessário recriar o database Oracle, pois não existe método suportado para alterar esses parâmetros em um banco existente.
2. Utilize o Database Configuration Assistant (DBCA) para criar o novo database.
3. Durante a criação, defina corretamente os valores de Character Set conforme o padrão requerido.
📌 Na tela do DBCA onde se configura o Character Set, selecione:
  • NLS_CHARACTERSET: AL16UTF16
  • NLS_NCHAR_CHARACTERSET: WE8MSWIN1252
  A recriação do database pode impactar todos os schemas existentes. Planeje adequadamente antes de prosseguir.

Observações Importantes

  • Caso os ambientes de produção e homologação estejam no mesmo database, ambos precisarão ser migrados juntos para atender aos requisitos de Character Set.
  • Garanta backup completo antes de qualquer procedimento de recriação ou migração.
  • Após a criação do novo database, valide novamente os parâmetros antes de dar continuidade ao processo de atualização do CIGAM.
Disponível em "https://www.cigam.com.br/wiki/index.php?title=GE_-_Como_Fazer_-_Verificação_de_Character_Set_do_Oracle_para_Atualização_do_CIGAM11&oldid=154172"