初期化パラメータ

Autonomous AI Databaseは、データベースをプロビジョニングするときにデータベース初期化パラメータを自動的に構成します。サービスの使用を開始するために初期化パラメータを設定する必要はありません。ただし、必要に応じて一部のパラメータを変更できます。

変更可能な初期化パラメータ

次の表に、ALTER SESSIONでのみ変更可能な初期化パラメータを示します。

次の表に、ALTER SYSTEMでのみ変更可能な初期化パラメータを示します。

次の表に、ALTER SESSIONまたはALTER SYSTEMで変更可能な初期化パラメータを示します。

初期化パラメータの詳細は、『Oracle AI Databaseリファレンス』に関する項を参照してください。

CLIENT_PREFETCH_ROWS

CLIENT_PREFETCH_ROWSパラメータを設定して、クライアントが問合せ結果セットの行のフェッチ中に必要なラウンドトリップ数を削減できるようにします。

CLIENT_PREFETCH_ROWSは、クライアント・アプリケーションを変更せずに、Oracleクライアント・ドライバによってプリフェッチされる行数を指定します。クライアント・ドライバは、問合せが成功するたびに、およびデータベースに送信された後続のフェッチ・リクエストごとに、プリフェッチされた行をバッファリングします。

このパラメータは、Oracle Call Interface (OCI)を使用してデータベースに接続するクライアントにのみ適用されます。

このパラメータは、すべてのプラットフォームについて、Oracle Instant Client/Oracle Database Client 19.17 (以降)および21.8 (以降)でのみ適用されます。

CLIENT_PREFETCH_ROWSパラメータは、ALTER SESSIONまたはALTER SYSTEMで設定できます。ALTER SESSIONを使用してパラメータ値が変更された場合、新しい値は、後続の結果セット・フェッチでその特定のセッションに対して有効になります。ALTER SYSTEMを使用してパラメータ値が変更された場合、新しい値は、ALTER SYSTEMコマンドの後に作成された接続で実行される文に対して有効になります。

たとえば、CLIENT_PREFETCH_ROWSが100に設定され、クライアント・アプリケーションが10行のフェッチを要求した場合、合計110行がクライアント・ドライバに返されます。110行中の最初の10行がアプリケーションに与えられ、クライアント・ドライバは残りの100行を内部的にバッファリングします。クライアント・アプリケーションからの次の10行のフェッチは、フェッチの反復ごとに10行ずつ、クライアント・ドライバによって内部的にバッファリングされる100行から実行できます。このプロセスにより、データベースとの間で必要なネットワーク・ラウンドトリップの数が減少します。この例では、11回目のフェッチで、新しいネットワーク・ラウンドトリップが発生し、結果セットが使い果たされず、サイクルが繰り返されるかぎり、データベースは110行の次のバッチを返します。

CLIENT_PREFETCH_ROWSの設定に関するノート:

• CLIENT_PREFETCH_ROWSがゼロ以外の値に設定されている場合、その値はプリフェッチ行数のデフォルトのOCI_ATTR_PREFETCH_ROWS値よりも優先されます。

• OCI_ATTR_PREFETCH_ROWS値がデフォルト以外の値に設定されている場合、プリフェッチ行数のCLIENT_PREFETCH_ROWS値は無視されます。

• OCIAttrSet()でのCLIENT_PREFETCH_ROWSの使用:

  OCI_ATTR_PREFETCH_ROWSは、プリフェッチするトップレベル行数を設定します。デフォルト値は1行です。ただし、CLIENT_PREFETCH_ROWSが設定されている場合、プリフェッチされる最上位行の数は、次の優先順位によって決まります。

  1. OCIAttrSet()ファンクションまたはoraaccess.xmlを値'1'として使用してOCI_ATTR_PREFETCH_ROWS属性を設定すると、データベース初期化パラメータのCLIENT_PREFETCH_ROWS値が優先され、プリフェッチされる最上位行の数が決定されます。

  2. OCIAttrSet()関数またはoraaccess.xmlを1以外の値'x'として使用してOCI_ATTR_PREFETCH_ROWS属性を設定すると、最上位行数の'x'がプリフェッチされ、データベース初期化パラメータCLIENT_PREFETCH_ROWSは無視されます。

  3. OCIAttrSet()またはoraaccess.xmlを使用してOCI_ATTR_PREFETCH_ROWS値を設定しない場合、データベース初期化パラメータのCLIENT_PREFETCH_ROWS値が優先され、プリフェッチされる最上位レベルの行数が決定されます。

