CPAT で ADB のプロパティファイルを取得する⭕

Cloud Premigration Advisor Tool (以降、CPAT) に関する前回の投稿でスキップしていたターゲット・インスタンスプロパティモードを試すとともに、ソース・インスタンス分析モードのアウトプットにどのような違いがあるか確認します。

前回の投稿：

CPAT を実行する環境にターゲットADB のクレデンシャル・ウォレットを DL し、--gettargetpropsを指定して CPAT を実行すると、premigration_advisor_analysis.properties と premigration_advisor.log が作成されます。

[oracle@handson-vm01 cpat]$ ./premigration.sh --gettargetprops -username ADMIN --connectstring 'jdbc:oracle:thin:@freeatp_medium?TNS_ADMIN=/home/oracle/Wallet_freeatp'
Enter password for ADMIN user:
PremigrationException
CPAT-1018: Informational: The amount of memory available to CPAT is 3490 MB. Oracle recommends running CPAT using a 64-bit JVM on a system with at least 8 GB of memory.
Increase the memory by setting _JAVA_OPTIONS=-Xmx4g or higher if additional memory is available.

Cloud Premigration Advisor Tool Version 26.1.0

Cloud Premigration Advisor Tool generated properties file location: /home/oracle/cpat/premigration_advisor_analysis.properties
[oracle@handson-vm01 cpat]$ ls -la
total 84
drwxrwxrwx. 5 root   root      4096 Feb  5 13:55 .
drwx------. 8 oracle oinstall  4096 Feb  5 13:50 ..
drwxr-xr-x. 2 root   root        59 Jan 30 14:37 bin
drwxr-xr-x. 2 root   root      4096 Jan 30 14:49 lib
-rw-r--r--. 1 root   root      6069 Jan 30 14:37 LICENSE.txt
drwxr-xr-x. 2 root   root        35 Jan 30 14:49 misc
-rw-r--r--. 1 oracle oinstall  8622 Feb  5 13:55 premigration_advisor_analysis.properties  ★
-rw-r--r--. 1 oracle oinstall 16567 Feb  5 13:55 premigration_advisor.log  ★
-rw-r--r--. 1 root   root       139 Jan 30 14:37 premigration.cmd
-rwxr-xr-x. 1 root   root     10519 Jan 30 14:37 premigration.sh
-rw-r--r--. 1 root   root      2766 Jan 30 14:49 README.txt
-rw-r--r--. 1 root   root     11533 Jan 30 14:49 THIRD_PARTY_LICENSES.txt
[oracle@handson-vm01 cpat]$

premigration_advisor_analysis.properties を参照すると、ターゲットADB の保有スキーマなど様々な情報が記載されていることがわかります。

[oracle@handson-vm01 cpat]$ cat premigration_advisor_analysis.properties
#Created by CPAT version 26.1.0
#Thu Feb 05 13:55:13 JST 2026
SourceAnalysisProp.ADDITIONAL_EXCLUDED_SCHEMAS=XS$NULL,SYSTEM,DBSNMP,APPQOSSYS,GSMCATUSER,ODI_REPO_USER,MDDATA,SYS,SSB,(snip)
TargetInstanceProp.ALLOW_ROWID_COLUMN_TYPE=FALSE
TargetInstanceProp.CLOUD_SERVICE=OLTP
TargetInstanceProp.COMPATIBILITY_VERSION=23.5.0
TargetInstanceProp.CPAT_VERSION=26.1.0
TargetInstanceProp.DB_BLOCK_SIZE=8192
TargetInstanceProp.DB_EDITION=ENTERPRISE
TargetInstanceProp.DB_PLATFORM_ID=13
TargetInstanceProp.DB_TIME_ZONE=+00\:00
TargetInstanceProp.DB_VERSION=23.26.1.1.0
TargetInstanceProp.DIRECTORIES=DATA_PUMP_DIR,EXT_DATA_DIR,JAVA$JOX$CUJS$DIRECTORY$,OPATCH_INST_DIR,OPATCH_LOG_DIR,(snip)
TargetInstanceProp.JAVAVM_STATUS=
TargetInstanceProp.MAX_STRING_SIZE=EXTENDED
TargetInstanceProp.NLS_CHARACTERSET=AL32UTF8
TargetInstanceProp.NLS_NCHAR_CHARACTERSET=AL16UTF16
TargetInstanceProp.PDB_LOCKDOWN=OLTP
TargetInstanceProp.PROFILES=DEFAULT,ORA_ADMIN_PROFILE,ORA_APP_PROFILE,ORA_CIS_PROFILE,ORA_EXTAPP_PROFILE,ORA_MANDATORY_PROFILE,(snip)
TargetInstanceProp.ROLEPRIVILEGE=ACCHK_READ,ADB_MONITOR,ADM_PARALLEL_EXECUTE_TASK,ADPADMIN,ADPUSER,APEX_ADMINISTRATOR_READ_ROLE,(snip)
TargetInstanceProp.SYSPRIVILEGE=ADMINISTER ANY SQL TUNING SET,ADMINISTER DATABASE TRIGGER,ADMINISTER FINE GRAINED AUDIT POLICY,(snip)
TargetInstanceProp.TABLESPACES=DATA,DBFS_DATA,SAMPLESCHEMA,SYSAUX,SYSTEM,TEMP,UNDOTBS1
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.DATA=8192
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.DBFS_DATA=8192
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.SAMPLESCHEMA=8192
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.SYSAUX=8192
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.SYSTEM=8192
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.TEMP=8192
TargetInstanceProp.TABLESPACE_BLOCK_SIZE.UNDOTBS1=8192
TargetInstanceProp.TZ_VERSION=44
[oracle@handson-vm01 cpat]$

