Paramètres d'initialisation

Le paramètre CLIENT_PREFETCH_ROWS peut être défini avec ALTER SESSION ou ALTER SYSTEM. Si la valeur du paramètre change à l'aide de ALTER SESSION, la nouvelle valeur prend effet pour cette session spécifique lors des extractions suivantes de l'ensemble de résultats. Si la valeur du paramètre change à l'aide de ALTER SYSTEM, la nouvelle valeur prend effet pour les instructions exécutées sur les connexions créées après la commande ALTER SYSTEM.

Par exemple, si CLIENT_PREFETCH_ROWS est défini sur 100 et qu'une application client demande d'extraire 10 lignes, un total de 110 lignes est renvoyé au pilote client. Les 10 premières lignes sur les 110 sont attribuées à l'application, et le pilote client met en mémoire tampon les 100 lignes restantes en interne. Les 10 prochaines extractions de ligne à partir de l'application client, chacune avec 10 lignes par itération d'extraction, peuvent être exécutées à partir des 100 lignes mises en mémoire tampon en interne par le pilote client. Ce processus réduit le nombre d'allers-retours réseau requis vers et depuis la base de données. Dans cet exemple, lors de la 11e extraction, un nouvel aller-retour réseau est engagé et la base de données renvoie le lot suivant de 110 lignes, tant que l'ensemble de résultats n'est pas épuisé et que le cycle se répète.

Remarques concernant la définition de CLIENT_PREFETCH_ROWS :

• Lorsque la valeur CLIENT_PREFETCH_ROWS est définie sur une valeur différente de zéro, sa valeur est prioritaire sur la valeur OCI_ATTR_PREFETCH_ROWS par défaut pour le nombre de lignes de pré-extraction.

• Si la valeur OCI_ATTR_PREFETCH_ROWS est définie sur une valeur autre que celle par défaut, la valeur CLIENT_PREFETCH_ROWS est ignorée pour le nombre de lignes de pré-extraction.

• En utilisant CLIENT_PREFETCH_ROWS avec OCIAttrSet() :

  OCI_ATTR_PREFETCH_ROWS définit le nombre de lignes de niveau supérieur à préextraire. La valeur par défaut est 1 ligne. Toutefois, si CLIENT_PREFETCH_ROWS est défini, le nombre de lignes de niveau supérieur à préextraire est déterminé par la priorité suivante :

  1. Si vous définissez l'attribut OCI_ATTR_PREFETCH_ROWS à l'aide de la fonction OCIAttrSet() ou de oraaccess.xml en tant que valeur '1', la valeur du paramètre d'initialisation de base de données CLIENT_PREFETCH_ROWS est prioritaire et détermine le nombre de lignes de niveau supérieur à préextraire.

  2. Si vous définissez l'attribut OCI_ATTR_PREFETCH_ROWS à l'aide de la fonction OCIAttrSet() ou de oraaccess.xml en tant que valeur 'x' autre que 1, le nombre de lignes de niveau supérieur 'x' est pré-extrait et le paramètre d'initialisation de base de données CLIENT_PREFETCH_ROWS est ignoré.

  3. Si vous ne définissez pas de valeur OCI_ATTR_PREFETCH_ROWS à l'aide de OCIAttrSet() ou oraaccess.xml, la valeur du paramètre d'initialisation de base de données CLIENT_PREFETCH_ROWS est prioritaire et détermine le nombre de lignes de niveau supérieur à préextraire.

• En utilisant CLIENT_PREFETCH_ROWS avec OCIAttrGet() :

  La fonction OCIAttrGet() renvoie la valeur de ligne de pré-extraction effective définie à partir de OCI_ATTR_PREFETCH_ROWS, oraaccess.xml et du paramètre d'initialisation de base de données CLIENT_PREFETCH_ROWS. Si la valeur OCI_ATTR_PREFETCH_MEMORY est définie, la valeur renvoyée par OCIAttrGet() peut ne pas être la valeur finale des lignes de pré-extraction et peut être limitée au nombre maximal de lignes autorisé par la valeur de mémoire indiquée par l'attribut OCI_ATTR_PREFETCH_MEMORY.

Les valeurs par défaut et maximales pour JOB_QUEUE_PROCESSES diffèrent en fonction du modèle de calcul que vous utilisez. Pour plus d'informations, reportez-vous à Modèles de calcul dans Autonomous Database.

Le coordinateur de travaux et les processus actifs de travail Oracle Scheduler sont contrôlés par le paramètre JOB_QUEUE_PROCESSES. Le planificateur règle automatiquement le nombre réel de processus actifs créés pour les travaux Oracle Scheduler en fonction de plusieurs facteurs, notamment les ressources disponibles, les paramètres Resource Manager et les travaux en cours d'exécution.

La valeur par défaut de JOB_QUEUE_PROCESSES offre un compromis entre la qualité de service des applications et une utilisation raisonnable des ressources système. Cependant, il est possible que la valeur par défaut ne corresponde pas à tous les environnements.