• OCIAttrGet()でのCLIENT_PREFETCH_ROWSの使用:

  関数OCIAttrGet()は、OCI_ATTR_PREFETCH_ROWS、oraaccess.xmlおよびデータベース初期化パラメータCLIENT_PREFETCH_ROWSから設定された有効なプリフェッチ行値を戻します。OCI_ATTR_PREFETCH_MEMORY値が設定されている場合、OCIAttrGet()によって戻される値は、最終的なプリフェッチ行の値ではなく、OCI_ATTR_PREFETCH_MEMORY属性で指定されたメモリー値で許可される最大行数に制限されることがあります。

  ノート
  
  

  関連情報:

  • 結果のフェッチおよびプリフェッチ数の設定の詳細は、『Oracle Call Interface開発者ガイド』を参照してください。
  • OCIAttrSet()
  • OCI_ATTR_PREFETCH_ROWS

CLOUD_TABLE_COMMIT_THRESHOLD

CLOUD_TABLE_COMMIT_THRESHOLDパラメータは、変更がオブジェクト・ストレージに書き込まれる前に、クラウド表のバッファ済変更数を制御します。

CLOUD_TABLE_COMMIT_THRESHOLDパラメータが0以外の値に設定されている場合、値は変更数のしきい値として処理され、変更数が指定されたしきい値に達するまでクラウド表の変更がバッファされます。しきい値に達すると、バッファ済の変更がオブジェクト・ストレージにエクスポートされます。このパラメータのデフォルト値は0です(バッファリングは無効)。

詳細は、クラウド表についてを参照してください。

ノート

ノート:このパラメータは、すべてのクラウド表に適用され、ALTER SESSION権限を持つすべてのユーザーが設定できます。したがって、クラウド表は、コミットされた変更が永続的で、同時リーダーからすぐに参照できる必要があるセキュリティ・クリティカルなデータには適していません。このため、クラウド表は監査ログ表などのユース・ケースに適さない場合があります。

JOB_QUEUE_PROCESSES

JOB_QUEUE_PROCESSESパラメータを設定して、Oracle Scheduler (DBMS_SCHEDULER)ジョブを実行するために作成できるジョブ・ワーカーの最大数を指定します。

値を0に設定すると、Oracle提供以外のスケジューラ・ジョブが無効になります。

JOB_QUEUE_PROCESSESのデフォルト値と最大値は、使用するコンピュート・モデルによって異なります。詳細は、Autonomous AI Databaseのコンピュート・モデルを参照してください。

Oracle Schedulerのジョブ・コーディネータおよびジョブ・ワーカーは、JOB_QUEUE_PROCESSESパラメータによって制御されます。Oracle Schedulerジョブ用に作成されるジョブ・ワーカーの数は、使用可能なリソース、リソース・マネージャ設定、現在実行中のジョブなどの複数のファクタに応じて、スケジューラにより自動チューニングされます。

JOB_QUEUE_PROCESSESのデフォルト値では、アプリケーションのサービス品質とシステム・リソースの適切な使用の両立を図っています。ただし、すべての環境にデフォルト値が適合するとはかぎりません。

JOB_QUEUE_PROCESSESの値を0に設定すると、Oracle提供以外のスケジューラ・ジョブが無効になります。JOB_QUEUE_PROCESSESが0に設定されている場合、これはOracle提供ユーザーの内部ジョブを無効化しません(Oracle提供ユーザーが実行するサービス関連ジョブは引き続きスケジュールされます)。

Oracle提供のユーザーは、値がYのORACLE_MAINTAINEDとしてマークされたユーザーです。Oracle提供以外のユーザーは、値がNのORACLE_MAINTAINEDとしてマークされたユーザーです。

詳細は、ALL_USERSを参照してください。

LOCKDOWN_ERRORS

