C トピック構成リファレンス

トピック構成要素リファレンスには、すべての非終端のトピック構成要素が含まれます。各項で、要素の使用方法とすべての有効なサブ要素についても説明されています。

• page-size
  
• paged-topic-scheme
  
• subscriber-group
  
• subscriber-groups
  
• topic-mapping
  
• topic-scheme-mapping
  
• topic-storage-type
  

page-size

使用場所: paged-topic-scheme

説明

page-size要素は、ターゲット・ページ・サイズを指定します。デフォルト値は1MBです。

paged-topic-scheme

使用場所: caching-schemes

説明

paged-topic-schemeは、クラスタ・ノード間で値およびメタデータの記憶域をパーティション化するトピックを定義します。

要素

表C-1で、paged-topic-scheme要素のサブ要素を説明します。

表C-1 paged-topic-schemeのサブ要素

要素	必須/オプション	説明
<scheme-name>	オプション	スキームの名前を指定します。この名前は構成ファイル内で一意である必要があります。
<scheme-ref>	オプション	継承元の別のスキーム名を指定します。スキームの継承の使用を参照してください
<scope-name>	オプション	この構成のスコープ名を指定します。スコープ名は、キャッシュ・ファクトリによって生成されたすべてのサービスに(接頭辞として)追加されます。この名前は、複数のキャッシュ・ファクトリを使用する場合にサービスを分離するために使用されるため、異なる構成から意図しない同じような名前のサービスが参加しないようになります。
<service-name>	オプション	このスキームから作成されたトピックを管理する分散キャッシュ・サービス・インスタンスの名前を指定します。分散キャッシュ・サービス定義は、tangosol-coherence.xmlファイルの<services>要素内で定義されすま。DistributedCacheサービスのパラメータ を参照してください。分散スキームごとに、異なるパーティション・キャッシュ・サービス・インスタンスを使用して、別々のトピックを管理できます。スラッシュ(/)とコロン(:)は予約文字であり、サービス名では使用できません。
<service-priority>	オプション	サービス・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたservice-priority値です。DistributedCacheサービスのパラメータのservice-priorityパラメータを参照してください。
<event-dispatcher-priority>	オプション	各サービスのイベント・ディスパッチャ・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたevent-dispatcher-priority値です。DistributedCacheサービスのパラメータのevent-dispatcher-priorityパラメータを参照してください。
<serializer>	オプション	ユーザー定義型のシリアライズおよびデシリアライズに使用するcom.tangosol.io.Serializer実装のクラス構成情報を指定するか、またはオペレーション構成ファイルで定義されているシリアライザ・クラス構成を参照します。serializerを参照してください。 ローリング再起動中にこの要素を変更することはできません。たとえば、javaからpofシリアライズまたはシリアライザ・クラスに変更することはできません。
<reliable-transport>	オプション	信頼性の高いポイントツーポイント通信を実現するためにこのサービスで使用されるトランスポート・プロトコルを指定します。<unicast-listener>要素で定義される共有トランスポート・インスタンスではなく、サービス固有のトランスポート・インスタンスを使用することを示す値を指定します。サービス固有のトランスポート・インスタンスは、パフォーマンスが高くなりますが、リソース消費量が増加するという代償があるため、厳選した優先度が高いサービスに対して慎重に使用する必要があります。一般的に、共有トランスポート・インスタンスでは、サービス固有のトランスポート・インスタンスよりもリソース消費量が少なくなります。有効な値は次のとおりです。 datagram – UDP。 tmb (デフォルト) – TCP/IPメッセージ・バス・プロトコル tmbs – SSL対応TCP/IPメッセージ・バス・プロトコル。TMBSでは、SSLソケット・プロバイダの使用が必要です。socket-providerを参照してください。 sdmb – ソケット・ダイレクト・プロトコル(SDP)メッセージ・バス。 sdmbs – SSL対応SDPメッセージ・バス。SDMBSでは、SSLソケット・プロバイダを使用する必要があります。socket-providerを参照してください。 デフォルト値は、tangosol-coherence.xmlディスクリプタに指定された<reliable-transport>値です。DistributedCacheサービスのパラメータのreliable-transportパラメータを参照してください。 ローリング再起動中に、この要素をTLSから非TLSに変更することはできません。ただし、ローリング再起動中にtmbまたはdatagram間で変更することはできます。
<compressor>	オプション	バックアップ更新をデルタ形式で圧縮するか、全体を送信するかを指定します。デルタ更新は、バックアップ・エントリの一部を表しており、プライマリ・エントリと同期させるには変更が必要です。デルタは、コンプレッサを使用して作成および適用します。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたcompressor値です。DistributedCacheサービスのパラメータのcompressorパラメータを参照してください。有効な値は次のとおりです。 none - デルタ・バックアップを無効にします。コンプレッサは使用されません。プライマリ・エントリが変更されると、バックアップ・バイナリ・エントリ全体が置換されます。 standard - パーティション・サービスで使用されているシリアライザに基づいて、デルタ・コンプレッサを自動的に選択します。 <instance> com.tangosol.io.DeltaCompressorインタフェースを実装するクラスの構成です。
<thread-count-max>	オプション	デーモン・スレッドの最大数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、thread-count-min要素の値以上の整数です。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたthread-count-max値です。DistributedCacheサービスのパラメータのthread-count-maxパラメータを参照してください。
<thread-count-min>	オプション	デーモン・スレッドの最小数を指定します。デーモン・スレッドの使用は、サービス・タイプによって異なります。ゼロまたは負の場合、サービスはデーモン・スレッドを使用せず、関連するすべてのタスクはサービス・スレッド上で実行されます。さらに、負の場合、可能な場合はタスクがコール元のスレッドで実行されます。有効な値は、thread-count-max要素の値以下の整数です。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたthread-count-min値です。DistributedCacheサービスのパラメータのthread-count-maxパラメータを参照してください
<worker-priority>	オプション	ワーカー・スレッドの優先度を指定します。有効な値は1から10の範囲で、10が最も高い優先度です。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたworker-priority値です。DistributedCacheサービスのパラメータのworker-priorityパラメータを参照してください。
<local-storage>	オプション	クラスタ・ノードをクラスタの記憶域として機能させる(つまり、パーティションを保持する)かどうかを指定します。無効化した場合、そのノードはキャッシュ・クライアントと見なされます。有効な値は、trueまたはfalseです。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたlocal-storage値です。DistributedCacheサービスのパラメータのlocal-storageパラメータを参照してください。
<partition-count>	オプション	分散キャッシュ・パーティションの数を指定します。分散キャッシュ・サービスを実行している記憶域が有効なクラスタ・メンバーはそれぞれ均等な数のパーティションを管理します。 有効な値は、1と32767の間の正の整数で、素数にする必要があります。素数のリストは、http://primes.utm.edu/lists/ にあります。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定された値です。DistributedCacheサービスのパラメータのpartition-countパラメータを参照してください。 ローリング再起動中にこの要素を変更することはできません。これは機能しているように見える場合がありますが、変更が無視されたことを示す次のようなメッセージが表示されます: <Warning> (thread=DistributedCache:PartitionedCache, member=8): This node is configured with a 'partition-count' value of 801, but the service senior is using a value of 257; overriding the local configuration。
<transfer-threshold>	オプション	プライマリ・バケット分散のしきい値をキロバイト単位で指定します。パーティション・キャッシュ・サービスに新しいノードが結合する場合、またはサービスのメンバーのいずれかの結合が解除される場合、残りのノードによって、バケット所有権の再分散タスクが実行されます。このプロセスでは、所有権情報とともに既存のデータの均衡化が再実行されます。このパラメータでは、データ転送通信で優先されるメッセージ・サイズを示します。この値を低く設定すると、分散プロセスの所要時間は長くなりますが、このアクティビティ実行中のネットワーク帯域幅の使用量は軽減されます。有効な値は、ゼロより大きな整数です。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたtransfer-threshold 値です。DistributedCacheサービスのパラメータのtransfer-thresholdパラメータを参照してください。
<backup-count>	オプション	ページ・トピック・サービスのうち、各保存単位のバックアップ・データをトピックに保持するメンバーの数を指定します。この値が0になっていると、異常終了した場合にトピック内のデータの一部が失われます。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたbackup-count値です。DistributedCacheサービスのパラメータを参照してください ローリング再起動中にこの要素を変更することはできません。これは機能しているように見える場合がありますが、変更が無視されたことを示す次のようなメッセージが表示されます: <Warning> (thread=DistributedCache:PartitionedCache, member=8): This node is configured with a 'backup-count' value of 2, but the service senior is using a value of 1; overriding the local configuration。
<partition-assignment-strategy>	オプション	パーティション・サービスでパーティション分散を管理する際に使用する戦略を指定します。デフォルト値は、tangosol-coherence.xmlディスクリプタに指定されたpartition-assignment-strategy値です。DistributedCacheサービスのパラメータのpartition-assignment-strategyパラメータを参照してください simple - 単純な割当て戦略は、マシンの安全性を確保しながらパーティション分散のバランスを取ることを試みます mirror:<service-name> – ミラー割当て戦略は、サービスのパーティションを、指定されたサービスのパーティションと共存させることを試みます。この戦略は、キーを関連付けられたクロスサービス・キャッシュ・アクセスがメンバーに対してローカルのままになる可能性を高めるために使用されます。 custom - com.tangosol.net.partition.PartitionAssignmentStrategyインタフェースを実装するクラス。<instance>要素を使用してカスタム戦略を入力します。 ローリング再起動中にこの要素を変更することはできません。
<guardian-timeout>	オプション	サービスおよび依存するスレッドをガードするために使用するガーディアンのタイムアウト値を指定します。指定のサービスに対して要素が指定されていない場合、デフォルトのガーディアンのタイムアウト(<timeout-milliseconds>オペレーション構成要素で指定)が使用されます。「<service-guardian」を参照してください。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]?
<service-failure-policy>	オプション	動作が異常なサービス・スレッドをサービス・ガーディアンが正常に終了できないときに実行するアクションを指定します。 有効な値は次のとおりです。 exit-cluster - (デフォルト)応答しないように見えるスレッドをリカバリしようとします。試行に失敗した場合は、関連付けられたサービスの停止が試行されます。関連付けられたサービスを停止できない場合、このポリシーによって、ローカル・ノードでクラスタ・サービスが停止します。 exit-process - 応答しないように見えるスレッドをリカバリしようとします。試行に失敗した場合は、関連付けられたサービスの停止が試行されます。関連付けられたサービスを停止できない場合、このポリシーによって、ローカル・ノードでJVMが途中で終了します。 logging - 検出された問題をログに記録しますが、修正処置は実行されません。 カスタム・クラス - <instance>サブ要素を使用して、 com.tangosol.net.ServiceFailurePolicy 実装のクラス構成情報を指定します。
<member-listener>	オプション	com.tangosol.net.MemberListenerインタフェースを実装するクラスの構成情報を指定します。実装には、publicなデフォルト・コンストラクタが必要です。instanceを参照してください。 MemberListener実装は、キャッシュ・サービス・ライフサイクル・イベントを受信します。要素は、サービスでMapListenerをプログラムによって追加するための代替手段として使用されます。
<storage>	オプション	この列挙型は、トピック値およびメタデータの保持に使用する記憶スキームを指定します。 有効な値は、on-heap、flashjournalまたはramjournalです。デフォルト値はon-heapです。
<transient>	オプション	永続性環境を使用して、トピック値とメタデータを永続化する必要があるかどうかを指定します。有効な値はtrueまたはfalseです。falseに設定されている場合、トピック値とメタデータの内容の永続化に永続性環境が使用されます。trueに設定されている場合、トピック値とメタデータは一時的なものであると見なされ、その内容はクラスタの再起動時にリカバリできません。デフォルト値はfalseです。
<persistence>	オプション	パーティション・キャッシュ・サービスの永続性関連の構成を指定します。この要素が存在し、persistence.environment値が指定されていない場合、デフォルトはdefault-on-demandの永続性です。
<storage-authorizer>	オプション	オペレーション構成ファイルに定義されている記憶域アクセスの認可者への参照を指定します。記憶域アクセス認可者は、パーティション・キャッシュによって使用され、基礎となるキャッシュ・データへのアクセスを認可します。構成されている場合、トピック記憶域のデータのすべての読取りおよび書込みアクセスは、構成済の認可者によって検証または監査されます(あるいは両方)。 次の例では、id属性がauditingの記憶域アクセス認可者の定義を参照します。 <storage-authorizer>auditing</storage-authorizer> storage-authorizerを参照してください。
<partitioned-quorum-policy>	オプション	パーティション・キャッシュ・サービス用のクォーラム・ポリシー設定を指定します。
<autostart>	オプション	autostart要素は、キャッシュ・サーバー(つまり、com.tangosol.net.DefaultCacheServer)で使用することを目的としています。この要素は、このキャッシュ・スキームに関連付けられたキャッシュ・サービスをクラスタ・ノードで自動的に起動するかどうかを指定します。有効な値は、trueまたはfalseです。デフォルト値はfalseです。
<interceptors>	オプション	特定の分散サービスのすべてのキャッシュのイベントを処理する任意の数のイベント・インターセプタを指定します。
<page-size>	オプション	page-size要素は、ターゲット・ページ・サイズを指定します。
<expiry-delay>	オプション	サブスクライバが受信できるトピックに値がパブリッシュされてからの経過時間を指定します。有効期限が切れた値にはアクセスできなくなります。 この要素の値は、次の形式で指定する必要があります。 (\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]? 前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。 MSまたはms(ミリ秒) Sまたはs(秒) Mまたはm(分) Hまたはh(時) Dまたはd(日数) 値に単位が含まれていない場合は、秒が単位として適用されます。値0は期限がないことを意味します。デフォルト値は0です。 ノート: expiry-delayのパラメータ(cExpiryMillis)は整数として定義し、ミリ秒単位で表します。そのため、最大期間はInteger.MAX_VALUE (2147483647)ミリ秒数を超えることはできず、おおよそ24日間になります。
<high-units>	オプション	トピックのサイズ制限を指定します。この値は、トピックに保持されている未処理の値の最大バイト数を表します。パブリッシャの構成方法とそのスレッドのtry-with-resource状態に応じて、次回の送信がフロー制御によって制限されるか、フルで失敗するか、トピックへの値の送信に進みます。 有効な値は、正の整数および0です。この要素の値は、次の形式で指定する必要があります。 (\d)+[K|k|M|m|G|g|T|t]?[B|b]? 前述の文字は(左から右へ)それぞれ、先行する10進数値に乗じる係数を示しています。 Bまたはb (byte, 1) Kまたはk(kilo、210) Mまたはm(mega、220) Gまたはg(giga、230) Tまたはt (テラ、240) デフォルト値は0で、値に制限はありません。値がInteger.MAX_VALUEを超えると、ユニット・ファクタが自動的に使用され、それ応じて値が調整されます。値に係数が含まれていない場合は、1が係数として適用されます。

