ユーザーガイド > プッシュベースのインクリメンタルキャッシング > プッシュベースのインクリメンタルキャッシングの構成パラメーター
 
プッシュベースのインクリメンタルキャッシングの構成パラメーター
セントラルイベントサーバーのTDV変更管理サービス構成パラメーターのアルファベット順のリストと説明を以下に示します。これらのパラメーターは、CMSがインストールされた後、アクティブなCSCMSライセンスと一緒に表示されます。これらのパラメーターはすべて、[Configuration(構成)]ウィンドウ(Studioのメニューバーから[Administration(管理)] > [Configuration(構成)]の順に選択)の[Change Management Service(変更管理サービス)]に表示されます。[Logging Options(ロギングオプション)]と[Tibco]の2つについては、パラメーターをグループとして説明します。
パラメーター/グループ
説明
Administration(管理)
説明については、[Logging Options(ロギングオプション)]パラメーターグループを参照してください。
Attempt Count(試行回数)
[Central Function(セントラル機能)] > [Fault Tolerance(フォールトトレランス)]にあります。障害後にCMSが接続回復を試行する回数です。デフォルト設定の「0」では、CMSは、すべての接続が復元されるまで、データソース、EMS、およびその他のアクティブなクラスターメンバーとの接続回復を試みます。
Attempt Delay(試行の遅延)
[Central Function(セントラル機能)] > [Fault Tolerance(フォールトトレランス)]にあります。この値は、接続障害から回復するための試行間の遅延をミリ秒単位で示します。デフォルト値は1000です。
Caching(キャッシュ作成)
説明については、[Logging Options(ロギングオプション)]パラメーターグループを参照してください。
Change Inference(推論の変更)
Change Inference Messages(推論メッセージの変更)
TDV-Managed Destinations(TDVによって管理される宛先)
[Central Function(セントラル機能)] > [Messaging(メッセージング)]にあります。通常、TDVは、出力メッセージングキューとトピックの宛先を管理するように設定されます。TDVは、クライアントサブスクリプション、転送中のイベント、および一時キャッシュバッファのニーズに応じて、キューとトピックを作成します。[TDV-Managed Destinations(TDVによって管理される宛先)]をfalseに設定した場合は、すべての[Messaging(メッセージング)] > [Internal EMS(内部EMS)]プロパティを設定する必要があります。
Connection Attempt Count(接続試行回数)
説明については、[Tibco]パラメーターグループを参照してください。
Connection Attempt Delay(接続試行の遅延)
Connection Attempt Timeout(接続試行のタイムアウト)
Data Sources(データソース)
説明については、[Logging Options(ロギングオプション)]パラメーターグループを参照してください。
Default Connector(デフォルトコネクター)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Input EMS(入力EMS)]にあります。TIBCO EMSを介してOracle GoldenGateから変更通知メッセージを受信するためのEMSトピック接続ファクトリーの名前。データソース固有のコネクターとトピックを定義して、デフォルトコネクターをオーバーライドできます。[Input EMS Default Connector(入力EMSデフォルトコネクター)]サーバープロパティの値は、JNDI経由のJMSコネクターの名前です。初期コンテキストファクトリーやJNDIプロバイダーURLなどのJMSコネクター属性は、Manager (Web)インターフェイスの[CONNECTOR MANAGEMENT(コネクターの管理)]ページで定義します。
Default Connector(デフォルトコネクター)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Output EMS(出力EMS)]にあります。TDVからサブスクライブ済みクライアントに変更通知メッセージを送信するトピックを作成するために使用されるEMSトピック接続ファクトリーの名前。個々のトピックは、クライアントのサブスクリプション要求に基づいて動的に作成されます。データソース固有のEMSコネクターとトピックを定義して、デフォルトコネクターをオーバーライドできます。[Output EMS Default Connector(出力EMSのデフォルトコネクター)]の値は、JNDI経由のJMSコネクターの名前です。
Error Handling Procedure(エラー処理プロシージャ)
無効なメッセージを受信した場合に呼び出すプロシージャの名前。プロシージャは、エラーの文字列値、問題のあるメッセージの文字列値、およびエラーが報告された時刻のタイムスタンプの3つの引数を受け入れる必要があります。
Expiration Period(有効期間)
ビューの変更を監視するため、クライアントサブスクリプションが更新なしで有効なまま維持される時間数。有効期間が経過する前にクライアントサブスクリプションを更新すると、その有効期間が延長され、別の有効期間まで続きます。有効期限は、クライアントサブスクリプションが作成され、クライアントサブスクライバーに報告されたときに始まります。
In Transit Event Queue(転送中のイベントキュー)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Internal EMS(内部EMS)]にあります。[TDV-Managed Destinations(TDVによって管理される宛先)]がfalseに設定されている場合は、このパラメーターを、転送中の変更イベントをホストするために作成された有効なキューに設定する必要があります。[In Transit Event Queue(転送中のイベントキュー)]を使用すると、フォールトトレランスを確保し、サーバーインスタンスがクラッシュした場合に、最後に正常に処理されたメッセージからイベント処理を再開できます。
Include Column Names(列名を含める)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Message Format(メッセージ形式)]にあります。次の例は、ランク(「r」)と列名(「n」)の両方を含む形式の更新メッセージ(「U」)を示しています。
<U a="true">
<k r="0" n="Column Name 0">value0</k>
<k r="1" n="Column Name 1">value1</k>
<c r="2" n="Column Name 2">
<n>newvalue2</n>
<o>oldvalue2</o>
</c>
<c r="3" n="Column Name 3">
<n>newvalue3</n>
<o>oldvalue3</o>
</c>
<c r="4" n="Column Name 4">
<n>newvalue4</n>
</c>
<c r="5" n="Column Name 5">
<n>newvalue5</n>
</c>
</U>
Include non-Key Deleted Values(キー以外の削除された値を含める)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Message Format(メッセージ形式)]にあります。変更通知メッセージには、作成、更新、および削除操作の検出に使用された一意のキーを確保するため、1つまたは複数の列を持つ主キーが常に含まれます。削除操作の場合、メッセージ設定は、削除された行のキー識別値のみ、またはすべての値を含むように設定できます。
trueに設定すると、次の削除操作の例のように、無関係な列情報が変更通知メッセージに含まれます。この例では、削除操作<D>にキー列(「k」)とキー以外の値{value3、value4、xsi:nil=”true”}が含まれています。
<ops>
<D>
<k r=“0” n=“Column Name 0”>value1</k>
<k r=“1” n=“Column Name 1”>value2</k>
<c r=“2” n=“Column Name 2”>value3</c>
<c r=“3” n=“Column Name 3”>value4</c>
<c r=“4” n=“Column Name 4” xsi:nil=“true”></c>
</D>
</ops>
falseに設定すると、「c」列はメッセージに表示されません。
Include non-Updated Values(更新されていない値を含める)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Message Format(メッセージ形式)]にあります。falseに設定すると、監視対象テーブルの最後のチェックポイント以降に変更されていない値が変更通知メッセージから除外されます。
例:
<U a="true">
<k r="0" n="Column Name 0">value0</k>
<k r="1" n="Column Name 1">value1</k>
<c r="2" n="Column Name 2">
<n>newvalue2</n>
<o>oldvalue2</o>
</c>
<c r="3" n="Column Name 3">
<n>newvalue3</n>
<o>oldvalue3</o>
</c>
</U>
Include Old Updated Values(古い更新値を含める)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Message Format(メッセージ形式)]にあります。trueに設定すると、変更通知メッセージに、置き換えられる古い値が含まれます。
たとえば、次のメッセージでは、古い値(<o> </o>)が強調表示されています。この値は、このプロパティがfalseに設定されている場合は省略されます。
<U a="true">
<k r="0" n="Column Name 0">value0</k>
<k r="1" n="Column Name 1">value1</k>
<c r="2" n="Column Name 2">
<n>newvalue2</n>
<o>oldvalue2</o>
</c>
<c r="3" n="Column Name 3">
<n>newvalue3</n>
<o>oldvalue3</o>
</c>
</U>
Logging Options(ロギングオプション)
パラメーターグループ。通常、ロギングオプションはfalseに設定されます。ログエントリーとイベントは、サーバーの<TDV_install_dir>/logsディレクトリーにあるTDVイベントログ(cs_server_events.log)および/またはサーバーログ(cs_server.log)ファイルで確認できます。次の各ロギングオプションをオン(true)またはオフ(false)にできます。
[Administration(管理)] — CMSのインストールまたはアンインストール、CMSの起動または停止。
[Caching(キャッシュ作成)] — ビューのインクリメンタルに保持されるキャッシュのロギング。
[Change Inference(推論の変更)] — この設定は、接続されたEMSトピックを通じて受信したメッセージをログに記録します。入力EMSデフォルトコネクターと変更メッセージは、監視対象のデータソーステーブルへの変更によってトリガーされたときにCDCから渡されます。この設定は、ログに変更データを表示しません。
[Change Inference Messages(推論メッセージの変更)] — この設定は、接続されたEMSトピックを通じて受信したより詳細なメッセージ(データ変更を含む)をログに記録します。この設定によってログに記録されるメッセージは、変更データキャプチャメッセージングが、現在変更メッセージングをリッスンしているEMSトピックとコネクターに到着しているかどうかを確認するのに役立ちます。
[Data Sources(データソース)] — この設定は、プッシュベースのインクリメンタルキャッシングデータソースでのアクティビティーをログに記録します。[Metadata Inference(メタデータ推論)] — このログ設定によってキャプチャされる情報は、依存関係分析メッセージを示しています。
[Subscriptions(サブスクリプション)] — この設定がtrueの場合、サブスクリプション要求、サブスクリプション解除、およびサブスクリプションの更新要求がログに記録されます。
Message Format(メッセージ形式)
すべてのメッセージングパラメーターをオン(true)またはオフ(false)にできます。パラメーター設定は、変更通知メッセージ形式の内容に影響します。メッセージ形式は、サブスクライブ済みクライアントが受信するすべての変更通知メッセージングに影響するグローバル設定です。
Message Handling(メッセージ処理)
変更通知の正しさは、監視対象のデータソーステーブルから送信される変更メッセージングが正しいことに依存しています。メッセージングにより、インクリメンタルに保持されるキャッシュとサブスクライブ済みユーザーは、ソースデータの変更に関する通知を確実に受け取ることができます。監視対象のデータソースからのメッセージの形式が正しくないか、内容が不足している場合、変更管理サービスは、メッセージを手動の評価と再構成を必要とするシステムエラーとして処理して(cs_server.logに)ログエラーを生成し、場合によっては停止します。メッセージングエラーが発生した場合は、CMSサーバーのログファイルを調べ、Oracle GoldenGateの*.prmパラメーターファイルで構成を確認してください。
PROCEDURE OnError(IN ex VARCHAR(2147483647), IN msg VARCHAR(2147483647), IN t TIMESTAMP)
BEGIN
-- Add your code here
CALL /lib/debug/Log(concat('M5 Test[GG erroneous message]---Exception: ',ex));
CALL /lib/debug/Log(concat('M5 Test[GG erroneous message]---Received message: ',msg));
CALL /lib/debug/Log(CAST(concat('M5 Test[GG erroneous message]---Time: ',t) AS VARCHAR(255)));
END
Metadata Inference(メタデータ推論)
説明については、[Logging Options(ロギングオプション)]パラメーターグループを参照してください。
On Error Procedure(エラー時プロシージャ)
メッセージングエラーが発生したときに実行するプロシージャを設定します。無効なメッセージが検出された場合に呼び出すTDVサーバープロシージャのフルパス名を指定します。指定したプロシージャは、エラーの文字列値、問題のあるメッセージの文字列値、およびエラーが報告された時刻のタイムスタンプの3つの引数を受け入れる必要があります。
Persistence Store(永続ストア)
CMSによって作成および管理されるサブスクリプションストアテーブルをホストするために使用する必要があるリレーショナルデータソースコンテナーを指すTDVリソースパス名。有効なTDV永続ストアの場所を適用すると、CMSによってcis_cms_appl_subsテーブルが作成されます。このテーブルには、cms_client_subscribeのクライアント呼び出しと、サブスクリプションID、アプリケーションID、エンコードされた有効期限、サブスクライブされたビュー(およびフルビューと異なる場合はサブスクライブされた列)のフルパスなどのデータが記録されます。
永続ストアcis_cms_appl_subsテーブルはTDVノード間で共有してはならないため、バックアップサーバーのインポートによる同期の後に永続ストアのターゲット設定を変更する必要があります。
Queue Connector(キューコネクター)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Internal EMS(内部EMS)]にあります。転送中のイベントキューを作成するためにCMSによって使用されるJMSコネクターの名前。転送中のイベントキューは、転送中の変更イベントがセントラルイベントサーバーによって処理されている間、それらの変更イベントをフォールトトレラントな方法で保持するために使用されます。[Internal EMS Queue Connector(内部EMSのキューコネクター)]サーバープロパティの値は、JNDI経由のJMSコネクターの名前です。キューコネクター設定を新規に作成または変更した場合は、CMSを再起動して転送中のキューを初期化する必要があります。
Reconnection Attempt Count(再接続試行回数)
説明については、[Tibco]パラメーターグループを参照してください。
Reconnection Attempt Delay(再接続試行の遅延)
説明については、[Tibco]パラメーターグループを参照してください。
Reconnection Attempt Timeout(再接続試行のタイムアウト)
説明については、[Tibco]パラメーターグループを参照してください。
Security Domain(セキュリティドメイン)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Output EMS(出力EMS)]にあります。サブスクライブされたビューの許可されたグループおよびユーザーへのトピック接続を制限するために使用できるLDAPドメイン値。
Started(起動済み)
[Central Function(セントラル機能)]にあります。この設定は、CMSが起動しているかどうかを示すインジケーターです。値はスイッチではないため、変更しないでください。これは、CMSのステータスを示すために用意されているインジケーターです。CMSは、cms_admin_startおよびcms_admin_stopプロシージャを使用して起動および停止できます。
Stop on Any Error(エラーが発生した場合は停止)
[Central Function(セントラル機能)] > [Fault Tolerance(フォールトトレランス)] > [Message Handling(メッセージ処理)]にあります。CMSは、無効なメッセージ構造を持つソース変更メッセージを受信すると停止します。このフラグは、ソース変更メッセージ通知で他のタイプのエラーが検出された場合にCMSを停止するかどうかを指定します。GG構成が無効な場合は、システムエラーが発生します。
必要な変更通知メッセージスキーマへの部分的な準拠は、不注意なメッセージの場合よりも重大なエラーとなります。一部のデータ型の不一致は処理されますが、不一致があると派生インクリメンタルキャッシュがすべて無効になり、監視対象データで中断が発生したことを知らせる通知(<ops/>、メッセージプロパティaborted=”true”で設定)がすべてのサブスクライブ済みクライアントに送信されます。
[Stop on Any Error(エラーが発生した場合は停止)]がfalseに設定されている場合でも、ほとんどのメッセージングエラーは重大であり、このようなエラーが発生すると、インクリメンタルに保持されるキャッシュ、サブスクリプション失敗メッセージ、およびCMSの意図的な停止がすべて無効になります。必要なCMSスキーマから大幅に逸脱しているメッセージが監視対象の入力トピックまたはキューに挿入された場合、そのメッセージは無視されます。
Subscriptions(サブスクリプション)
説明については、[Logging Options(ロギングオプション)]パラメーターグループを参照してください。
Tibco
パラメーターグループ。これらのオプション設定を使用すると、TIBCO EMS接続ファクトリー設定をオーバーライドし、CMSで接続試行のタイミングと回数を管理できます。プライマリーEMSからバックアップEMSに切り替えると、許可されている数を超える多数の接続および再接続試行を開始できます。
[Connection Attempt Count(接続試行回数)] — JMSサーバーへの接続の試行回数。
[Connection Attempt Delay(接続試行の遅延)] — 次の接続が確立されるまで待機する時間(ミリ秒)。
[Connection Attempt Timeout(接続試行のタイムアウト)] — 試行が失敗した場合、接続ファクトリーが失敗を宣言するまで待機する時間(ミリ秒)。
[Reconnection Attempt Count(再接続試行回数)] — JMSサーバーへの再接続の試行回数(TIBCOには、個別の接続および再接続試行パラメーターがあります)。
[Reconnection Attempt Delay(再接続試行の遅延)] — 次の接続が確立されるまで待機する時間(ミリ秒)。
[Reconnection Attempt Timeout(再接続試行のタイムアウト)] — 接続ファクトリーが失敗を宣言するまで待機する時間(ミリ秒)。
ハード接続障害の場合、これらのJMSベンダー設定が示すよりも早く問題が報告される可能性があります。
Topic Connector(トピックコネクター)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Internal EMS(内部EMS)]にあります。[TDV-Managed Destinations(TDVによって管理される宛先)]がfalseに設定されている場合は、このパラメーターを、TDVが一時キャッシュバッファを管理するための有効なトピックコネクターに設定する必要があります。このトピックコネクターは、インクリメンタルに保持されるデータキャッシュの初期化中に必要になる場合があります。
Transient Cache Buffering Topic(一時キャッシュバッファリングトピック)
[Central Function(セントラル機能)] > [Messaging(メッセージング)] > [Internal EMS(内部EMS)]にあります。[TDV-Managed Destinations(TDVによって管理される宛先)]がfalseに設定されている場合は、キャッシュの初期化中に変更メッセージを処理するための一時トピックを提供する一時キャッシュバッファを設定できるように、このパラメーターを有効なトピックに設定する必要があります。セントラルイベントサーバーは、このトピックを使用し、キャッシュテーブルが作成され、初めてロードされているときに発生した変更通知を処理します。