Parâmetros de Inicialização

O parâmetro CLIENT_PREFETCH_ROWS pode ser definido com ALTER SESSION ou ALTER SYSTEM. Se o valor do parâmetro for alterado usando ALTER SESSION, o novo valor se tornará efetivo para essa sessão específica nas extrações subsequentes do conjunto de resultados. Se o valor do parâmetro for alterado usando ALTER SYSTEM, o novo valor entrará em vigor para as instruções executadas nas conexões criadas após o comando ALTER SYSTEM.

Por exemplo, se CLIENT_PREFETCH_ROWS for definido como 100 e um aplicativo cliente solicitar a extração de 10 linhas, um total de 110 linhas será retornado ao driver do cliente. As primeiras 10 linhas das 110 linhas são fornecidas ao aplicativo e o driver do cliente armazena internamente as 100 linhas restantes. As próximas 10 linhas extraídas do aplicativo cliente, cada uma com 10 linhas por iteração de extração, podem ser preenchidas a partir das 100 linhas que são armazenadas internamente no buffer pelo driver cliente. Esse processo reduz o número de roundtrips de rede necessários de/para o banco de dados. Neste exemplo, na 11ª busca, uma nova viagem de ida e volta de rede é incorrida e o banco de dados retorna o próximo lote de 110 linhas, desde que o conjunto de resultados não esteja esgotado e o ciclo se repita.

Observações para definir CLIENT_PREFETCH_ROWS:

• Quando CLIENT_PREFETCH_ROWS é definido como um valor diferente de zero, seu valor tem precedência sobre o valor OCI_ATTR_PREFETCH_ROWS padrão para a contagem de linhas de pré-busca.

• Se o valor OCI_ATTR_PREFETCH_ROWS for definido como um valor não padrão, o valor CLIENT_PREFETCH_ROWS será ignorado para a contagem de linhas de pré-busca.

• Usando CLIENT_PREFETCH_ROWS com OCIAttrSet():

  OCI_ATTR_PREFETCH_ROWS define o número de linhas de nível superior a serem pré-extraídas. O valor padrão é 1 linha. " No entanto, se CLIENT_PREFETCH_ROWS for definido, o número de linhas de nível superior a serem pré-extraídas será determinado pela seguinte precedência:

  1. Se você definir o atributo OCI_ATTR_PREFETCH_ROWS usando a função OCIAttrSet() ou oraaccess.xml como o valor '1', o valor do parâmetro de inicialização do banco de dados CLIENT_PREFETCH_ROWS terá precedência e determinará o número de linhas de nível superior a serem pré-extraídas.

  2. Se você definir o atributo OCI_ATTR_PREFETCH_ROWS usando a função OCIAttrSet() ou oraaccess.xml como o valor 'x' diferente de 1, o número 'x' de linhas de nível superior será pré-extraído e o parâmetro de inicialização do banco de dados CLIENT_PREFETCH_ROWS será ignorado.

  3. Se você não definir um valor OCI_ATTR_PREFETCH_ROWS usando OCIAttrSet() ou oraaccess.xml, o valor do parâmetro de inicialização do banco de dados CLIENT_PREFETCH_ROWS terá precedência e determinará o número de linhas de nível superior a serem pré-extraídas.

• Usando CLIENT_PREFETCH_ROWS com OCIAttrGet():

  A função OCIAttrGet() retorna o valor da linha de pré-busca efetiva definido de OCI_ATTR_PREFETCH_ROWS, oraaccess.xml e o parâmetro de inicialização do banco de dados CLIENT_PREFETCH_ROWS. Se o valor OCI_ATTR_PREFETCH_MEMORY for definido, o valor retornado por OCIAttrGet() pode não ser o valor final das linhas de pré-busca e pode ser restrito ao número máximo de linhas permitidas pelo valor de memória especificado pelo atributo OCI_ATTR_PREFETCH_MEMORY.

Os valores padrão e máximo para JOB_QUEUE_PROCESSES diferem dependendo do modelo de computação que você usa. Consulte Modelos de Computação no Autonomous Database para obter mais informações.

O coordenador de cargos e os colaboradores de cargos do Oracle Scheduler são controlados pelo parâmetro JOB_QUEUE_PROCESSES. O número real de jobs workers criados para jobs do Oracle Scheduler é ajustado automaticamente pelo Scheduler, dependendo de vários fatores, incluindo recursos disponíveis, definições do Resource Manager e jobs em execução no momento.

O valor padrão para JOB_QUEUE_PROCESSES fornece um comprometimento entre a qualidade do serviço para aplicativos e o uso razoável dos recursos do sistema. No entanto, é possível que o valor padrão não atenda a todos os ambientes.

A definição do valor de JOB_QUEUE_PROCESSES como 0 desativa jobs do Scheduler não fornecidos pela Oracle. Quando JOB_QUEUE_PROCESSES é definido como 0, isso não desativa nenhum job interno para usuários fornecidos pela Oracle (os jobs relacionados ao serviço executados pelos usuários fornecidos pela Oracle continuam a ser programados).

Os usuários fornecidos pela Oracle são usuários marcados como ORACLE_MAINTAINED com o valor Y. Usuários não fornecidos pela Oracle são usuários marcados como ORACLE_MAINTAINED com o valor N.

Consulte ALL_USERS para saber mais.

O Autonomous Database usa perfis de bloqueio para restringir determinadas funcionalidades e recursos do banco de dados. Por padrão, o banco de dados gera um erro sempre que você tenta executar um comando SQL que é restrito pelo perfil de bloqueio do Autonomous Database. O parâmetro LOCKDOWN_ERRORS permite suprimir erros de perfil de bloqueio. Além disso, quando LOCKDOWN_ERRORS é definido como o valor IGNORE, ao ignorar um erro, o banco de dados registra os detalhes relacionados à instrução SQL, ao usuário e ao timestamp do comando.