premigration_advisor_analysis.properties をインプットに、ソース・インスタンス分析モードで CPAT を実行します。
前回の投稿では毎回出力されていたCPAT-1013: Informational: No analysis properties file found on the command line.が、今回は出力されていません。

[oracle@handson-vm01 cpat]$ ./premigration.sh --connectstring jdbc:oracle:thin:@localhost:1521/orclpdb1 --username sys --sysdba --zip --analysisprops premigration_advisor_analysis.properties --outfileprefix try5
Enter password for sys user:
PremigrationException
CPAT-1018: Informational: The amount of memory available to CPAT is 3490 MB. Oracle recommends running CPAT using a 64-bit JVM on a system with at least 8 GB of memory.
Increase the memory by setting _JAVA_OPTIONS=-Xmx4g or higher if additional memory is available.

Cloud Premigration Advisor Tool Version 26.1.0

Cloud Premigration Advisor Tool completed with overall result: Action Required
Cloud Premigration Advisor Tool generated report location: /home/oracle/cpat/try5_premigration_advisor_report.html
Cloud Premigration Advisor Tool generated report location: /home/oracle/cpat/try5_premigration_advisor_report.txt
Cloud Premigration Advisor Tool generated Zip file location: /home/oracle/cpat/try5_premigration_advisor.zip
[oracle@handson-vm01 cpat]$ ls -la
total 944
drwxrwxrwx. 5 root   root       4096 Feb  5 14:07 .
drwx------. 8 oracle oinstall   4096 Feb  5 13:50 ..
drwxr-xr-x. 2 root   root         59 Jan 30 14:37 bin
drwxr-xr-x. 2 root   root       4096 Jan 30 14:49 lib
-rw-r--r--. 1 root   root       6069 Jan 30 14:37 LICENSE.txt
drwxr-xr-x. 2 root   root         35 Jan 30 14:49 misc
-rw-r--r--. 1 oracle oinstall   8622 Feb  5 13:55 premigration_advisor_analysis.properties
-rw-r--r--. 1 oracle oinstall  16567 Feb  5 13:55 premigration_advisor.log
-rw-r--r--. 1 root   root        139 Jan 30 14:37 premigration.cmd
-rwxr-xr-x. 1 root   root      10519 Jan 30 14:37 premigration.sh
-rw-r--r--. 1 root   root       2766 Jan 30 14:49 README.txt
-rw-r--r--. 1 root   root      11533 Jan 30 14:49 THIRD_PARTY_LICENSES.txt
-rw-r--r--. 1 oracle oinstall 397394 Feb  5 14:07 try5_premigration_advisor.log
-rw-r--r--. 1 oracle oinstall 271488 Feb  5 14:07 try5_premigration_advisor_report.html
-rw-r--r--. 1 oracle oinstall  96416 Feb  5 14:07 try5_premigration_advisor_report.txt
-rw-r--r--. 1 oracle oinstall 104812 Feb  5 14:07 try5_premigration_advisor.zip
[oracle@handson-vm01 cpat]$

レポートサマリを比較すると、Target Database の Review Required (一部) が Passed に、Additional Tasks の Review Suggested (一部) が Passed に変わっています。

Target Database の Review Required を確認すると、External Tables for Serverless が Passed に変わっています。

内容を確認すると、「ADB の外部テーブルは、Object Storage Service または File Storage Service を使用して再作成する必要あり」というもので、SHスキーマの SALES_TRANSACTIONS_EXT が検出されていました。
ターゲットADB には既に SHスキーマが存在するため、Review Required から Passed に変わったと考えられます。

ターゲットADBが既に存在する場合は、ターゲット・インスタンスプロパティモードを実施し、ソース・インスタンス分析モードの結果が最適化されるようにしましょう