6.5 サーバー・パラメータ

この項では、Oracle GoldenGate Veridataで使用される主要なサーバー構成パラメータの概要をまとめて示します。これらのパラメータは、通常、veridata.cfg構成ファイルで定義され、パフォーマンス・チューニング、メモリー管理、ソート、電子メール通知、レポート、修復操作、非同期(OOS)レコードの処理など、サーバーの動作に影響します。これらのパラメータを適切に理解およびチューニングすることで、システム・パフォーマンスが向上し、比較ジョブが最適化され、多様なデプロイメント環境でVeridataの信頼性の高い操作が行われるようになります。

Oracle GoldenGate Veridataのサーバー構成は、DOMAIN_HOME/config/veridata/veridata.cfgにあるveridata.cfgファイルで定義されているパラメータを使用して変更できます。

パラメータの設定方法の詳細は、パラメータの設定方法を参照してください。

ノート:

これらのパラメータを変更するには、サーバーの再起動が必要です。

• サーバー・メモリーの概要
  
• メモリー使用量の見積り
  
• パラメータの設定方法
  
• パラメータの説明
  

6.5.1 サーバー・メモリーの概要

Oracle GoldenGate Veridataサーバーは仮想メモリーを次のように使用します。

• 基本操作のサーバー・メモリー: これはVeridataサーバーとWebコンポーネントの動作に必要な仮想メモリーのサイズです。オブジェクト・プール、データベース・アクセス・ライブラリおよびその他の情報が格納されます。これは通常約200 MBです。
• ソート・メモリー: これはサーバー側のソートが使用される場合に使用されるメモリーです。ソートの仮想メモリーはスレッドごとではなく、比較全体に対して割り当てられます。行はエージェントから読み取られ、送信されてソートされます。ソートはエージェントから読み取るスレッドとは別のスレッドで行われます。ソートは並行して動作するため多くのスレッドを使用する可能性があります。エージェントからの行がすべてソート・プロセスに送信されると、サーバー・プロセスではソートからソート済の行を取得して比較します。
• 行ハッシュ・キュー・メモリー: これは、エージェント・プロセス、ソート・プロセスおよびサーバー・プロセス間でデータをバッファするためのメモリーです。データベース・ソートを使用する比較では、ソースとターゲットのそれぞれに単一キューが必要です。各キューの容量は20MBです。キューのメモリー使用量は比較の相対速度とエージェントからのデータ量によって異なります。2つのエージェント間の相対速度もメモリー使用量に影響します。キューはデータをバッファに入れる必要があるため、速度差が大きいほどメモリー使用量は増えます。
• MOOSキュー・メモリー: これは、初回比較と比較の確認ステップ間で同期していない可能性があるレコードを保持するメモリーです。MOOSキューのサイズは50Kレコードに制限されています。メモリー使用量は各レコードの幅によっても異なります。
• IPCバッファ・メモリー: これは、サーバーとエージェント間のメッセージ交換に使用されるメモリーです。
• スクラッチ・ランタイム一時メモリー: これは仮想メモリー領域です。

ソート・プロセスで使用できるメモリーは、次のうち最小のものを超えることはできません:

• システムの物理メモリー
• スワップ内の使用可能メモリー
• Javaブート・オプション -Xmx最大メモリー設定

6.5.2 メモリー使用量の見積り

Oracle GoldenGate Veridataで使用可能なメモリーの最大量は、Javaブート・オプション-Xmxで指定されます。サーバー側のソートを使用する場合、このメモリーの大部分が比較時のソート用に確保されます。確保される量は、server.max_sort_memory構成パラメータによって制御されます。

比較を実行する際、2つのバッファが確保されたソート・メモリーから割り当てられます。各々のサイズは、「最大メモリー使用量(MB)」で指定されたサイズと同じです。server.max_sort_memoryを参照してください。

行ごとに使用されるメモリー量の見積り

行ごとに使用されるメモリー量の見積りの詳細は、「サーバー・コンポーネントのディスクおよびメモリー要件」を参照してください。

6.5.3 パラメータの設定方法

パラメータを設定するには、veridata.cfgファイルにあるエンティティを編集します。このファイルは、Oracle GoldenGate Veridataサーバーのインストール・ディレクトリ内のDOMAIN_HOME/config/veridataディレクトリに格納されています。

Oracleサービス・リクエストを開いてから、これらのパラメータを変更します。

6.5.4 パラメータの説明