Você pode usar a visualização DBA_LOCKDOWN_ERRORS para obter informações sobre erros de perfil de bloqueio. Consulte Exibição de Erros de Bloqueio para obter mais informações.

SESSION_EXIT_ON_PACKAGE_STATE_ERROR especifica o tratamento de um pacote PL/SQL com monitoramento de estado em execução em uma sessão. Quando tal pacote sofre modificação, como durante a manutenção planejada para objetos fornecidos pelo Oracle, as sessões que têm uma instanciação ativa do pacote recebem o seguinte erro quando tentam executar o pacote:

ORA-4068 existing state of package has been discarded

No entanto, o código do aplicativo que recebe o erro ORA-4068 pode não estar equipado para tratar esse erro com sua lógica de repetição.

A definição de SESSION_EXIT_ON_PACKAGE_STATE_ERROR como TRUE fornece um tratamento diferente para esse caso. Quando SESSION_EXIT_ON_PACKAGE_STATE_ERROR for TRUE, em vez de apenas gerar o erro ORA-4068 quando o estado do pacote for descartado, a sessão será encerrada imediatamente. Isso pode ser vantajoso porque muitos aplicativos são capazes de lidar com o encerramento da sessão, restabelecendo a conexão de forma automática e transparente.

Valores

• ENFORCED: Independentemente da definição de RESULT_CACHE_MODE ou de dicas especificadas, somente construções determinísticas são elegíveis para armazenamento em cache de resultados. Por exemplo, as consultas que usam funções PL/SQL que não são declaradas como determinísticas nunca são armazenadas em cache (a menos que as funções sejam declaradas como determinísticas, os resultados da consulta com essas funções não serão armazenados em cache).

• TRUSTED: O banco de dados respeita a definição de RESULT_CACHE_MODE e as dicas especificadas e considerará consultas usando construções possivelmente não determinísticas como candidatas ao armazenamento em cache de resultados. Por exemplo, as consultas que usam funções PL/SQL que não são declaradas como determinísticas podem ser armazenadas em cache. Observe, no entanto, que os resultados que são conhecidos como não determinísticos não são armazenados em cache (por exemplo, SYSDATE ou construções envolvendo SYSDATE).

Consulte RESULT_CACHE_MODE para obter mais informações.

Fuso Horário Padrão do Autonomous Database

O fuso horário padrão do Autonomous Database é UTC (Coordinated Universal Time ) e, por padrão, as chamadas para SYSDATE e SYSTIMESTAMP retornam a data e a hora em UTC.

Para alterar o fuso horário do banco de dados, você pode executar a instrução a seguir.

Este exemplo define o fuso horário do banco de dados como UTC-5.

ALTER DATABASE SET TIME_ZONE='-05:00';

Este exemplo define o fuso horário do banco de dados para a costa leste dos EUA: America/New_York e o horário é ajustado automaticamente nos switches de horário de verão:

ALTER DATABASE SET TIME_ZONE='America/New_York';

Depois de definir o fuso horário do banco de dados, por padrão, SYSDATE e SYSTIMESTAMP continuam retornando a data e a hora no UTC (SYSDATE_AT_DBTIMEZONE é FALSE por padrão). Se você definir SYSDATE_AT_DBTIMEZONE como TRUE em uma sessão, SYSDATE e SYSTIMESTAMP retornarão o fuso horário do banco de dados.

Consulte Definindo o Fuso Horário do Banco de Dados em Oracle Database 19c ou Oracle Database 23ai para obter mais informações sobre como usar a cláusula SET TIME_ZONE com ALTER DATABASE.

Usando SYSDATE_AT_DBTIMEZONE em uma Sessão

Quando SYSDATE_AT_DBTIMEZONE é FALSE em uma sessão, as chamadas para SYSDATE e SYSTIMESTAMP retornam valores com base no fuso horário padrão do Autonomous Database, UTC (Coordinated Universal Time).

Quando SYSDATE_AT_DBTIMEZONE é TRUE em uma sessão, as chamadas para SYSDATE ou SYSTIMESTAMP retornam a data e a hora com base no fuso horário do banco de dados.

Exemplo

O exemplo a seguir retorna datas e horas para dois fusos horários diferentes, com base no valor do parâmetro SYSDATE_AT_DBTIMEZONE:

SQL> SELECT DBTIMEZONE FROM DUAL;

DBTIMEZONE
_____________
-05:00

SQL> ALTER SESSION SET SYSDATE_AT_DBTIMEZONE=FALSE;

Session altered.

SQL> SELECT SYSTIMESTAMP FROM DUAL;

SYSTIMESTAMP
______________________________________
27-JAN-22 06.59.45.708082000 PM GMT

SQL> ALTER SESSION SET SYSDATE_AT_DBTIMEZONE=TRUE;

Session altered.

SQL> SELECT SYSTIMESTAMP FROM DUAL;

SYSTIMESTAMP
_________________________________________
27-JAN-22 02.14.47.578946000 PM -05:00 

SQL> SELECT TO_CHAR(SYSTIMESTAMP,'YYYY-MM-DD"T"HH24:MI:SS TZH":"TZM') FROM DUAL;

TO_CHAR(SYSTIMESTAMP,'YYYY-MM-DD"T"HH24:MI:SSTZH":"TZM')
___________________________________________________________
2022-01-27T14:15:00 -05:00