## OMA快速上手

OMA是一個集采集，評估，回放，驗證為一體的OceanBase遷移評估工具，在將數據庫從Oracle/MySQL遷移到OB的過程中進行功能和性能的評估，幫助

用戶快速了解整個系統的遷移難度。

### 評估一個Oracle實例的對象

sh bin/start.sh --name task_name  # 任務名稱，可隨意取值

--mode ANALYZE                    # 分析模式

--from-type DB                    # 來源為數據庫

--evaluate-mode SOURCE_TARGET     # 評估方式，如果是oracle請使用SOURCE_TARGET

--source-db-type ORACLE           # 來源數據庫類型

--source-db-version 12c           # 來源數據庫版本

--source-db-host 111.222.333.44   # 來源數據庫地址

--source-db-port 1521             # 來源數據庫端口

--source-db-user user             # 來源數據庫用戶名

--source-db-password password     # 來源數據庫密碼

--source-db-service-name serv.localdomain # 來源數據庫service-name/也可以換成 --source-db-sid 表示SID

--schemas "SCHEMA1,SCHEMA2"         # 需要評估的schema,多個可以用,分割，需要大寫

--target-db-type OBORACLE         # 目標類型，只能填OBORACLE

--target-db-version 2.2.70          # 目標版本,2.2.70表示2.2.7X版本和3.X,不用特意區分

### 評估一個MySQL實例

sh bin/start.sh --name task_name      # 任務名稱，可隨意取值

--mode ANALYZE                        # 分析模式

--from-type DB                        # 來源為數據庫

--evaluate-mode ONLY_TARGET           # 評估方式，如果是mysql請使用ONLY_TARGET

--source-db-type MYSQL                # 來源數據庫類型

--source-db-version 5.7               # 來源數據庫版本

--source-db-host 100.11.22.33         # 來源數據庫地址

--source-db-port 3306                 # 來源數據庫端口

--source-db-user user                 # 來源數據庫用戶名

--source-db-password pass             # 來源數據庫密碼

--schemas "yewu_test"                 # 需要評估的schema,MYSQL暫不支持評估多個schema

--target-db-type OBMYSQL              # 目標類型,固定值 OBMYSQL

--target-db-version 2.2.x               # 目標版本,固定值 2.2.x

### 評估Oracle的SQL語句（從GV$SQL中采集）

sh bin/start.sh --name test_11g               # 任務名稱，可隨意取值

--mode ANALYZE                                # 分析模式

--from-type COLLECT                           # 來源為從數據庫采集

--collect-start-time "2020-04-07 15:30:00"   # 采集的SQL的開始時間，注意時間中間的空格需要轉義

--collect-end-time "2020-04-07 16:30:00"     # 采集的SQL的結束時間，注意時間中間的空格需要轉義，無此參數表示到當前時間

--evaluate-mode SOURCE_TARGET                 # 評估方式，如果是oracle請使用SOURCE_TARGET

--source-db-type ORACLE                       # 來源數據庫類型

--source-db-version 11g                       # 來源數據庫版本

--source-db-host 11.159.61.XX                 # 來源數據庫地址

--source-db-port 1521                         # 來源數據庫端口

--source-db-user aaaaa                        # 來源數據庫用戶名

--source-db-password bbbbb                    # 來源數據庫密碼

--source-db-service-name orcl11g.us.oracle.com # 來源數據庫service-name/也可以換成 --source-db-sid 表示SID

--schemas "OBDBA"                             # 需要評估的schema，不支持多schema

--target-db-type OBORACLE                     # 目標端類型

--target-db-version 2.2.70                    # 目標端版本

--collect-filter "COMMAND_TYPE=3"               # 【注意】可選參數,評估中的附加過濾條件

--task-interval 15                              # 【注意】可選參數,有此參數表示每隔15秒重新運行一次評估，重新運行的開始時間為上次的結束時間，結束時間為當前時間，用來不間斷采集SQL進行評估

### 從文本進行評估

文本中的SQL必須以單行的$$標識符進行分割，如

SELECT * FROM A;

$$

SELECT * FROM B;

$$

SELECT * FROM C;

$$

sh bin/start.sh --name test_11555g

--mode ANALYZE

--from-type TEXT

--evaluate-mode SOURCE_TARGET

--source-file "/Users/wuyinghao/Downloads/test.sql" # 文本文件路徑

--source-db-type ORACLE

--source-db-version 11g

--schemas DEFAULT

--target-db-type OBORACLE

--target-db-version 2.2.70

--process-thread-count 5

### 查看報告

評估完成以后，會在report文件夾下面看到對應的報告,并且會在結束后在控制臺打印出簡報:

評估程序OMA運行完成,評估報告簡報:

任務 : task_name-XXXXXXX 開始時間 : 2021.01.02 18:24:34 結束時間 : 2021.01.02 18:25:50

SCHEMA : yewu_test 評估耗時 : 75927 毫秒

+-------------------------------------------------------------------+

| schema: schema  | source: sourceDB      | target: targetDB        |

+-----------------+---------+---------+---------+---------+---------+

|  Object Type    |  pass   | convert | failure |  total  | percent |

+-----------------+---------+---------+---------+---------+---------+

| TABLE           | 360     | 0       | 2       | 362     |  99.4 % |

+-----------------+---------+---------+---------+---------+---------+

| PROCEDURE       | 1       | 0       | 0       | 1       | 100.0 % |

+-----------------+---------+---------+---------+---------+---------+

| TYPE            | 2       | 0       | 0       | 2       | 100.0 % |

+-----------------+---------+---------+---------+---------+---------+

| VIEW            | 3       | 0       | 0       | 2       | 100.0 % |

+-----------------+---------+---------+---------+---------+---------+

### 命令行模式

命令行模式用來對單條SQL語句進行快速評估

直接使用 sh bin/start.sh --mode CONSOLE 進入命令行模式，輸入以后屏幕會出現以下打印，并開啟內部shell:

========================================

歡迎使用 OMA 命令行交互模式,直接對SQL語句進行評估

請在命令行直接輸入你的SQL語句，并以$$為結尾行，系統將自動對SQL進行評估

輸入oracle并回車，切換為oracle模式,輸入mysql并回車，切換為mysql模式

exit 或者 Ctrl+D結束程序;Ctrl+C取消本次輸入

示例 : 評估Oracle

OMA >> (ORACLE MODE) ] oracle SELECT *

FROM AA

$$

OMA >> (ORACLE MODE) ]

========================================

可以直接在終端輸入SQL語句，換行加$$結尾完成輸入，可以獲得此SQL的評估結果，用來進行快速驗證，默認使用oracle模式，

如需切換為mysql，直接輸入mysql并回車，控制臺將變成mysql模式:

OMA >> (MYSQL MODE) ]

有問題或者有DB-Replay需求，請聯系：yinghao.wyh@alipay.com