1. リファレンス
  2. 組込みプロシージャ
  3. ttDBConfig

ttDBConfig

ttDBConfig組込みプロシージャを使用すると、ユーザーはTimesTenデータベース・システム・パラメータの値を設定または表示できます。

必要な権限

このプロシージャを実行するにはADMIN権限が必要です。

TimesTen ScaleoutおよびTimesTen Classicでの使用

このプロシージャは、TimesTen Classicでサポートされています。

このプロシージャはTimesTen Scaleoutでサポートされますが、コール元の要素でローカルに実行されます。

関連ビュー

このプロシージャには、次の関連ビューがあります。

SYS.GV$DB_CONFIG

SYS.V$DB_CONFIG

構文

ttDBConfig(['param'[,'value']])

パラメータ

ttDBConfigには、次のパラメータがあります。

パラメータ 型 説明

param

VARCHAR2(50)

値を設定するまたは現在の値を確認する対象のシステム・パラメータ。この引数の許容値は次のとおりです。

CacheAgentCommitBufSize

CacheAwtMethod

CacheParAwtBatchSize

DynamicLoadReduceContention

ParReplMaxDrift

PLSQL_OPEN_CURSORS

PLSQL_SESSION_CACHED_CURSORS

RepAgentCommitBufSize

value

VARCHAR2(200)

システム・パラメータの値。

値を指定しない場合、このプロシージャは指定したパラメータの現在の値を返します。

パラメータ/値のペア

次の名前/値のペアが結果セットで返されます。

名前 値 説明

CacheAgentCommitBufSize

MBで表されるサイズ

キャッシュ・エージェントに再利用バッファの最大サイズを指定します。キャッシュ・エージェントは値が変更されたかどうかを定期的に確認します。サイズは一時パーティションのサイズより大きくできません。

詳細は、『Oracle TimesTen In-Memory Databaseキャッシュ・ガイド』の「自動リフレッシュ処理時にメモリーを再利用する際のパフォーマンスの向上」を参照してください。

CacheAwtMethod

0 - SQL配列メソッド

1 - PL/SQL実行メソッド

Oracle Databaseサーバーに変更を適用するためのAWT伝播で、PL/SQLまたはSQL配列メソッドを使用するかどうかを指定します。

ttDBConfigでこのパラメータを設定すると、接続属性値がオーバーライドされます。

デフォルト: 1

詳細は、「CacheAWTMethod」接続属性を参照してください。

CacheParAwtBatchSize

バッチ内の行数

単一のバッチに含まれる行数に対するしきい値を設定します。最大の行数に達すると、TimesTenがトランザクションに残りの行を含めますが(TimesTenはトランザクションを解除しません)、バッチにそれ以上のトランザクションを追加しません。

ノート:

Oracle TimesTenテクニカル・サポートからのアドバイスがないかぎり、このパラメータの値は変更しないでください。

DynamicLoadReduceContention

0 - 無効

1 - 有効

有効の場合、自動リフレッシュ処理と動的ロード処理が連携して動作する方法が変更され、自動リフレッシュ処理と動的ロード処理の間の競合が減少します。

  • 自動リフレッシュ処理によって動的ロード処理がブロックされることはありません(同期処理が強化されるため)。

  • 自動リフレッシュ処理は、動的ロード処理によって完全には遅延しません。

デフォルト: 0

詳細は、『Oracle TimesTen In-Memory Databaseキャッシュ・ガイド』の「増分自動リフレッシュを使用した動的な読取り専用キャッシュ・グループに対する競合の削減」を参照してください。

ParReplMaxDrift

秒数

パラレル・レプリケーションの追跡間で可能なドリフトの秒数を指定します。コミット依存を無効にして自動パラレル・レプリケーションを使用している場合、一部の追跡が他の追跡よりも進んでいることがあります。このしきい値を過ぎると、TimesTenは、すべてのレプリケーション追跡が互いに追いつくように、これらを同期化します。デフォルトでは、これはゼロに設定され、追跡間のドリフトのチェックは無効になっています。

PLSQL_OPEN_CURSORS

PL/SQLカーソルの最大数

1つのセッションで一度にオープンできるPL/SQLカーソルの最大数を指定します。1から65535までの値を指定できます。これはセッションが過剰な数のカーソルをオープンしないようにするために使用します。ttDBConfigでこのパラメータを設定すると、将来の接続のデフォルト値が提供されます。

デフォルト: 50 PL/SQLカーソル。

詳細は、「PLSQL_OPEN_CURSORS」接続属性の説明を参照してください。

PLSQL_SESSION_CACHED_CURSORS

キャッシュするセッション・カーソルの数

キャッシュするセッション・カーソルの数を指定します。ユーザーは、キャッシュ内で現在不要な領域を解放するように設定を調整できます。

PLSQL_SESSION_CACHED_CURSORSは、ALTER SESSION SQL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して変更できます。ttDBConfigでこのパラメータを設定すると、将来の接続のデフォルト値が提供されます。

デフォルト: 50 PL/SQLカーソル。

詳細は、「PLSQL_SESSION_CACHED_CURSORS」接続属性の説明を参照してください。

RepAgentCommitBufSize

MBで表されるサイズ

レプリケーション・エージェントに再利用バッファの最大サイズを指定します。レプリケーション・エージェントは値が変更されたかどうか定期的に確認します。サイズは一時パーティションのサイズより大きくできません。

詳細は、『Oracle TimesTen In-Memory Databaseキャッシュ・ガイド』の「自動リフレッシュ処理時にメモリーを再利用する際のパフォーマンスの向上」を参照してください。

結果セット

ttDBConfigは、次の結果セットを返します。

列 型 説明

param

VARCHAR2(50)

指定するパラメータの名前。

value

VARCHAR2(200)

指定されたパラメータの現在の値。

値を指定した場合は、新しい値となります。

例

CacheParAwtBatchSizeの現在の値を取得するには次のように実行します。 

CALL ttDBConfig('CacheParAwtBatchSize');
<CACHEPARAWTBATCHSIZE, 125>
1 row found.

RepAgentCommitBufSizeの値を50MBに設定するには、次のように実行します。 

CALL ttDBConfig('RepAgentCommitBufSize', '50');
 <REPAGENTCOMMITBUFSIZE, 50>
 1 row found.

CacheAgentCommitBufSizeの現在の値を100に設定するには、次のように実行します。 

CALL ttDBConfig('CacheAgentCommitBufSize', '100');
 < CACHEAGENTCOMMITBUFSIZE, 100 >
1 row found.

次の例では、DynamicLoadReduceContentionを1に設定しています。 

CALL ttDbConfig('DynamicLoadReduceContention','1');

ノート

  • この組込みプロシージャを使用してパラメータ値を設定した後には、チェックポイントを開始してパラメータ変更の永続性を確認してください。ttCkptプロシージャの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の「チェックポイント処理」を参照してください。チェックポイントの組込みプロシージャの詳細は、この章のttCkptを参照してください。

  • ttDBConfigによるパラメータ値の変更はロールバックできません。

  • 入力パラメータなしでttDBConfigをコールすると、サポートされているすべてのパラメータの名前と値が返されます。

関連項目