Oracle TimesTen In-Memory Database APIおよびSQLリファレンス・ガイド

CREATE ACTIVE STANDBY PAIR

この文では、アクティブ・スタンバイ・ペアを作成します。アクティブ・マスター・データ・ストア、スタンバイ・マスター・データ・ストアおよび少なくとも1つの読取り専用サブスクライバが含まれます。アクティブ・マスター・データ・ストアは、更新をスタンバイ・マスター・データ・ストアにレプリケートし、更新をサブスクライバに伝播します。

アクセス制御

TimesTenインスタンスでアクセス制御が有効な場合、この文にはADMIN権限が必要です。

SQL構文

CREATE ACTIVE STANDBY PAIR

FullStoreName, FullStoreName [ReturnServiceAttribute]

[SUBSCRIBER FullStoreName [,...]]

[STORE FullStoreName [StoreAttributes [,...]]]

{ INCLUDE | EXCLUDE }{TABLE | CACHE GROUP } [Owner.]{TableName | CacheGroupName} [,...]

ReturnServiceAttributeの構文は、次のとおりです。

{ RETURN RECEIPT [BY REQUEST] |

RETURN TWOSAFE [BY REQUEST] |

NO RETURN }

StoreAttributesの構文は、次のとおりです。

[ DISABLE RETURN {SUBSCRIBER | ALL} NumFailures ]

[ RETURN SERVICES {ON | OFF} WHEN [REPLICATION] STOPPED ]

[ DURABLE COMMIT {ON | OFF}]

[ RESUME RETURN MilliSeconds ]

[ LOCAL COMMIT ACTION {NO ACTION | COMMIT} ]

[ RETURN WAIT TIME Seconds ]

