SharePlex 11.4 - リファレンス・ガイド

create_ignore.sql

説明

create_ignore.sqlユーティリティスクリプトは、DMLトランザクションがターゲットシステムにレプリケートされないようにするために使用します。このスクリプトは、ソースデータベースにSHAREPLEX_IGNORE_TRANSというパブリックプロシージャを作成します。このプロシージャをトランザクションの開始時に実行すると、Captureプロセスは、実行時点から行われるDML操作をトランザクションがコミットまたはロールバックされるまで無視します。そのため、影響を受ける操作は複製されません。

SHAREPLEX_IGNORE_TRANSプロシージャの影響を受けるのはDML操作のみです。SharePlexにTRUNCATEを含むDDL操作をスキップさせることはありません。DDL操作はOracleによって暗黙的にコミットされるため、プロシージャは無効になります。

サポート対象データベース

Unix上のOracle

create_ignore.sqlの実行

SharePlexの製品ディレクトリのutilサブディレクトリからcreate_ignore.sqlスクリプトを実行します。プロシージャがSharePlexスキーマに作成されるように、SharePlex Oracleユーザとして実行します。

スクリプトは以下のPL/SQLを実行します。

CREATE OR REPLACE PROCEDURE SHAREPLEX_IGNORE_TRANS AS

TNUM NUMBER;

BEGIN

INSERT INTO SHAREPLEX_TRANS (TRANS_NUM, QUE_SEQ_NO_1, QUE_SEQ_NO_2,

COMBO, OP_TYPE) VALUES (-999,0,0,'DUMMY',0);

DELETE FROM SHAREPLEX_TRANS WHERE TRANS_NUM=-999 AND COMBO='DUMMY'

AND OP_TYPE=0;

END;

/

GRANT EXECUTE ON SHAREPLEX_IGNORE_TRANS TO PUBLIC;

/

SHAREPLEX_IGNORE_TRANSの実行

SHAREPLEX_IGNORE_TRANSは、レプリケートしたくない操作を含むトランザクションの開始時にのみ呼び出してください。このプロシージャをトランザクションの途中で呼び出すと、プロシージャの開始前にレプリケートされた操作は、postキューに無期限に残り、COMMITを待つことになります。SharePlexはCOMMITがなければメッセージをリリースしないからです。Captureは、プロシージャが呼び出された後のトランザクション内のすべての操作を無視するため、COMMITは到着しません。Readプロセスは、それらのレコードの不要なキャッシュ情報を無期限に保持することになります。

1. SQL*PlusにSharePlexユーザとしてログオンします。

2. スキップしたいトランザクションの先頭でSHAREPLEX_IGNORE_TRANSプロシージャを実行します。

   execute SharePlex_schema.SHAREPLEX_IGNORE_TRANS;

3. 1つのトランザクションで、レプリケートしたくない変更を行います。Captureはこれらを無視します。
4. COMMITまたはROLLBACKの後、後続のトランザクションのレプリケーションは正常に再開されます。

hana_cleansp

説明

SharePlexがHANAターゲットにレプリケートしているシステム上の現在のレプリケーション状態を削除するには、hana_cleanspユーティリティを使用します。

警告: hana_cleanspの結果は元に戻すことはできません。レプリケーションを初期状態に戻さずに停止するには、abort configコマンド、またはpurge configコマンドを使用できる場合があります。

使用ガイドライン

• このユーティリティを使用するには、Korn（ksh）シェルがシステムにインストールされていなければなりません。ユーティリティは処理中にこのシェルを呼び出します。

• hana_cleanspは、レプリケーション設定内のすべてのHANAターゲットシステムで実行する必要があります。
• レプリケーション環境を完全に削除するには、ora_cleanspユーティリティをレプリケーション設定内のすべてのOracleソースシステム上で実行します。hana_cleansp、またはora_cleanspがシステム上で実行されたかどうか、またいつ実行されたかを確認するには、そのシステムのSharePlexイベントログを表示します。

このユーティリティの機能

hana_cleanspは、ターゲットシステムで以下の処理を実行します。

• SharePlexスキーマ内のSHAREPLEX_OPEN_TRANS内部テーブルと、SharePlexがインストールしたその他のテーブル（該当する場合）を切り捨てます。
• 変数データディレクトリから、キューファイル、プロセス・ログ・ファイル、statusdbの内容（ただしファイルは削除しない）、dumpおよびstateディレクトリの内容、イベントログの1つのエントリ（hana_cleanspのステータスエントリ）を除くすべてのエントリを削除します。

hana_cleanspは以下を保持します。

• SharePlexデータベース、アカウント、パスワード（SharePlexテーブルのデータのみを削除）
• paramdbやターゲットの設定など、ユーザが作成したファイル

サポート対象データベース

サポート対象プラットフォーム上のHANA

hana_cleanspを実行するには:

1. システム上のすべてのSharePlexプロセスを停止します。
2. sp_copを停止します。

