このマニュアルでは、Oracle GoldenGateをバージョン11gからバージョン12cへアップグレードする手順について説明します。この章では、そのプロセスの概要と、対応が必要なアップグレード前の考慮事項を示します。
この章の内容は次のとおりです。
Oracle GoldenGateへのアップグレードは、プロセスの制御やステータス情報の取得に必要なコマンドについて十分な知識を持つ管理者が行う必要があります。
アップグレード処理を実行する前に、Oracle GoldenGate for Windows and UNIXリリース・ノート(http://docs.oracle.com/goldengate/1212/gg-winux/GRLWU/index.html
)に目を通し、新しいリリースが構成に与える次のような影響を判断してください。
新しいデフォルトのプロセス動作。
変更された、または非推奨になったパラメータ。
必要な新機能またはデータベース・タイプをサポートするために追加されたパラメータ。
変更されたパラメータのデフォルト値。
TABLE
文またはMAP
文の変更が必要となる新しいデータ型のサポート。
データベースの変更が必要になるネイティブ・データベース・コンポーネントとの対話。
パラメータのすべての変更を事前に行ってプロセスの再起動時には準備が完了しているようにすることで、開始が遅れて進捗にずれが生じることを防げます。プロセスの実行中にパラメータを変更することはできませんが、次のことが可能です。
パラメータ・ファイルのコピーを作成します。
コピーを編集します。
アップグレード処理中にプロセスを停止した後、古いパラメータ・ファイルをコピーして新しい名前を付けます(バックアップ保存用)。
新しいパラメータ・ファイルをコピーして古いパラメータ・ファイルの名前を付けます。
注意: Oracle GoldenGateのインストールとともに提供されるサンプル・ファイルは、各アップグレードで上書きされます。オラクル社の配信したサンプル・ファイルを変更する場合は、変更したファイルが上書きされることで生じる問題を回避するため、コピーしてからファイルを変更することをお薦めします。 |
ReplicatパラメータTRAILCHARSET
は、バージョン12.1.2でSOURCECHARSET
という名前に変更されましたが、Oracle GoldenGateでは、エイリアスとしてTRAILCHARSET
のサポートを継続します。Oracle GoldenGateのアップグレード時には、TRAILCHARSET
をそのまま使用することも、SOURCECHARSET
に変更することも可能です。現時点では、Extractをアップグレードしない場合は、11.2.1より前のExtractからのキャラクタ・セット変換をサポートするために、どちらかのパラメータが必要です。ExtractとReplicatの両方をバージョン12.1.2にアップグレードする場合は、証跡にソース・キャラクタ・セットの情報が自動的に書き込まれるため、TRAILCHARSET
もSOURCECHARSET
も必要ありません。
バージョン12.1.2の時点で、Oracle GoldenGateでは、一重引用符に囲まれた文字列はリテラルとして扱われます。Oracle GoldenGateでは、バージョン11.2から、二重引用符で囲まれたオブジェクト名がサポートされていましたが、バージョン12まで、リテラルの一重引用符のルールが完全に実装されていませんでした。オブジェクト名の二重引用符、およびリテラルの一重引用符をサポートしたことで、Oracle GoldenGateがSQL-92ルールに準拠し、デフォルトで有効化されるようになりました。旧リリースでSQL-92標準の強制に使用されたUSEANSISQLQUOTES
パラメータは、非推奨になりました。
デフォルトのSQL-92ルールを変更すると、パラメータ・ファイルのオブジェクト名、SQLEXEC
句への入力、OBEY
ファイル、変換関数、ユーザー・イグジットおよびコマンドに影響します。この変更の結果、次のオプションができました。
Retain non-SQL-92 quote rules: SQL-92ルールに準拠しない現在のパラメータ・ファイルを保持できるよう、下位互換性が保たれます。SQL-92以外のルールを保持するには、アップグレードの実行前にNOUSEANSISQLQUOTES
パラメータをGLOBALS
ファイルに追加して、そのパラメータが継承されるようにします。NOUSEANSISQLQUOTES
は、Extract、Replicat、DEFGENおよびGGSCIに影響します。
Upgrade your parameter files to use SQL-92 rules: Oracle GoldenGateには、convprm
変換ツールが用意されており、パラメータ・ファイルがSQL-92ルールに準拠するよう変換するために実行できます。アップグレード・プロセスを開始する前に、convprm
ツールを実行してください。
convprm
ツールの概要次に、convprm
ツールについて説明します。
手動で実行することも、スクリプト化することも可能なコマンドライン・プログラムです。
文字列リテラルを、二重引用符で囲まれたキャラクタ文字列から、一重引用符で囲まれたキャラクタ文字列に変換しますが、二重引用符で囲まれたオブジェクト名はそのまま残ります。どちらも、二重引用符で区切られた連続する文字列として表されている場合でも、オブジェクト名と文字列リテラルが区別されます。
引用符がエスケープされます。文字列の区切りに使用される文字列が、リテラル文字列自体に含まれる場合は、引用符をエスケープする必要があります。たとえば、"This character "" is a double quote"という文では、引用符がエスケープされています。'This character '' is a single quote'という文では、一重引用符がエスケープされています。二重引用符から一重引用符に変換する際は、convprm
により、繰り返されている二重引用符の1つがエスケープされている二重引用符から削除され、文字列シーケンスに埋め込まれている一重引用符がエスケープされます。
GLOBALS
ファイルにNOUSEANSISQLQUOTES
が指定されている場合は、警告のメッセージが発行されます。メッセージの内容は、変換されたパラメータ・ファイルにはNOUSEANSISQLQUOTES
との互換性がないが、パラメータ・ファイルの更新は行われたというものです。
OBEY
またはINCLUDE
パラメータを使用して、含まれるファイルを繰り返し変換できます。
元のファイルと同じディレクトリに、初期パラメータ・ファイルのバックアップが作成されます。バックアップには、元のファイル名に.bck
という接尾辞が付きます。バックアップ・ファイルの作成は、convprm
ツールの実行時に無効化できます。
キャラクタ・セットが変換されます。新しいパラメータ・ファイルのキャラクタ・セットは、元のパラメータ・ファイルのCHARSET
パラメータから取得されます。そのパラメータがない場合、キャラクタ・セットは、GLOBALS
ファイルのCHARSET
パラメータから取得されます。GLOBALS
パラメータがない場合、新しいパラメータ・ファイルは、ローカル・オペレーティング・システムのキャラクタ・セットで記述されます。
表1-1に、変換結果の例を示します。
convprm
ツールの使用手順:
次の構文を使用してconvprm
を実行します。
convprm [options
]input_files
説明:
{-h | --help}
は、使用方法を表示します。
{-v |--version}
は、バージョン情報を表示します。
{-i | --follow-include}
は、OBEY
またはINCLUDE
パラメータを使用することで、含まれるファイルを繰り返し変換します。
{-n |--no-backup}
では、元のファイルのコピーは作成されません。
{-s | --silent}
では、ステータス・メッセージが表示されません。
{-q | --quotes}
では、引用符の変換が実行されます。これはデフォルトです。
{-d | --dry-run}
では、パラメータ・ファイルの変更やバックアップ・ファイルの作成は行われません。変換の結果、どのようになるかが出力されるのみです。
input_files
は、変換されるパラメータ・ファイルのリストです。次に示すように、各ファイル名は空白で区切られます。
convprm [options
] extfin extacct exthr
パラメータ・ファイルを調べて、変換が正常に行われたことを確認してください。ファイルの変換プロセスの最初、途中または最後に、ステータス・メッセージが表示されます。
エラーが発生すると、その他のOracle GoldenGateの実行可能ファイルと同じように、プロセスが異常終了します。コンバータの失敗原因となったすべてのエラー・メッセージが、Oracle GoldenGateエラー・ログに送信されます。
USEANSISQLQUOTES
パラメータを使用している場合は、削除するか、そのままパラメータ・ファイルに残してください。現在は、これがデフォルトです。