リポジトリを作成する前に、mwrepユーザーへの接続を作成する必要があります。Connectionsタブで、「Connections」を右クリックし、「New Connection」を選択します。 New / Select Database Connectionウィンドウが表示されます。

注： Connectionsタブが表示されていない場合は、「View」→「Connections」の順に選択してください。

Connection Nameフィールドにmwrep_orcl（または使用する接続を識別するその他の任意の名前）、UsernameフィールドおよびPasswordフィールドにmwrepを入力します。「Save Password」チェック・ボックスを選択します。 Hostnameフィールドに<hostname>、SIDフィールドにorclを入力します。「Test」をクリックします。

左下（Helpボタンの上）に表示される接続ステータスを確認します。 Successと表示されている必要があります。接続を保存するには、「Connect」をクリックします。ウィンドウを閉じます。

接続が保存され、ConnectionsタブのConnectionsの下に表示されます。

「mwrep_orcl」接続を右クリックし、「Migration Repository」→「Associate Migration Repository」の順に選択します。

進捗ウィンドウが表示されます。

リポジトリが作成されたら、「Close」をクリックします。

「OK」をクリックします。

「Migration」→「Third Party Database Offline Capture」→「Load Database Capture Script Output」の順に選択します。

Captureディレクトリを参照して「sybase15.ocp」ファイルを選択します。

オブジェクトが取得されます。取得が完了したら、「Close」をクリックします。

Sybase15はCaptured Modelsタブにリストされます。 「Sybase15」を展開します。

「dbo」を展開して、取得されたオブジェクトのリストを表示します。

「Tools」→「Preferences」の順に選択します。

「Migration」を展開して「Identifier Options」を選択します。

"Is Quoted Identifier On"が選択されていないことを確認します。 Sybase pubs2データベースでは二重引用符が文字列リテラルとして認識されるためです。 これを正しく設定しないと、プロシージャ、トリガーおよびビューの変換が失敗することがあります。「OK」をクリックします。

取得したモデル「Sybase15」を右クリックし、「Convert to Oracle Model」を選択します。

Set Data Mapウィンドウが表示されます。ここには、ソース・データ型と、Oracleモデルで変換された後の型が表示されます。「Apply」をクリックします。

変換が実行されます。変換が完了したら、「Close」をクリックします。

Converted Modelsタブにリストされている「Converted:Sybase15」を展開します。

「dbo_pubs2」を展開し、変換されたオブジェクトを表示します。

Converted Modelナビゲータで「Converted:Sybase15」を選択し、「dbo_pubs2」を展開します。

「Procedures」を展開し、「expectedToFail」を選択します。 Migration Log - Logタブには、変換中に発生したエラーと警告のリストが含まれています。

「Failed To Convert Stored Procedure」エラーを右クリックし、「View Details」を選択します。

この例では、問題がありそうな構文の特定に役立つ行の詳細が、エラー・メッセージに含まれています。 すべてのエラーにこのような情報が含まれているわけではありません。 このチュートリアルではこの情報を無視しますが、実際の移行時にはこの情報が役立ちます。「OK」をクリックします。

ここでエラーを修正します。 expectedToFailファイルの内容をコピーして、「Migration」→「Translation Scratch Editor」の順に選択します。

「Scratch Editor」をダブルクリックしてエディタを拡大します。

2つのテキスト・ボックスを調節します。

expectedToFailファイルからコピーしたテキストを、Enter 3rd Party SQL:テキスト・ボックスに入力します。

ドロップダウン・リストをクリックして、「Sybase T-SQL To PL/SQL」を選択します。

「Translate」アイコンをクリックします。

予想どおりのエラーが発生します。「OK」をクリックします。

DDLの文および句をコメント・アウトし、問題のある文または句が判明するまで変換を繰り返します。 問題の特定が困難な場合は、こちらを参照してください。