3. SharePlex製品ディレクトリのbinサブディレクトリから、hana_cleanspユーティリティを以下の構文で実行します。

   C:\users\splex\bin>hana_cleansp [port number ] database_name/user_name

   ここで:

   • port numberはSharePlexインスタンスのポート番号です（デフォルトの2100以外の場合）。
   • database_nameはSharePlexデータベースの名前です。
   • user_nameはSharePlexユーザアカウントの名前です。

4. プロンプトでパスワードを入力します。

   Enter the password for the SharePlex User :

5. 「Y」と入力し、このSharePlexインスタンスのクリーンアップを実行することを確認します。

   Are you sure you want to perform the clean for '/splex/vardir/var2200' and port 2200? [N] : Y

mss_cleansp

説明

SQL Serverシステムの現在のレプリケーション状態を削除するには、mss_cleanspユーティリティを使用します。

mss_cleanspは、ターゲットシステムで以下の処理を実行します。

• SHAREPLEX_OPEN_TRANS内部テーブルと、SharePlexがインストールしたその他のテーブル（該当する場合）を切り捨てます。
• 変数データディレクトリから、キューファイル、プロセス・ログ・ファイル、statusdbの内容（ただしファイルは削除しない）、dumpおよびstateディレクトリの内容、イベントログの1つのエントリ（mss_cleanspのステータスエントリ）を除くすべてのエントリを削除します。

mss_cleanspは以下を保持します。

• SharePlexデータベース、アカウント、パスワード（SharePlexテーブルのデータのみを削除）
• paramdbやターゲットの設定など、ユーザが作成したファイル

サポート対象データベース

Microsoft SQL Server

mss_cleanspを実行するには:

1. システム上のすべてのSharePlexプロセスを停止します。
2. sp_copを停止します。

3. SharePlex製品ディレクトリのbinサブディレクトリから、mss_cleanspユーティリティを以下の構文で実行します。

   C:\users\splex\bin>mss_cleansp [port number ] database_name/user_name

   ここで:

   • port numberはSharePlexインスタンスのポート番号です（デフォルトの2100以外の場合）。
   • database_nameはSharePlexデータベースの名前です。
   • user_nameはSharePlexユーザアカウントの名前です。

4. プロンプトでパスワードを入力します。

   Enter the password for the SharePlex User :

5. 「Y」と入力し、このSharePlexインスタンスのクリーンアップを実行することを確認します。

   Are you sure you want to perform the clean for 'C:\splex\vardir\var2200' and port 2200? [N] :Y

mysql_cleansp

説明

MySQLシステムの現在のレプリケーション状態を削除するには、mysql_cleanspユーティリティを使用します。

警告: mysql_cleanspを実行することは、テスト環境やデモ環境では許容できますが、本番環境ではほとんど適切とは言えません。クリーンアップの結果は元に戻すことができません。

使用ガイドライン

• このユーティリティを使用するには、Korn（ksh）シェルがシステムにインストールされていなければなりません。ユーティリティは処理中にこのシェルを呼び出します。

• mysql_cleanspは、レプリケーション設定内のすべてのMySQLターゲットシステムで実行する必要があります。
• レプリケーション環境を完全に削除するには、ora_cleanspユーティリティをレプリケーション設定内のすべてのOracleソースシステム上で実行します。mysql_cleansp、またはora_cleanspがシステム上で実行されたかどうか、またいつ実行されたかを確認するには、そのシステムのSharePlexイベントログを表示します。

このユーティリティの機能

mysql_cleanspは、ターゲットシステムで以下の処理を実行します。

• SHAREPLEX_OPEN_TRANS内部テーブルと、SharePlexがインストールしたその他のテーブル（該当する場合）を切り捨てます。
• 変数データディレクトリから、キューファイル、プロセス・ログ・ファイル、statusdbの内容（ただしファイルは削除しない）、dumpおよびstateディレクトリの内容、イベントログの1つのエントリ（mysql_cleanspのステータスエントリ）を除くすべてのエントリを削除します。

mysql_cleanspは以下を保持します。

• SharePlexデータベース、アカウント、パスワード（SharePlexテーブルのデータのみを削除）
• paramdbやターゲットの設定など、ユーザが作成したファイル

サポート対象データベース

サポート対象のUNIXプラットフォーム上のMySQL

mysql_cleanspを実行するには:

1. システム上のすべてのSharePlexプロセスを停止します。
2. sp_copを停止します。

3. SharePlex製品ディレクトリのbinサブディレクトリから、mysql_cleanspユーティリティを以下の構文で実行します。

   C:\users\splex\bin> mysql_cleansp [port number ] database_name/user_name

   ここで:

   • port numberはSharePlexインスタンスのポート番号です（デフォルトの2100以外の場合）。
   • database_nameはSharePlexデータベースの名前です。
   • user_nameはSharePlexユーザアカウントの名前です。

4. プロンプトでパスワードを入力します。

   Enter the password for the SharePlex User :

5. 「Y」と入力し、このSharePlexインスタンスのクリーンアップを実行することを確認します。

   Are you sure you want to perform the clean for '/splex/vardir/var2200' and port 2200? [N] : Y