Oracle GoldenGateユーザー・イグジットの使用の詳細は、『Oracle GoldenGateの管理』を参照してください。
トピック:
EXIT_CALL_TYPE
では、処理中にいつExtractまたはReplicatプロセス(コール元)がユーザー・イグジット・ルーチンをコールするかを指定します。プロセスは、次のコールを使用してルーチンをコールできます。
表8-1 ユーザー・イグジット・コール
コール・タイプ | 処理ポイント |
---|---|
|
|
|
次のいずれかの直前にコールされます。
|
|
ExtractまたはReplicatチェックポイントが書き込まれた直後にコールされます。 |
|
Extractの処理中に、ASCII入力レコードが破棄ファイルに書き込まれる前にコールされます。関連するASCIIバッファは、コールバック・ルーチンを使用してユーザー・イグジットによって取得および操作できます。 このコール・タイプは、Replicatプロセスでは使用できません。 |
|
Replicatの処理中に、レコードが破棄ファイルに書き込まれる前にコールされます。レコードは、Oracle GoldenGate変更レコードの値がターゲット表の現在のバージョンと異なっているときなど、複数の理由で破棄されます。関連する破棄バッファは、コールバック・ルーチンを使用してユーザー・イグジットによって取得および操作できます。 このコール・タイプは、Extractプロセスでは使用できません。 |
|
次のいずれかの直後にコールされます。
|
|
ExtractまたはReplicatの処理中に致命的なエラーが発生後、Oracle GoldenGateが停止する直前にコールされます。 |
|
Replicatの処理中に、NonStopサーバーのマーカーがトレイルから読み取られ、マーカー履歴ファイルに書き込まれる前にコールされます。 |
|
このコールは、ほとんどのユーザー・イグジット処理の基盤です。 |
|
処理開始時にコールされます。ユーザー・イグジットは、ファイルのオープンや変数の初期化などの初期化作業を実行できます。 |
|
プロセスが正常に停止または異常終了する前にコールされます。ユーザー・イグジットは、ファイルのクローズや合計の出力などの完了作業を実行できます。 |
|
各イグジット・コールの完了時に、コール元にレスポンス方法を指示するためにユーザー・イグジット・ルーチンによって設定されます。 |
適用対象
ExtractおよびReplicat
説明
SET_SESSION_CHARSET
ファンクションでは、ユーザー・イグジットのキャラクタ・セットを設定します。ユーザー・イグジット・セッションのキャラクタ・セットは、次のような(ただしこれらに限定されません)メタデータなど、ユーザー・イグジットとコール元プロセス(Extract、データ・ポンプ、Replicat)間で使用される文字ベースのコールバック構造メンバーのエンコーディングを示します。
データベースの名前およびロケール
表名および列名
DDLテキスト
エラー・メッセージ
CHAR
およびNCHAR
などの文字型の列
文字列形式で表される日時および数値の列
このファンクションは、ユーザー・イグジットが制御しているときはいつでも呼び出すことができます。ユーザー・イグジットがセッションのキャラクタ・セットを設定すると、すぐに有効になり、すべての文字値は指定したセットへの変換を開始します。このファンクションを呼び出すには、コール・タイプEXIT_CALL_START
を使用することをお薦めします。
注意:
SET_SESSION_CHARSET
はスレッドセーフではありません。
SET_SESSION_CHARSET
が呼び出されない場合、セッションは、ucharset.h
ファイルのULIB_CS_DEFAULT
の事前定義された列挙型の値であるオペレーティング・システムのデフォルトのキャラクタ・セットに設定されます。セッションのキャラクタ・セットがULIB_CS_DEFAULT
からのデフォルトである場合、ユーザー・イグジットとコール元プロセス間で交換される文字型の値に対して、Oracle GoldenGateでは変換は実行されません。さらに、データベースのオブジェクト名のメタデータは、オペレーティング・システムのデフォルトのキャラクタ・セットであるとみなされます。デフォルトは適切ではない場合があることに注意してください。
ユーザー・イグジットがロードされ、SET_SESSION_CHARSET
が呼び出されると、ユーザー・イグジットのキャラクタ・セットはレポート・ファイルに出力されます。セッションのキャラクタ・セットがULIB_CS_DEFAULT
である場合、列データのキャラクタ・セットの変換が実行されないことを示すメッセージが表示されます。
グローバリゼーション・サポートの詳細は、『Oracle GoldenGateの管理』を参照してください。
構文
#include usrdecs.h short result_code; session_def session_charset_def; ERCALLBACK (SET_SESSION_CHARSET, &session_charset_def, &result_code);
バッファ
typedef struct { ULibCharSet session_charset; } session_def;
出力
なし
返される値
EXIT_FN_RET_OK