感嘆符（!）と等号（=）の間の空白が認識されませんでした。 空白を削除するのが手っ取り早い解決方法ですが、あらゆる問題に対応できるより包括的な方法では、TODOコメントで句をコメント・アウトします。 その後、Oracleに移行してから手動でTODOコメントを置き換えます。

Generated PL/SQL:テキスト・ボックスの内容を選択してコピーします。

「Scratch Editor」タブをダブルクリックします。

「expectedToFail」ファイルをクリックします。

「Edit」アイコンをクリックします。

コピーした内容を、新しく開いたexpectedToFailタブに貼り付けます。

コメント・アウトしたwhere句が表示されるまで下にスクロールします。

TODOコメントを解決します。 コメントを削除して、where句を以下のように変更します。

where lower(title) != v_title;

「Save」ボタンをクリックします。

変換に失敗したオブジェクトは、生成スクリプトに自動的に配置されません。 そのため、変換されていないT-SQLをOracleデータベースに対して実行する処理は停止します。 expecteToFailプロシージャが生成スクリプトに追加されるようにするには、環境設定を設定する必要があります。「Tools」→「Preferences」の順に選択します。

「Migration」を展開して「Generation Options」を選択します。

「Generate Failed Objects」チェック・ボックスを選択して「OK」をクリックします。

Migration Log - Logタブで、「Multiple Limitations...」というメッセージをダブルクリックします。

変換されたプロシージャ（expectLimitations）が以下の行の位置で開きます。

/*TODO:SET QUOTED_IDENTIFIER OFF*/

「Edit」アイコンをクリックします。 新しいexpectLimitationsタブが開きます。

Oracleにはこの文に相当するものがないため、変換は不要です。 TODOコメントを削除します。「Save」をクリックします。

「Translation Limitation 'VALID_NAME' encountered」をダブルクリックします。

変換されたプロシージャ（expectLimitations）が以下の行の位置で開きます。

SELECT VALID_NAME(v_identifierName)

「Edit」アイコンをクリックします。

VALID_NAMEはSybaseのシステム・ファンクションです。 変換の制限事項は、このファンクションが自動変換されていないことを知らせています。 VALID_NAMEファンクションを移行する最善の方法は変換の担当者が決定できます。

このチュートリアルでは、後から実装できるVALID_NAMEファンクションをsybase_utilitiesパッケージに作成します。

VALID_NAME(v_identifierName)の前に、テキストsybase_utilitiesを追加します。

ファイルを保存します。 sybase_utilitiesパッケージは、Oracleデータベースで作成した後に更新します。

「Converted:Sybase15」を右クリックして「Generate」を選択します。

Oracle SQLが生成されます。生成されたら、「Close」をクリックします。

スクリプトのSQLが表示されます。 右のドロップダウンから「system_orcl」を選択します。

「Run Script (F5)」をクリックします。

スクリプトを実行した結果が表示されます。

スクリプトが正常に実行されたので、dbo_pubs2ユーザーへの接続を作成できます。「Connection」を右クリックして「New Connection」を選択します。

Connection Nameフィールドにdbo_pubs2_orcl（または使用する接続を識別するその他の任意の名前）、UsernameフィールドおよびPasswordフィールドにdbo_pubs2を入力します。「Save Password」チェック・ボックスを選択します。 Hostnameフィールドに<hostname>、SIDフィールドにorclを入力します。「Test」をクリックします。

左下（Helpボタンの上）に表示される接続ステータスを確認します。 Successと表示されている必要があります。接続を保存するには、「Connect」をクリックします。ウィンドウを閉じます。

「dbo_pubs2_orcl」接続を展開します。

「Tables」を展開します。

Oracleに変換されたデータベース表がリストされます。「AUTHORS」表を選択します。

「Data」タブを選択します。 現在は表にデータが含まれていないことを確認してください。 データは後から移行します。

「Tools」→「Preferences」の順に選択します。

「Migration」を展開して「Data Move Options」を選択します。

Date Maskを以下のように変更します。 これはSybaseのSMALLDATETIME列に使用されます。