La définition de la valeur JOB_QUEUE_PROCESSES sur 0 désactive les travaux du planificateur non fournis par Oracle. Lorsque JOB_QUEUE_PROCESSES est défini sur 0, cela ne désactive aucun travail interne pour les utilisateurs fournis par Oracle (les travaux liés aux services exécutés par les utilisateurs fournis par Oracle continuent d'être programmés).

Les utilisateurs fournis par Oracle sont des utilisateurs marqués comme ORACLE_MAINTAINED avec la valeur Y. Les utilisateurs non fournis par Oracle sont des utilisateurs marqués comme ORACLE_MAINTAINED avec la valeur N.

Pour plus d'informations, reportez-vous à ALL_USERS.

Autonomous Database utilise des profils de verrouillage pour restreindre certaines fonctionnalités et fonctionnalités de base de données. Par défaut, la base de données génère une erreur chaque fois que vous tentez d'exécuter une commande SQL restreinte par le profil de verrouillage Autonomous Database. Le paramètre LOCKDOWN_ERRORS vous permet de supprimer les erreurs de profil de verrouillage. En outre, lorsque LOCKDOWN_ERRORS est défini sur la valeur IGNORE, lorsqu'une erreur est ignorée, la base de données consigne les détails concernant l'instruction SQL, l'utilisateur et l'horodatage de la commande.

Vous pouvez utiliser la vue DBA_LOCKDOWN_ERRORS pour obtenir des informations sur les erreurs de profil de verrouillage. Pour plus d'informations, reportez-vous à Vue Erreurs de verrouillage.

SESSION_EXIT_ON_PACKAGE_STATE_ERROR indique la gestion d'un package PL/SQL avec conservation de statut exécuté dans une session. Lorsqu'un tel package est modifié, par exemple lors d'une maintenance planifiée pour les objets fournis par Oracle, les sessions qui ont une instanciation active du package reçoivent l'erreur suivante lorsqu'elles tentent d'exécuter le package :

ORA-4068 existing state of package has been discarded

Toutefois, le code d'application qui reçoit l'erreur ORA-4068 peut ne pas être équipé pour gérer cette erreur avec sa logique de nouvelle tentative.

La définition de SESSION_EXIT_ON_PACKAGE_STATE_ERROR sur TRUE offre un traitement différent pour ce cas. Lorsque SESSION_EXIT_ON_PACKAGE_STATE_ERROR est défini sur TRUE, au lieu de générer simplement l'erreur ORA-4068 lorsque l'état du package est supprimé, la session se ferme immédiatement. Cela peut être avantageux car de nombreuses applications sont en mesure de gérer la terminaison de session en rétablissant automatiquement et de manière transparente la connexion.

Valeurs

• ENFORCED : quel que soit le paramètre de RESULT_CACHE_MODE ou les conseils indiqués, seules les structures déterministes peuvent être mises en cache des résultats. Par exemple, les requêtes utilisant des fonctions PL/SQL qui ne sont pas déclarées comme déterministes ne sont jamais mises en cache (sauf si les fonctions sont déclarées comme déterministes, les résultats de requête avec ces fonctions ne seront pas mis en cache).

• TRUSTED : la base de données respecte le paramètre RESULT_CACHE_MODE et les conseils indiqués, et considère les requêtes utilisant éventuellement des constructions non déterministes comme candidats à la mise en cache des résultats. Par exemple, les requêtes utilisant des fonctions PL/SQL qui ne sont pas déclarées comme déterministes peuvent être mises en cache. Notez toutefois que les résultats connus pour être non déterministes ne sont pas mis en cache (par exemple, SYSDATE ou les constructions impliquant SYSDATE).

Pour plus d'informations, reportez-vous à RESULT_CACHE_MODE.

Fuseau horaire par défaut d'Autonomous Database

Le fuseau horaire Autonomous Database par défaut est Temps universel coordonné (UTC) et, par défaut, les appels vers SYSDATE et SYSTIMESTAMP renvoient la date et l'heure au format UTC.

Pour modifier le fuseau horaire de la base de données, vous pouvez exécuter l'instruction suivante.

Cet exemple définit le fuseau horaire de la base de données sur UTC-5.

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

Cet exemple définit le fuseau horaire de la base de données pour la côte est des Etats-Unis : America/New_York et l'heure est automatiquement ajustée aux commutateurs d'heure d'été :

ALTER DATABASE SET TIME_ZONE='America/New_York';

Une fois que vous avez défini le fuseau horaire de la base de données, par défaut, SYSDATE et SYSTIMESTAMP continuent à renvoyer la date et l'heure au format UTC (SYSDATE_AT_DBTIMEZONE est FALSE par défaut). Si vous définissez SYSDATE_AT_DBTIMEZONE sur TRUE dans une session, SYSDATE et SYSTIMESTAMP renvoient le fuseau horaire de la base de données.

Pour plus d'informations sur l'utilisation de la clause SET TIME_ZONE avec ALTER DATABASE, reportez-vous à Définition du fuseau horaire de la base de données dans Oracle Database 19c ou Oracle Database 23ai.

Utilisation de SYSDATE_AT_DBTIMEZONE dans une session

Lorsque SYSDATE_AT_DBTIMEZONE est défini sur FALSE dans une session, les appels vers SYSDATE et SYSTIMESTAMP renvoient des valeurs en fonction du fuseau horaire Autonomous Database par défaut, Temps universel coordonné (UTC).

Lorsque SYSDATE_AT_DBTIMEZONE est défini sur TRUE dans une session, les appels vers SYSDATE ou SYSTIMESTAMP renvoient la date et l'heure en fonction du fuseau horaire de la base de données.

Exemple

L'exemple suivant renvoie des dates et des heures pour deux fuseaux horaires différents, en fonction de la valeur du paramètre 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