Autonomous AI Databaseのロックダウン・プロファイル・エラーが発生するか無視するかを制御するには、LOCKDOWN_ERRORSパラメータを設定します。

Autonomous AI Databaseは、ロックダウン・プロファイルを使用して、特定のデータベースの機能と機能を制限します。デフォルトでは、Autonomous AI Databaseロックダウン・プロファイルによって制限されているSQLコマンドを実行しようとすると、データベースによってエラーが発生します。LOCKDOWN_ERRORSパラメータを使用すると、ロックダウン・プロファイル・エラーを抑制できます。また、LOCKDOWN_ERRORSが値IGNOREに設定されている場合、エラーを無視すると、SQL文、ユーザーおよびコマンドのタイムスタンプに関する詳細が記録されます。

ノート

ノート:このパラメータの値をIGNOREに設定する前に、既存のスクリプトを慎重に評価してください。値をIGNOREに設定すると、使用する既存のスクリプトによってロックダウン・エラーが発生しなくなります。

DBA_LOCKDOWN_ERRORSビューを使用して、ロックダウン・プロファイル・エラーに関する情報を取得できます。詳細は、ロックダウン・エラー・ビューを参照してください。

SESSION_EXIT_ON_PACKAGE_STATE_ERROR

SESSION_EXIT_ON_PACKAGE_STATE_ERRORは、セッションで実行されているステートフルPL/SQLパッケージの特別な処理を有効または無効にします。

SESSION_EXIT_ON_PACKAGE_STATE_ERRORは、セッションで実行されているステートフルPL/SQLパッケージの処理を指定します。Oracle提供オブジェクトの計画メンテナンス中など、そのようなパッケージが変更されると、そのパッケージの実行が試みられると、そのパッケージをアクティブなインスタンス化しているセッションは次のエラーを受け取ります。

ORA-4068 existing state of package has been discarded

ただし、ORA-4068エラーを受信するアプリケーション・コードでは、このエラーを再試行ロジックで処理できない場合があります。

SESSION_EXIT_ON_PACKAGE_STATE_ERRORをTRUEに設定すると、この場合に異なる処理が行われます。SESSION_EXIT_ON_PACKAGE_STATE_ERRORがTRUEの場合、パッケージ状態が破棄されたときにORA-4068エラーが発生するのみでなく、セッションはただちに終了します。接続を自動的に透過的に再確立することで、多くのアプリケーションでセッション終了を処理できるため、これは有利です。

RESULT_CACHE_INTEGRITY

RESULT_CACHE_INTEGRITYパラメータを設定して、結果キャッシュが結果キャッシュの候補として非決定的な構造を使用する可能性のある問合せを考慮するかどうかを指定します。

値

• ENFORCED: RESULT_CACHE_MODEまたは指定されたヒントの設定に関係なく、確定的構成のみが結果キャッシュの対象となります。たとえば、決定論として宣言されていないPL/SQLファンクションを使用する問合せがキャッシュされることはありません(ファンクションが決定論的として宣言されないかぎり、そのようなファンクションを使用する問合せ結果はキャッシュされません)。

• TRUSTED: データベースは、RESULT_CACHE_MODEおよび指定されたヒントの設定を考慮し、結果キャッシュの候補として決定論的でない可能性のある構造を使用した問合せを考慮します。たとえば、確定的として宣言されていないPL/SQLファンクションを使用する問合せはキャッシュできます。ただし、非決定的であることがわかっている結果はキャッシュされません(たとえば、SYSDATEまたはSYSDATEを含む構成)。

RESULT_CACHE_MODE

RESULT_CACHE_MODEパラメータを設定して、結果キャッシュに結果セットを格納する対象となる問合せを指定してください。結果キャッシュ演算子が指定されている問合せ計画のみが、結果キャッシュに対する読取りまたは書込みを試行します。

詳細は、RESULT_CACHE_MODEを参照してください。

SQL結果キャッシュ・ヒントの使用

アプリケーション・レベルで結果キャッシュ・ヒントを使用して、キャッシュの動作を制御します。SQL結果キャッシュ・ヒントは、結果キャッシュ・モードおよび結果キャッシュ表注釈よりも優先されます。

SQL結果キャッシュ・ヒントは次の方法で使用できます。

• RESULT_CACHEヒントの使用