パラメータ名	構文/例	可能な値	デフォルト値	説明
database.hash	database.hash = false	true/false	false	データベースでデータ・ハッシュを実行するかどうかを定義します。Oracleでのみサポートされます。
max_lob_key_len	max_lob_key_len = 1	1から8000 (バイト)	0 (値が0の場合は機能が無効になります)	キーとして使用されるLOBデータ型の最大長(バイト単位)を設定します。Postgresのcitextに対応しています。
server.convert_empty_to_null	server.convert_empty_to_null = true	true、false	true	trueの場合、空の文字列およびNULLを同期として扱います。
server.max_concurrent_comparison_threads	server.max_concurrent_comparison_threads = 100	数値1-100	4	このパラメータは、実行可能な最大同時比較数を設定します。この数を減らしてシステム上のサーバーの影響を減らせます。この上限に達すると、アクティブな比較が完了するまで新たな比較は開始されません。
server.memory_mapped_sort_directory	server.memory_mapped_sort_directory = /u01/tmp2	ディレクトリ・パス	-	このパラメータは、.mapファイルが生成されるディレクトリ・パスを指定します。デフォルトでは、オペレーティング・システムの一時ディレクトリが使用されます。オペレーティング・システムの一時ディレクトリが50GB未満の場合は、より大きなディレクトリを指定することを検討してください。
server.meta_session_handle_timeout	server.meta_session_handle_timeout = 600	数値(秒)	900	メタセッションハンドルのタイムアウト(秒)。
server.veridata_data	server.veridata_data = /u01/veridata/reports	ディレクトリ・パス	veridata/reports	Veridataレポートの出力ディレクトリ。
socket.timeout.mins	socket.timeout.mins = 0	数値(分)	0	非アクティブなソケットのタイムアウト(分)。
server.useSsl	server.useSsl = true	true、false	false	このパラメータでは、VeridataサーバーからVeridataエージェントへの通信に対してSSLが有効かどうかを指定します。
truncate_spaces_len	truncate_spaces_len = 0	0, 1	1	String列またはBinary列の末尾のスペースの切捨て方法を制御するには、truncate_spaces_lenパラメータを使用します。スペース(U+0020)および表意文字スペース(U+3000)が切捨てターゲットです。接続構成のOracle GoldenGate Veridata UIにある「接続設定」タブの「値の比較時に末尾のスペースを切捨て」パラメータを使用して、切捨て機能を無効にできます。このパラメータは、パディング文字がターゲット・スペースの1つである場合、列のパディング文字も切り捨てます。値が0の場合、すべてのスペースが切り捨てられます。たとえば、data = ""です。値が1の場合、少なくとも1つのスペースが保持されます。たとえば、data = " "です。
jvm.memory.xms	jvm.memory.xms = <min_heap_size>	メモリー値(8gなど)	-	最小JVMヒープ・サイズ。これは、<VERIDATA_HOME>/config/oggvdt_cainput.propertiesを編集することで変更できます。「サーバーに最適なメモリー」を参照してください。
jvm.memory.xmx	jvm.memory.xmx = <max_heap_size>	メモリー値(28gなど)	-	最大JVMヒープ・サイズ。これは、<VERIDATA_HOME>/config/oggvdt_cainput.propertiesを編集することで変更できます。「サーバーに最適なメモリー」を参照してください。
server.max_sort_memory	server.max_sort_memory = 1000M	メモリー値(1000Mなど)	デフォルトのサイズは、使用可能な仮想メモリーに基づいて計算されます。	すべての比較の合計ソート・メモリーを設定します。このパラメータは、サーバー側ソートを使用する実行中のすべての比較に使用できるソート仮想メモリーの最大量を設定します。このパラメータの値は、server.mapped_sort_buffersの値によって異なります。server.max_sort_memory {default | number{M | m}}のdefaultは次のようになります: server.mapped_sort_buffersがtrueに設定されている場合、デフォルト値は2 GBです。入力する最大サイズは、メモリー・マップ・ファイルの最大サイズです。server.mapped_sort_buffersがfalseに設定されている場合、デフォルト値は、JVMの使用可能なヒープ・サイズから200 MBを引いた値となり、これが基本タスクに割り当てられます。入力する最大数は、java -Xmxの値です。
server.mapped_sort_buffers	server.mapped_sort_buffers = true	true、false	true、false	ソート・バッファをメモリー・マップ・ファイルとして割り当てるか、JVMヒープに割り当てるかを指定します。
server.number_sort_threads	server.number_sort_threads = <number>	最大4またはCPUコアの1/4	4	このパラメータでは、Veridataエージェントからの入力バッファのソートに使用されるスレッドの数を指定します。
mail.enabled	mail.enabled = false	true、false	false	電子メール通知を有効化/無効化します。
mail.alert.only	mail.alert.only = true	true、false	true	trueの場合、アラート電子メールのみを送信します(完了ではない)。
mail.smtp.server	mail.smtp.server = smtp.host.com	SMTPサーバーのホスト名	-	SMTPサーバーのホスト名。
mail.smtp.port	mail.smtp.port = 25	数値のポート番号	-	SMTPサーバー・ポート。
mail.smtp.connection.ssl.tls	mail.smtp.connection.ssl.tls = true	true、false	false	メール・サーバー接続に対してSSL/TLSを有効にします。
mail.from	mail.from = [e-mail]	有効な電子メール・アドレス	-	送信者の電子メール・アドレス。
mail.to	mail.to = [e-mail],[e-mail]	カンマ区切りの電子メール・アドレス	-	受信者の電子メール・アドレス(カンマ区切り)。
server.encryption	server.encryption = false	true、false	false	比較レポートおよび修復レポートの暗号化を有効にします。
server.encryption.bits	server.encryption.bits = 128	128, 192, 256	128	暗号化強度(ビット)。
repair.oracle.tag.enable	repair.oracle.tag.enable = false	true、false	true	Oracle REDOログの修復セッションのタグ付けを有効にします。
repair.oracle.tag	repair.oracle.tag = 00	値は、最大2000の16進数(0-9A-F)またはプラス記号(+)を指定できます。	00	Oracle REDOログで使用される16進タグ。
coos.join.strategy	coos.join.strategy = nokey	nokey、always、never	nokey	nokey - すべての列をキー列として使用(表に主キー制約または一意制約がない)して比較ペアのキー列を選択する場合にのみ、COOS結合戦略を使用します。比較ペア例外XML、UDTおよびLOBのキー列としてのすべての列。always - COOSステップには常にCOOS結合を使用します。never - COOSステップにはCOOS結合を使用しないでください。
skiprows.enabled	skiprows.enabled = true	true、false	true	無効な番号の行をスキップして、比較を続行できるようにします。