执行DSC进行语法迁移

注意事项

• 启动迁移程序前，可以自定义指定输出文件夹路径。输入文件夹路径、输出文件夹路径以及日志路径以空格隔开。默认在工具根目录下。输入文件夹路径不能包含空格。路径空格会导致DSC执行错误。详情请参见故障处理。

准备工作

在迁移之前必须先创建输入文件夹和输出文件夹，并将待迁移的所有SQL脚本复制到输入文件夹中。Linux系统操作如下：

1. 创建输入和输出文件夹。您可以根据用户的首选项在任意位置创建文件夹。用户也可以使用默认的文件夹作为输入、输出，作为包的一部分提供。

   1 2	mkdir input mkdir output

   

   由于DSC批量无序地读取输出文件夹，因此，建议在迁移开始后不要对输入文件夹和文件进行任何修改，这些异常操作将影响DSC的输出结果。

2. 将所有待迁移的 SQL文件复制到输入文件夹。
   

   • 如果源文件的编码格式不是UTF-8，请执行以下步骤：
     1. 打开config文件夹中的application.properties文件。
     2. 将application.properties文件中encodingFormat参数值修改为所需的文件编码格式。

     DSC支持UTF-8、ASCII以及GB2312编码格式。encodingFormat的值不区分大小写。

   • 如果需要获取Linux系统中源文件的编码格式，请在源文件所在服务器上执行以下命令：

     1	file -bi <Input file name>

环境搭建及恢复（数据库及数据库用户）

创建DWS数据库和schema

1. 登录Postgres系统。

   gsql -p <port> -d postgres 
   drop database <database name>;
   create database <database name>;
   \c <database name>
   GRANT ALL PRIVILEGES ON DATABASE <database name> TO <user>;
   grant database to <user>;\q
   gsql -p <port> -d <database name> -U <user> -W <password> -h <IP> -f
   drop database <database name>;
   create database <database name>;
   \c <database name>;
   GRANT ALL PRIVILEGES ON DATABASE <database name> TO <user>;
   gsql -p <port> -d <database name> -U <user> -W <password>  -f

2. 运行Setup目录下的所有文件。

命令：

sh runDSC.sh -S oracle -M blogic -I <input path> 
sh runDSC.sh -I input/ -S oracle -M ddl -L log_temp -P input/bulk/1_table/ 

迁移方法

用户可在Windows和Linux操作系统中执行runDSC.sh或runDSC.bat命令进行迁移，各迁移场景的命令详见表1，带“[]”内的参数为可选参数。

1
2
3
4
5

> ./runDSC.sh
 --source-db Teradata
[ --input-folder <input-script-path> ]
[--output-folder <output-script-path> ]
[--log-folder <log-path>]

1
2
3
4
5

> runDSC.bat
--source-db Teradata
[ --input-folder <input-script-path> ]
[--output-folder <output-script-path> ]
[--log-folder <log-path>]

任务示例

• 示例：将Teradata数据库的SQL文件迁移到适用于Linux系统下的DWS的SQL脚本中。

  1 2 3

  ./runDSC.sh --source-db teradata 或 ./runDSC.sh -S teradata

  1	./runDSC.sh --source-db teradata --input-folder D:\test\conversion\input --output-folder D:\test\conversion\output --log-folder D:\test\conversion\log

• 示例：执行以下命令，将Teradata数据库的SQL文件迁移到适用于Windows操作系统下的DWS的SQL脚本中。

  1 2 3

  runDSC.bat --source-db teradata 或 runDSC.bat -S teradata

  1	runDSC.bat --source-db teradata --input-folder D:\test\conversion\input --output-folder D:\test\conversion\output --log-folder D:\test\conversion\log

控制台上显示迁移详情（包括进度和完成状态）：

********************** Schema Conversion Started *************************  
DSC process start time : Mon Jan 20 17:24:49 IST 2020  
Statement count progress 100% completed [FILE(1/1)]    
Schema Conversion Progress 100% completed  
**************************************************************************   
Total number of files in input folder : 1  
Total number of valid files in input folder : 1  
**************************************************************************   
Log file path :....../DSC/DSC/log/dsc.log  
Error Log file :    
DSC process end time : Mon Jan 20 17:24:49 IST 2020  
DSC total process time : 0 seconds  
********************* Schema Conversion Completed ************************

查看并验证输出文件

迁移流程结束后，用户可使用对比工具（例如BeyondCompare®）将输入文件与输出文件进行比较。为了简化对比过程，也可以先对源SQL文件进行格式化。

1. 在Linux操作系统上运行以下命令以查看输出文件夹中的迁移文件。Windows操作系统不再赘述。

   cd OUTPUT
   ls

   显示类似以下信息：

   formattedSource    output
   user1@node79:~/Documentation/DSC/OUTPUT> cd output
   user1@node79:~/Documentation/DSC/OUTPUT/output> ls
   in_index.sql    input.sql    Input_table.sql    in_view.sql    MetadataInput.sql
   user1@node79:~/Documentation/DSC/OUTPUT/output>

2. 使用对比工具比较输入文件和输出文件，查看迁移后SQL文件的关键字是否符合目标数据库的要求。如果不符合，请联系技术支持处理。

查看日志文件

所有执行及错误信息都会写入对应的日志文件。详情请参见DSC日志参考。

检查日志文件是否记录错误信息。如是，请参考故障处理。