[ COMPRESS TRAFFIC {ON | OFF}

[ PORT PortNumber ]

[ TIMEOUT Seconds ]

[ FAILTHRESHOLD Value ]

パラメータ

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


FullStoreName	次のいずれかとして指定されるデータ・ストアです。 · SELF · データ・ストア・ファイル名の接頭辞たとえば、データ・ストアのパスがdirectory/subdirectory/data.ds0の場合、データは使用対象のデータ・ストア名です。この名前は、DSNの記述のData Store Path and Name属性で指定されるデータ・ストア・ファイル名で、書式にはオプションでホストIDを指定できます。 DataStoreName [ON Host] HostにはIPアドレスまたは1つ以上のIPアドレスに割り当てられたリテラルのホスト名を指定できます。ホスト名に特殊文字が含まれている場合、"MyHost-500"のように二重引用符で囲む必要があります。（『Oracle TimesTen Replication - TimesTen to TimesTen 開発者および管理者ガイド』のホストIPアドレスの構成に関する項を参照してください。）
RETURN RECEIPT [BY REQUEST]	RETURN RECEIPTサービスを有効にします。これによって、マスター・データ・ストアに対してトランザクションをコミットするアプリケーションは、すべてのサブスクライバがトランザクションを受信するまでブロックされます。 RETURN RECEIPTにより、すべてのトランザクションにサービスが適用されます。RETURN RECEIPT BY REQUESTを指定した場合は、ttRepSyncSet()プロシージャを使用して、選択したトランザクションに対してRETURN RECEIPTサービスを有効にできます。RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。
RETURN TWOSAFE [BY REQUEST]	RETURN TWOSAFEサービスを有効にします。これによって、マスター・データ・ストアに対してトランザクションをコミットするアプリケーションは、すべてのサブスクライバがトランザクションをコミットするまでブロックされます。 RETURN TWOSAFEにより、すべてのトランザクションにサービスが適用されます。RETURN TWOSAFE BY REQUESTを指定した場合は、ttRepSyncSetプロシージャを使用して、選択したトランザクションに対してRETURN RECIPTサービスを有効にできます。RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。
NO RETURN	RETURNサービスを使用しないように指定します。この設定がデフォルトです。 RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。
SUBSCRIBER FullStoreName [,...]]	マスター・データ・ストアから更新を受け取るデータ・ストアです。FullStoreNameは、DSNの記述のData Store Path and Name属性で指定されるデータ・ストア・ファイル名です。
STORE FullStoreName [StoreAttributes [,...]]	指定されたデータ・ストアの属性を定義します。データ・ストア属性には、PORT、TIMEOUTおよびFAILTHRESHOLDが含まれています。FullStoreNameは、DSNの記述のData Store Path and Name属性で指定されるデータ・ストア・ファイル名です。
{ INCLUDE \| EXCLUDE } {TABLE \| CACHE GROUP } [Owner.]{TableName \| CacheGroupName} [,...]	データ・ストアの表またはキャッシュ・グループを追加または削除します。 INCLUDEは、指定された表とキャッシュ・グループをデータ・ストアに追加します。各オブジェクト型（表またはキャッシュ・グループ）に対して1つのINCLUDE句を使用します。 EXCLUDEは、指定された表とキャッシュ・グループをデータ・ストアから削除します。各オブジェクト型（表またはキャッシュ・グループ）に対して1つのEXCLUDE句を使用します。 [Owner.]{TableName \| CacheGroupName} [,...]は、データ・ストアに追加または削除する表名またはキャッシュ・グループ名のリストで、オプションで所有者も指定できます。
DISABLE RETURN {SUBSCRIBER \| ALL} NumFailures	NumFailuresで指定されているタイムアウト回数を経過した後、RETURNサービスによるブロッキングを無効にするようにRETURNサービス障害ポリシーを設定します。SUBSCRIBERを選択すると、指定されているタイムアウト時間内にレプリケートされた更新の確認に失敗したサブスクライバのみにこのポリシーが適用されます。ALLを選択すると、いずれかのサブスクライバから応答がなかった場合、すべてのサブスクライバにこのポリシーが適用されます。この障害ポリシーは、RETURN RECEIPTまたはRETURN TWOSAFEサービスのいずれかで指定できます。詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスのタイムアウト・エラーおよびレプリケーション状態の変更の管理に関する項を参照してください。
DURABLE COMMIT {ON \| OFF}	DISABLE RETURNによりRETURNサービスのブロッキングが無効になった場合、データ・ストアのDurableCommits設定を上書きし、永続コミットを有効にします。
FAILTHRESHOLD Value	ディスク・ベースのロギングの場合、Valueには、サブスクライバ・データ・ストアのために累積できるログ・ファイルの数を指定します。この値を超えると、サブスクライバはFailedの状態に設定されます。ディスクレス・ロギングの場合、Valueには、ログ・バッファの割合を指定します。この値を超えると、サブスクライバ・データ・ストアはFailedの状態に設定されます。たとえば、しきい値が80の場合は、ログ・バッファが80%を超えて使用されると、サブスクライバ・データ・ストアがFailedの状態に設定されます。値0は、制限がないことを示します。この値がデフォルトです。詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のレプリケートされたデータ・ストアのログの管理に関する項を参照してください。
FullStoreName	次のいずれかとして指定されるデータ・ストアです。 · SELF · データ・ストア・ファイル名の接頭辞たとえば、データ・ストアのパスがdirectory/subdirectory/data.ds0の場合、データは使用対象のデータ・ストア名です。この名前は、DSNの記述のData Store Path and Name属性で指定されるデータ・ストア・ファイル名で、書式にはオプションでホストIDを指定できます。 DataStoreName [ON Host] HostにはIPアドレスまたは1つ以上のIPアドレスに割り当てられたリテラルのホスト名を指定できます。ホスト名に特殊文字が含まれている場合、"MyHost-500"のように二重引用符で囲む必要があります。（『Oracle TimesTen Replication - TimesTen to TimesTen 開発者および管理者ガイド』のホストIPアドレスの構成に関する項を参照してください）。ホスト名は30文字以下で指定します。
LOCAL COMMIT ACTION {NO ACTION \| COMMIT}	タイムアウト・イベントのRETURN TWOSAFEトランザクションで実行されるデフォルトのアクションを指定します。注意: この属性は、RETURN TWOSAFEまたはRETURN TWOSAFE BY REQUEST属性がSUBSCRIBER句で設定されている場合にのみ有効です。 NO ACTION: タイムアウト時、コミット関数がアプリケーションに戻り、トランザクションはコミット・コールに入ったときと同じ状態のままになります。ただし、アプリケーションがレプリケートされた表を更新できない場合を除きます。アプリケーションはコミットの再発行またはコールのロールバックを実行できます。 COMMIT: タイムアウト時に、コミット関数がCOMMITをログ・レコードに書き込み、トランザクションをローカルで効率よく終了します。同じトランザクション上でこれ以上の処理を行うことはできません。このデフォルト設定は、ttRepSyncSet()プロシージャのlocalActionパラメータをコールすることによって、特定のトランザクションに対して無効にすることができます。
MASTER FullStoreName	アプリケーションで特定のELEMENTが更新されるデータ・ストアです。MASTERデータ・ストアによって、更新がSUBSCRIBERデータ・ストアに送信されます。FullStoreNameは、DSNの記述のData Store Path and Name属性で指定されるデータ・ストアである必要があります。
NO RETURN	RETURNサービスを使用しないように指定します。この設定がデフォルトです。 RETURNサービスの使用の詳細は、『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のRETURNサービスの使用に関する項を参照してください。
PORT PortNumber	このデータ・ストアのレプリケーション・エージェントが接続をリスニングするTCP/IPポート番号です。指定しない場合は、レプリケーション・エージェントによってポート番号が自動的に割り当てられます。
PROPAGATOR FullStoreName	レプリケートされた更新を受け取り、他のデータ・ストアに渡すデータ・ストアです。FullStoreNameは、DSNの記述のData Store Path and Name属性で指定されるデータ・ストアである必要があります。

説明

CREATE ACTIVE STANDBY PAIRの直後には、2つのマスター・データ・ストア名が続きます。マスター・データ・ストアは、後でttRepStateSetプロシージャによってACTIVEおよびSTANDBYとして指定されます。『Oracle TimesTen Replication - TimesTen to TimesTen開発者および管理者ガイド』のアクティブ・スタンバイ・ペアの管理に関する章のアクティブ・スタンバイ・ペアの設定の項を参照してください。

· SUBSCRIBER句には、1つ以上の読取り専用サブスクライバ・データ・ストアを指定します。サブスクライバ・データ・ストアの数は、無制限に指定できます。

アクティブ・マスター・データ・ストアとスタンバイ・マスター・データ・ストアの間のレプリケーションは、RETURN TWOSAFE、RETURN RECEIPTまたは非同期のいずれかに設定できます。RETURN TWOSAFEに設定すると、トランザクションは失われません。

アクティブ・スタンバイ・ペアを作成する際に、INCLUDE句およびEXCLUDE句を使用して、表およびキャッシュ・グループをデータ・ストアに追加または削除します。

例13.22

この例では、マスター・データ・ストアがrep1およびrep2のアクティブ・スタンバイ・ペアを作成します。サブスクライバrep3が1つあります。レプリケーションのタイプはRETURN RECEIPTです。また、この文では、PORTおよびTIMEOUT属性をマスター・データ・ストアに対して設定します。

CREATE ACTIVE STANDBY PAIR rep1, rep2 RETURN RECEIPT 
SUBSCRIBER rep3 
STORE rep1 port 21000 timeout 30 STORE rep2 port 22000 timeout
30;