subscriber-group

使用場所: subscriber-groups

説明

subscriber-group要素は、topic-mappingの恒久サブスクリプション・グループを定義します。

要素

表C-2は、subscriber-group要素のサブ要素を示しています。

表C-2 subscriber-groupのサブ要素

要素	必須/オプション	説明
<name>	必須	サブスクライバ・グループ名。

subscriber-groups

使用場所: topic-mapping

説明

subscriber-groups要素により、topic-mappingに1つ以上の恒久サブスクリプション・グループを定義できます。これらのグループはトピックとともに作成され、データがトピックにパブリッシュされる前に存在することが保証されます。

要素

表C-3は、subscriber-groups要素のサブ要素を示しています。

表C-3 subscriber-groupsのサブ要素

要素	必須/オプション	説明
<subscriber-group>	必須	topic-mappingの恒久サブスクリプション・グループを定義する1つ以上のsubscriber-group要素。

topic-mapping

使用場所: topic-scheme-mapping

説明

各topic-mapping要素は、アプリケーションで使用される特定のトピック名またはトピック名のパターンに使用されるpaged-topic-schemeを指定します。

要素

表C-4は、topic-mapping要素のサブ要素を示しています。

表C-4 topic-mappingのサブ要素

要素	必須/オプション	説明
<topic-name>	必須	トピック名または名前のパターンを指定します。名前は、キャッシュ・ファクトリで作成されたトピック内で一意です。スラッシュ(/)とコロン(:)は予約文字であり、キャッシュ名では使用できません。次のトピック名パターンがサポートされています: 完全一致。たとえば、MyTopicです。 ワイルドカードを使用した接頭辞の一致(prefix*)。たとえば、Myから開始する任意のトピック名と一致するMy*です。 ワイルドカードを使用した全一致(*)。すべてのトピック名に一致します。 トピック名は複数のトピック・マッピングに一致する可能性があります。その場合、ワイルドカード一致よりも完全一致が優先されます。完全一致が指定されていない場合は、最後に一致したワイルドカード・パターン(ファイルで定義された順番に基づく)が選択されます。
<scheme-name>	必須	トピック・スキーム名を記述します。この名前は構成ファイル内で一意です。トピック・スキームは、caching-scheme要素で構成されます。
<value-type>	オプション	NamedTopic値のJavaクラスの完全修飾名を指定します。
<subscriber-groups>	オプション	subscriber-group要素により、topic-mappingに1つ以上の恒久サブスクリプション・グループを定義できます。これらのグループはトピックとともに作成され、データがトピックにパブリッシュされる前に存在することが保証されます。
<init-params>	オプション	置換可能なトピック・スキーム・パラメータの指定を可能にします。トピック・スキームの解析時に、形式param-nameの置換可能パラメータが検出されると、そのパラメータが対応するパラメータ値に置換されます。次のトピックのマッピング例を参照してください。 <topic-mapping> <topic-name>My*</topic-name> <scheme-name>my-scheme>/scheme-name> <value-type>String</value-type> <init-params> <init-param> <param-name>page-size</param-name> <param-value>10MB</param-value> </init-param> </init-params> </topic-mapping> リテラル{page-size}のオカレンスはすべて10MBの値に置換されます。

topic-scheme-mapping

使用場所: cache-config

説明

トピック名(または名前のパターン)とpaged-topic-schemeとのマッピングを定義します。

要素

表C-5は、topic-scheme-mapping要素で定義可能なサブ要素について説明しています。

表C-5 topic-scheme-mappingのサブ要素

要素	必須/オプション	説明
<topic-mapping>	オプション	このトピックで使用する、トピック名とトピック・スキーム間の単一バインディングを含むtopic-mapping要素。

topic-storage-type

使用場所: paged-topic-scheme

説明

この列挙型は、トピック値およびメタデータの保持に使用する記憶スキームを指定します。有効な値は、on-heap、flashjournalまたはramjournalです。デフォルト値はon-heapです。