• NO_RESULT_CACHEヒントの使用

• ビューでのRESULT_CACHEヒントの使用

RESULT_CACHEヒントの使用

結果キャッシュ・モードがMANUALの場合、/*+ RESULT_CACHE */ヒントは、問合せブロックの結果をキャッシュに格納し、キャッシュされた結果を今後の実行で使用するようデータベースに指示します。

詳細は、RESULT_CACHEヒントの使用およびRESULT_CACHEヒントを参照してください。

NO_RESULT_CACHEヒントの使用

/*+ NO_RESULT_CACHE */ヒントは、データベースがサーバーまたはクライアントの結果キャッシュに結果をキャッシュしないように指示します。

詳細は、「NO_RESULT_CACHEヒントの使用」および「RESULT_CACHEヒント」を参照してください。

ビューでのRESULT_CACHEヒントの使用

RESULT_CACHEヒントは、ヒントが指定された問合せブロックにのみ適用されます。ビューにのみヒントが指定されている場合は、その結果のみがキャッシュされます。

詳細は、ビューでのRESULT_CACHEヒントの使用およびRESULT_CACHEヒントを参照してください。

SYSDATE_AT_DBTIMEZONE Autonomous AI DatabaseでのSYSDATEのタイム・ゾーンの選択

SYSDATE_AT_DBTIMEZONEは、SYSDATEおよびSYSTIMESTAMPへのコールで返される日時値に対する特別な処理を有効にします。

SYSDATE_AT_DBTIMEZONEの値に応じて、デフォルトのAutonomous AI Databaseタイム・ゾーン、協定世界時(UTC)、またはデータベースに設定したタイム・ゾーンに基づく日時が表示されます。

デフォルトのAutonomous AIデータベース・タイム・ゾーン

デフォルトのAutonomous AI Databaseタイム・ゾーンは協定世界時(UTC)であり、デフォルトではSYSDATEおよびSYSTIMESTAMPをコールすると、UTCで日時が返されます。

データベースのタイム・ゾーンを変更するには、次の文を実行します。

この例では、データベースのタイム・ゾーンをUTC-5に設定しています。

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

この例では、米国東海岸のデータベース・タイムゾーン(America/New_York)を設定し、時刻はDSTスイッチで自動的に調整されます。

ALTER DATABASE SET TIME_ZONE='America/New_York';

ノート

ノート:変更を有効にするには、Autonomous AI Databaseインスタンスを再起動する必要があります。

データベースのタイム・ゾーンを設定した後、デフォルトでは、SYSDATEおよびSYSTIMESTAMPは引き続きUTCで日時を返します(デフォルトではSYSDATE_AT_DBTIMEZONEはFALSEです)。セッションでSYSDATE_AT_DBTIMEZONEをTRUEに設定した場合、SYSDATEおよびSYSTIMESTAMPはデータベースのタイムゾーンを返します。

SET TIME_ZONE句をALTER DATABASEとともに使用する方法の詳細は、Oracle Database 19cまたはOracle AI Database 26aiのデータベース・タイムゾーンの設定を参照してください。

セッションでのSYSDATE_AT_DBTIMEZONEの使用

セッションでSYSDATE_AT_DBTIMEZONEがFALSEの場合、デフォルトのAutonomous AI Databaseタイムゾーンである協定世界時(UTC)に基づいて、SYSDATEおよびSYSTIMESTAMPの戻り値をコールします。

セッションでSYSDATE_AT_DBTIMEZONEがTRUEの場合、SYSDATEまたはSYSTIMESTAMPをコールすると、データベースのタイムゾーンに基づいて日時が返されます。

ノート

ノート: SYSDATE_AT_DBTIMEZONEをTRUEに設定すると、SYSDATEおよびSYSTIMESTAMPがアプリケーションSQLの演算子(問合せ、DMLおよびCTAS操作など)として使用される場合にのみ影響します。このパラメータを使用する場合は、クライアント/セッション・タイムゾーンがデータベースのタイムゾーンと一致することをお薦めします。

例

次の例では、SYSDATE_AT_DBTIMEZONEパラメータ値に基づいて、2つの異なるタイム・ゾーンの日時を戻します。

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