通过迁移评估采集器采集数据库对象

背景信息

迁移评估采集器是用于在公有云环境采集用户 Schema 数据的工具。

您在公有云环境下不可以使用公网连接自己的 Oracle 实例，请下载迁移评估采集器并在内网环境运行，采集对应 Schema 的对象 DDL 语句后，再手工上传至迁移评估公有云环境中进行评估。

前提条件

请确保可以直接访问到需要评估的 Oracle 数据库。配置的数据库用户需要具备的权限如下：

• 至少具备 create session 和 resource 权限，以确保正常连接。

• 具备 select any dictionary 的权限，本程序会扫描 DBA_OBJECTS 表获取待评估的对象。

• 具备 select_catalog_role 角色，确保本程序能够正常使用 DBMS_METADATA.GET_DDL 函数来获取相应对象的 DDL 语句。

您可以执行下述命令，检查数据库用户是否具备相关权限。此处以命名执行评估任务的 Oracle 数据库用户为 oma 为例。

-- 该 SQL 语句的返回中应包含 CONNECT、RESOURCE 和 SELECT_CATALOG_ROLE
SELECT * FROM DBA_ROLE_PRIVS WHERE GRANTEE = 'oma';

-- 该 SQL 语句的返回中应包含 CREATE SESSION 和 SELECT ANY DICTIONARY
SELECT * FROM DBA_SYS_PRIVS WHERE GRANTEE = 'oma';

如果您需要给 Oracle 数据库用户 oma 授予上述权限，请执行下述语句。

GRANT CREATE SESSION,RESOURCE TO oma;
GRANT SELECT ANY DICTIONARY TO oma;
GRANT SELECT_CATALOG_ROLE TO oma;

安装迁移评估采集器

1. 登录 OceanBase 数据库管理控制台。

2. 在左侧导航栏，单击 迁移评估 > 评估任务。

3. 在 评估任务 页面的右上角，单击 下载采集器。

4. 在 下载采集器 对话框，单击 点击下载。

5. 下载迁移评估采集器后，直接解压即可完成安装。

   本文以目录名 oma-collector-1.2.5 为例，其中 1.2.5 为迁移评估采集器的版本号，请您替换为实际的值。

   tar zxvf oma-collector-1.2.5.tar.gz
   cd oma-collector-1.2.5

   解压完成后，目录下包括 oma-collector-1.2.5.jar 和 dump 文件夹。

采集数据

1. 进入迁移评估目录。

   本文以目录名为 oma-collector-1.2.5 为例，其中 1.2.5 为迁移评估采集器的版本号。

   cd oma-collector-1.2.5

2. 执行下述命令采集数据。

   java -jar oma-collector-1.2.5.jar \  #此处以 oma-collector-1.2.5.jar 为例，您需要替换为实际的名称。
   -t ORACLE \                          #数据库的类型，包括 ORACLE/MYSQL。此处需要大写。
   -v 11g \                             #数据库的版本。ORACLE 数据库包括 11g、12c、18c 和 19c，MYSQL 数据库包括 5.6、5.7 和 8.0。
   -h 10.10.10.1 \                      #数据库的地址。
   -P 1111 \                            #数据库的端口。
   -u abcd \                            #登录的用户名。
   -p \                                 #登录用户的密码，回车后会要求手动输入密码。
   -sn orcl11g.aa.oracle.com \          #Service Name。如果使用 SID 连接使用，则 -sid 参数代替 -sn。
   -s "ABCD,AAA"                       #需要扫描的 Schema，此处需要大写。

3. 按回车键，输入来源数据库的密码。

4. 查看运行结果。

   OceanBase Migration Assessment Collector version : 1.2.5
   Power by OceanBase Ant Group
   [INFO ] 17:10:50.320 [main] c.alibaba.druid.pool.DruidDataSource - {dataSource-1} inited
   [INFO ] 17:10:51.794 [main] c.a.o.o.c.scan.OracleDDLScanner - ALL OBJECT COUNT [384]
   [ OBDBA(384|384) ] Progress: ################################################## |100%
   [INFO ] 17:11:19.040 [main] c.a.o.oma.collector.OmaCollector - scan finished ... close the file stream
   [INFO ] 17:11:19.047 [main] c.a.o.oma.collector.OmaCollector -  OBDBA scan finish , write to file [.\dump\xxxx.oma.sql]
   [INFO ] 17:11:19.246 [main] c.a.o.o.c.scan.OracleDDLScanner - ALL OBJECT COUNT [0]
   [INFO ] 17:11:19.246 [main] c.a.o.oma.collector.OmaCollector - scan finished ... close the file stream
   [INFO ] 17:11:19.262 [main] c.a.o.oma.collector.OmaCollector -  AAA scan finish , can not found any object
   [INFO ] 17:11:19.262 [main] c.a.o.oma.collector.OmaCollector - 请将 [.\dump\xxxx.oma.sql] 上传到OceanBase公有云环境[https://www.aliyun.com/product/oceanbase]下完成评估.

   运行完成后，会在 dump 目录下生成对应的采集文件 xxxx.oma.sql。程序将提示您：请将 [.\dump\xxxx.oma.sql] 上传到OceanBase公有云环境[https://www.aliyun.com/product/oceanbase]下完成评估。