6 クラウド移行前アドバイザ・ツールの使用
クラウド移行前アドバイザ・ツール(CPAT)は、移行前にOracle Autonomous Databaseとの互換性を確保するために、既存のOracleデータベースを評価するのに役立ちます。CPATは、潜在的なユーザー・アクションを識別し、その重要度に優先順位をつけて解決策を提案します。Oracle Cloudへの移行を早めるために、CPATを使用することをお薦めします。
CPATの詳細は、My Oracle Supportの「Analyzes Databases for Suitability of Cloud Migration」(ドキュメントID 2758371.1)を参照してください。
SQLclを使用して、MIGRATEADVISOR
コマンドを使用してCPATを実行できます。
トピック
6.1 概要
SQLclでMIGRATEADVISOR
コマンドを使用すると、次のことができます。
-
Oracleデータベースを一般的な自律型または特定のインスタンスに分析し、Oracle Cloudへの移行を成功させるために推奨されるアクションを特定したレポートを作成します。レポートは、HTML、テキストまたはJSON形式で生成できます。
-
オプションで、自律インスタンスに固有の詳細を提供するターゲット・プロパティ・ファイルを生成します。
次のイメージは、HTML形式のCPATレポートを示しています。
CPATの概念
CPATでのソース分析は、様々なクラウド・タイプに対して汎用的に実行されます。
- ATPS (共有インフラストラクチャでの自律型トランザクション処理)
- ATPD (専用インフラストラクチャでの自律型トランザクション処理)
- ADWS (共有インフラストラクチャでの自律型データ・ウェアハウス)
- ADWD (専用インフラストラクチャでの自律型データ・ウェアハウス)
- デフォルト(Oracle Database)
ソース分析は、SQL文として実行される一連のテストで構成されます。テストの範囲は、次の3つのカテゴリに分類されます。
- SCHEMA: スキーマ内のデータにのみ適用されるチェック。たとえば、表では非推奨およびサポート対象外の機能の使用がチェックされます。
- INSTANCE: データベース・インスタンス全体にのみ適用されるチェック。たとえば、
V$PARAMETER
表の特定のパラメータおよび値がチェックされます。 - UNIVERSAL: 常に実行されるチェック。
ソース分析はFULLモード、SCHEMAモードまたはFULL SCHEMAモードで実行できます。
- FULL: (デフォルト)すべての適切なスキーマで適用可能なすべてのチェックを実行します。SCHEMA、INSTANCEおよびUNIVERSALスコープ・チェックが実行されます。
- SCHEMA: コマンドラインおよびUNIVERSALチェックで指定されたスキーマに適用可能なすべてのチェックを実行します。INSTANCEスコープ・チェックは実行されません。
- SCHEMA FULL: コマンドラインで指定されたスキーマ、およびUNIVERSALとINSTANCEチェックで指定されたスキーマに適用可能なすべてのチェックを実行します。
6.2 前提条件
migrateadvisor
コマンドを使用するための前提条件は次のとおりです。
-
Oracle Database 11gリリース2以降のバージョンがサポートされています。
-
PROPERTIES
コマンドは、接続ユーザーにSELECT ANY DICTIONARY
権限が付与されている場合にのみ使用できます。 -
ADVISE
コマンドは、接続されたユーザーに次の権限が付与されている場合にのみ使用できます。SELECT ANY DICTIONARY
権限SYSTEM.DUM$COLUMNS
およびSYSTEM.DUM$DATABASE
にアクセスするためのSELECT
権限ノート:
DUM$表へのアクセスが必要なのは、ソースとターゲットの文字セットでOracle Database Migration Assistant for Unicode (DMU)が必要であることが示されている場合のみです。
6.3 MIGRATEADVISORコマンドについて
CPATコマンドは、ma
またはmigrateadvisor
を使用してSQLclで実行できます。
このコマンドには、次のサブコマンドがあります:
- Properties: インスタンス固有の分析を提供するOracleまたはAutonomous Databaseのターゲット・プロパティ・ファイルを生成します。
- Advise: データベースを分析し、正常な移行に役立つ情報を含むレポートを生成します。
- Info: CPATのバージョン情報を表示します。
構文
migrateadvisor help [examples|syntax] |
advise {{-targettype,-t} {ATPS|ATPD|ADWS|ADWD|DEFAULT} } [<-optional-argument>,...] |
properties [<optional-argument>,...] |
info
次の表に、advise
の必須引数およびオプション引数を示します。
引数 | 説明 | デフォルト |
---|---|---|
必須 | ||
-targettype,-t |
移行用に分析するターゲット・データベースのタイプ。 |
なし |
オプション | ||
-analysisprops,-a |
<propertyFile> プロパティ・ファイルのパスと名前。 ノート: フルパスはオプションです。フルパスが指定されていない場合、 ターゲット・データベースへの接続中にpropertiesサブコマンドを使用して作成されたプロパティ・ファイル。 |
なし |
-excludeschemas,-x |
<schema>[,...] 分析から除外するスキーマのスキーマまたはカンマ区切り値リスト。 |
なし |
-full, -f |
すべてのテスト・セットを実行します。 |
-schemasが指定されていない場合はFALSE、それ以外の場合のデフォルトはTRUE |
-maxrelevantobjects,-m |
<maxRelevantObjects> すべてのレポートに含められる「関連オブジェクト」の最大数。 このオプションは、TEXTレポートの-maxtextdatarowsをオーバーライドします。 |
すべてのオブジェクトを含む |
-maxtextdatarows,-n |
<maxTextDataRows> テキスト・レポートに含める関連オブジェクト行(JSONレポートには適用されません)。 |
-maxrelevantobjects (指定されている場合)、それ以外の場合はすべての関連オブジェクトが含まれます。 |
-migrationmethod,-mm |
移行に使用するメソッドまたはツールのカンマ区切り値リスト。例: DATAPUMP, GOLDENGATE |
DATAPUMP |
-outdir,-o |
<directory> ログ・ファイルおよびレポート・ファイルの場所を識別します。 |
現在のSQLclディレクトリ |
-outfileprefix,-p |
<outFilePrefix> 標準のベース・ファイル名"premigration_advisor_report"の接頭辞。 |
接頭辞なし |
-reportformat,-r |
1つ以上の<reportFormats>を指定します。<reportFormat>はHTML、JSONまたはTEXTです。 |
HTML |
-schemas,-s |
<schema>[,...] 分析するスキーマまたはスキーマのカンマ区切り値リスト。例: schema1, schema2 |
すべてのスキーマ |
-sqltext,-q | チェックに使用されるSQL問合せをTEXTレポートに含めます。 | TEXTレポートにSQLテキストを含めないでください。JSONレポートでは無視されます。 |
-verbose,-ve |
TRUEは追加の診断出力を表示します。 |
FALSE |
次の表に、properties
のオプション引数を示します。
引数 | 説明 | デフォルト |
---|---|---|
-outdir,-o |
<directory> ログ・ファイルおよびレポート・ファイルの場所を識別します。 |
現在のSQLclディレクトリ |
-outfileprefix,-p |
<outFilePrefix> 標準のベース・ファイル名"premigration_advisor_report"の接頭辞。 |
接頭辞なし |
6.4 例
次の例では、MIGRATEADVISOR
コマンドを使用する方法について説明します。
例1
Autonomous Databaseのターゲット・プロパティ・ファイルを生成します。
-- Set default directory
SQL> cd <directory>
-- Connect to target
SQL> set cloudconfig <config-file>
SQL> connect <autonomous-connect-string>
-- Generate the properties file
SQL> migrateadvisor properties -outfileprefix cloud
例2
ターゲット・プロパティを使用して、単一スキーマのHTMLアドバイザ・レポートを作成します。
-- Set default directory
SQL> cd <directory>
-- Connect to source
SQL> connect <database-connect-string>
-- Generate the report
SQL> migrateadvisor advise -schemas hr -outfileprefix hr -targettype adws -analysisprops <propertyFile>
例 3
ターゲット・プロパティを使用して、データベース全体のHTMLアドバイザ・レポートを作成します。
-- Set default directory
SQL> cd <directory>
-- Connect to source
SQL> connect <database-connect-string>
-- Generate the report
SQL> migrateadvisor advise -outfileprefix fulldb -targettype adws -analysisprops <propertyFile>
例4
スキーマを除くJSONアドバイザ・レポートを作成します。
-- Set default directory
SQL> cd <directory>
-- Connect to source
SQL> connect <database-connect-string>
-- Generate the report
SQL> migrateadvisor advise -excludeschemas hr,sales -outfileprefix xschemas -targettype adws -reportformat json
例5
インスタンス・テストを含む複数のスキーマのHTMLアドバイザ・レポートを作成します。
-- Set default directory
SQL> cd <directory>
-- Connect to source
SQL> connect <database-connect-string>
-- Generate the report
SQL> migrateadvisor advise -schemas hr,sales -full -outfileprefix fullmulti -targettype adws -analysisprops <propertyFile>
例6
ターゲット・プロパティを使用してOracleデータベースに移行するための単一スキーマ用のHTMLアドバイザ・レポートを作成します。
-- Set default directory
SQL> cd <directory>
-- Connect to target
SQL> connect <database-connect-string>
-- Generate the properties file
SQL> migrateadvisor -gettargetproperties -outfileprefix cloud
-- Connect to source
SQL> connect <database-connect-string>
-- Generate the report
SQL> migrateadvisor advise -schemas hr -outfileprefix ora -targettype adws -analysisprops <propertyFile>
6.5 ヒントとトラブルシューティング
次の点に注意してください。
-
ソースがAutonomous Databaseの場合、
ADVISE
コマンドの実行はCPATの使用がサポートされていないため、予測できない可能性があります。 -
PROPERTIES
およびADVISE
コマンドでは、接続ユーザーにSELECT ANY DICTIONARY
権限が必要です。SELECT ANY DICTIONARY
権限がない場合は、次のエラーが表示されます。SQL> grant connect, resource, unlimited tablespace to jdoe identified by jdoe; Grant succeeded. SQL> connect jdoe/jdoe Connected. SQL> migrateadvisor advise -schemas hr -outfileprefix pre -targettype adws -reportformat json CPAT-1004: SQL error while initializing premigration application. ORA-00942: table or view does not exist –-Ensure the JDBC connection information is correct. See the log file for more details. Additional Information: 255: Internal error - please contact support. **Exception** : /Users/xyz/pre_premigration_advisor_report.json Log file contains: Caused by: Error : 942, Position : 20, Sql = SELECT VERSION FROM V$INSTANCE, OriginalSql = SELECT VERSION FROM V$INSTANCE, Error Msg = ORA-00942: table or view does not exist