Mon dd yyyy HH:mi:ssAM

Timestamp Maskを以下のように変更します。 これはSybaseのDATETIME列に使用されます。

Mon dd yyyy HH:mi:ss:ff3AM

「OK」をクリックします。

注： SybaseのDATETIME値の認識にはTIMESTAMPが使用されますが、データ・ロード中は必要に応じて暗黙的にDATEに変換されます。

DOSコマンド・プロンプトを開いて、次のコマンドを実行します。

<prompt> cd <location where files are>

<prompt> oracle_ctl

ファイルは、前提条件の項で解凍したファイルが存在するDataディレクトリにあります。

oracle_ctlは、データをロードするための文が含まれるbatファイルです。 データのロードにはsqlldrが使用されます。

コマンドは正常に実行されます。

Oracle SQL Developerに切り替えて、接続を更新します。 表のデータが正しくロードされています。

Connectionsナビゲータで「Procedures」ノードを展開し、「EXPECTLIMITATIONS」を選択します。

「EXPECTLIMITATIONS」を右クリックして、「Compile」を選択します。

Compiler - Logタブにいくつかのエラーが表示されます。 VALID_NAMEはまだ定義されていません。 手動で作成する必要があります。

Packagesの下にある「Sybase_Utilities」ノードをダブルクリックします。 Sybase_Utilitiesが新しいタブで開きます。

以下のファンクションを追加します。

FUNCTION valid_name(p_identifierName IN VARCHAR2) RETURN NUMBER;

「Compile」アイコンをクリックします。

「Sybase_Utilities Body」ノードをダブルクリックします。

「Edit」アイコンをクリックします。

ファンクションに以下の定義を追加します。

FUNCTION valid_name(p_identifierName IN VARCHAR2)
RETURN NUMBER
IS
BEGIN
/*TODO: write logic*/
RETURN 1;
END valid_name;

「Compile」アイコンをクリックします。

「EXPECTLIMITATIONS」タブをダブルクリックします。

「Compile」アイコンをクリックします。 プロシージャは正しくコンパイルされます。

Proceduresノードの下で「DYNAMICSQL」プロシージャを選択します。

以下のT-SQLが、変換済みのプロシージャ内にまだ存在しています。 TOP n構文はOracleでは無効であるため、変換が必要です。

EXECUTE IMMEDIATE 'SELECT TOP 10 ' || v_selectList || ' FROM ' || v_tableName || ' WHERE ' || v_condition;

select文をコピーして、Translation Scratch Editorを開きます（「Migration」→「Translation Scratch Editor」）。

ドロップダウン・リストから「Sybase T-SQL To PL/SQL」を選択します。

コピーしたテキストを、Enter 3rd Party SQL:テキスト・ボックスに入力します。

文を修正し、有効な"ダミー"のT-SQL文を作成します。 この文は有効なSybase T-SQLである必要があります。 以下に示すテキストを使用できます。「Translate」アイコンをクリックします。

SELECT TOP 10 dummylist/* v_selectList*/
FROM dummyTableName /*' || v_tableName || '*/
WHERE dummyCondition = 1 /*' || v_condition;*/

変換されたPL/SQLが右側のウィンドウに表示されます。 これは、OracleでエミュレートできるSybase T-SQLのTOP n句の処理を、ROWNUM条件を使用して定義するのに役立ちます。

上記の変換を使用して、動的SQLを以下のように作成し直します。

' SELECT '|| v_selectList ||
' FROM ' || v_tableName ||
' WHERE ' || v_condition ||
' AND ROWNUM <= 10';
       

DYNAMICSQLタブで「Edit」アイコンをクリックします。

コピーしたテキストを置き換えます。 これは動的問合せであるため、結果セットを戻す必要がある点に注意してください。 完全なプロシージャは以下を参照してください。 正しく変更したら、「Compile」アイコンをクリックします。

プロシージャは正しくコンパイルされます。