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 esse pacote passa por modificação, como durante a manutenção planejada dos objetos fornecidos pela Oracle, as sessões que têm uma instância 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 outro tratamento para esse caso. Quando SESSION_EXIT_ON_PACKAGE_STATE_ERROR é TRUE, em vez de apenas gerar o erro ORA-4068 quando o estado do pacote é descartado, a sessão é encerrada imediatamente. Isso pode ser vantajoso porque muitos aplicativos são capazes de tratar o encerramento da sessão restabelecendo a conexão de forma automática e transparente.

Fuso Horário Padrão do Autonomous Database

O fuso horário padrão do Autonomous Database é o Horário Universal Coordenado (UTC) 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 a hora é ajustada automaticamente nos switches de horário de verão:

ALTER DATABASE SET TIME_ZONE='America/New_York';

Após a definição do fuso horário do banco de dados, por padrão, SYSDATE e SYSTIMESTAMP retornam a data e 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 no Oracle Database 19c ou no 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, Horário Universal Coordenado (UTC).

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

Exemplo

O seguinte exemplo 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

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 em extrações subsequentes do conjunto de resultados. Se o valor do parâmetro for alterado usando ALTER SYSTEM, o novo valor terá efeito 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 dadas ao aplicativo, e o driver do cliente armazena internamente as 100 linhas restantes. As próximas 10 extrações de linha 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 do cliente. Esse processo reduz o número de roundtrips de rede necessários de/para o banco de dados. Neste exemplo, na 11a extração, uma nova rota 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é-buscidas. 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é-buscidas 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é-buscidas.

  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 de linhas de nível superior 'x' será pré-buscado 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é-buscidas.

• 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() poderá não ser o valor final das linhas de pré-busca e poderá ser restrito ao número máximo de linhas permitido 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 tarefas e os colaboradores de tarefas do Oracle Scheduler são controlados pelo parâmetro JOB_QUEUE_PROCESSES. O número real de colaboradores do cargo 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 compromisso 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 por 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. Os usuários não fornecidos pela Oracle são usuários marcados como ORACLE_MAINTAINED com o valor N.

Consulte ALL_USERS para obter mais informações.

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 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 com o valor IGNORE, ao ignorar um erro, o banco de dados registra os detalhes sobre a instrução SQL, o usuário e o 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.

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, 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 cache de resultados. Por exemplo, 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 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.