如何使用 Babelfish for Aurora PostgreSQL 进行快速的数据库迁移

• 环境架构
  

整个实验环境部署在亚马逊云科技公有云美国东部区域(us-east-1)，整体架构如下图所示，主要的组件包括：

• VPC：包含公有和私有子网的虚拟私有网络环境
  
• EC2 实例：部署了.NET 应用以及数据库客户端工具的 Windows Server
  
• SQL Server 实例： RDS SQL Serves 数据库的节点
  
• Aurora for PostgreSQL 实例：Aurora for PostgreSQL 数据库集群的单节点
  
  

• 工具和用途
  

以下工具已经在 EC2 上的 Windows server 中下载并安装配置好，无需下载

Windows 桌面图标
工具	SQL Server Management Studio	dbeaver	IIS 管理器
用途	连接 RDS SQL Server	连接 Aurora PostgreSQL	管理.net web 应用

• 主要使用文件
  

以下文件和目录已经在 EC2 上的 Windows server 中放置好

• C:\Demo\lab.txt － 内容包含实验１命令、实验４代码
  
• C:\Demo\BabelfishCompass － Babelfish Compass 评估工具
  

Event Engine 是 AWS 创建的一个工具，可为 Workshop 活动预置 AWS 账户。这些帐户将在workshop 开始后 24 小时自动终止，参与者不必担心留下任何东西。每个参与者都将收到他们自己的 Event Engine AWS 帐户。以下为激活实验账号的操作全过程。

1. 登陆 Event Engine 控制台
   登陆 https://dashboard.eventengine.run/login，输入主持者发送的 Hash 号码，并点击下方的“Accept Terms & Login”
   

1.创建新的CloudFormation堆栈任务

• 进入 CloudFormation 主页，在左侧菜单点击“Stacks”，在出现的页面中点击“Create stack”并选择“With new resources(standard)”，再点击页面中间的“Create stack”按钮 

2. 第一步：准备模版

• 选择模版来源于“Amazon S3 URL”，输入 S3 中的地址：https://xiekl.s3.cn-northwest-1.amazonaws.com.cn/bingbing-dbwebniar/demo.yml 并点击下一步
  

3. 第二步：配置堆栈信息

• 输入 CloudFormation 堆栈任务名称
  

4. 第三步：配置堆栈选项

• 默认设置无需改动
  

5. 第四步：审查堆栈任务

• 检查相关参数，并点击“Create stack”

7. 查看 CloudFormation 堆栈任务的输出

• 点击堆栈名显示详细信息，点击“Output”页面，查看实例的连接 Endpoint，并记录以备后续使用。这里有三个 Endpoint ，具体连接用途如下：
  
• WinInstanceEndpoint： Windows Server on EC2 远程桌面连接地址
  
• PGInstanceEndpoint： Aurora PostgreSQL 连接端点
  
• SQLInstanceEndpoint：RDS SQL Server 连接端点
  

• 如使用Windows操作系统的话，打开远程桌面程序连接EC2实例(通常在Windows运行对话框中输入 mstsc 即可打开)，如使用MacOS系统的话，安装微软远程桌面工具并连接EC2实例
  
• 连接地址：查看stack中输出的 WinInstanceEndpoint 信息
  
• 登陆用户：查看1.2 实验环境中 "Windows on EC2远程桌面连接用户" 信息
  

7. 修改 APP 应用的配置文件 C:\web\Web.conf

• 在 23 行修改数据库连接设置为 RDS SQL Server 的内容(参考步骤 2 所查看信息)
  Data Source= 数据库连接端点 ;Initial Catalog=demo;Persist Security Info=True; User ID= 数据库用户名 ;Password= 密码;
  

9..在自动打开的 Edge 浏览器地址中使用 WEB 应用账号登陆应用也可以手工输入应用的网址 http://localhost:9901

• 登陆用户：查看 1.2 实验环境中“.net Web 应用登陆”信息
  

1. 使用SQL Server Management Studio (SSMS) 登陆 SQL Servers

• 选中数据库并按鼠标右键，菜单中依次选择“Tasks”→“Generate Scripts”
  

4. 在 Options 中由上至下设置以下选项：

• Script Extended Properties – 选择 False
  
• Script Logins – 选择 True
  
• Script Object-Level-Permissions – 选择 True
  
• Script Owner – 选择 True
• Script Indexes – 选择 True
  
• Script Triggers – 选择 True
  

8. 执行 Babelfish Compass 程序生成报告 （可拷贝 C:\Demo\lab.txt 的相关命令）

• 进入Babelfish Compass目录：cd C:\Demo\BabelfishCompass
  
• 执行命令：
  .\BabelfishCompass.bat demo-report C:\Users\Administrator\Documents\script.sql -reportoption xref
  
• 命令执行后生成报告并自动打开浏览器显示报告
  

• 先查看Assessment Summary（评估总结）和Object Count（对象统计）这一段显示总体情况：DDL 行数，支持和不支持的特性数量等信息，以及根据对象所列出的支持和不支持的特性数量
  

再查看不支持特性的描述

• Alter table…check 启用约束语法当前不支持，默认就是启用的
  
• ALTER AUTHORIZATION 语法不支持，可以直接注释屏蔽
  
• SET ROWCOUNT 语法不支持，需改写
  

查看不支持特性涉及的具体 SQL 语句

• 回到报告目录中，选择“X-ref: 'Not Supported' by SQL feature"
  

10. 根据评估报告进行相应调整

• 对于不支持的特性，需要调整的，改写相关语句或寻找替代方法，下图显示的即为修改后的结果，在下一个实验中我们学习如何修改
  

1. 使用 SQL Server Management Studio 连接 Aurora for PostgreSQL 实例

• 点击左侧的数据库连接，连接地址请查看 stack中output的PGInstanceEndpoint 信息，登陆用户请查看 1.2 实验环境中“Aurora PostgreSQL 数据库连接”信息
  

5. 解决DDL兼容性问题

• SQL Server 中的 WITH CHECK ADD CONSTRAINT 语句即添加一个约束，并将其应用到已存在的数据中，当前 Babelfish for Aurora PostgreSQL  不支持此语句，在保证已有数据引用正确的情况下，可去掉 WITH CHECK，同时删除启用约束的语句 ALTER TABLE .. CHECK 
  

7. 修改应用配置文件 C:\web\Web.conf

• 在 23 行修改数据库连接设置为 Aurora for PostgreSQL
  

随着业务的发展及应用现代化的需求，您可以选择在 Babelfish for Aurora PostgreSQL 平台的开发模式。通常来说，有以下几种开发模式：

• 使用 SQL Server 驱动开发 T-SQL 代码
  
• 使用开源驱动开发 PL/pgSQL 代码
  
• 在 PostgreSQL 开发的代码，使用 SQL Server 驱动调用
  

1. 在远程桌面上打开 dbeaver，通过 PostgreSQL 驱动登陆 Aurora PostgreSQL

• 连接地址请查看 stack 中 output 的 PGInstanceEndpoint 信息
  
• 登陆用户请查看 1.2 实验环境中 Aurora PostgreSQL 数据库连接”信息
  
• 登陆的数据库选择 babelfish_db
  

2. 在dbeaver的查询页面中输入以下代码，创建自定义函数 getcity()（代码可从C:\Demo\lab.txt 中拷贝）

• 此函数返回数组为查询 dept 表的所有内容
  

create or replace function dbo.getcity() returns setof dbo.dept as $$ begin return query select * from dbo.dept; end; $$ language plpgsql;

3. 使用 SMSS 通过 SQL Server 驱动登陆

• 登陆后选择 master 数据库，点击鼠标右键，打开一个新的查询
  

4. 打开 dbeaver，通过 PostgreSQL 驱动登陆 Aurora PostgreSQL

• 在 dbeaver 的查询页面中输入以下代码（代码可从C:\Demo\lab.txt 中拷贝），创建自定义函数 check_date(), 此函数显示当前时间和输入的N天前的时间差
  

CREATE FUNCTION public.check_date("@rq" int) RETURNS int LANGUAGE pltsql AS '{"version_num": "1", "typmod_array": ["-1", "-1"], "original_probin": ""}', 'BEGIN DECLARE @h1 int set @h1 = datediff(hour,getdate()-@rq,getdate()); RETURN(@h1) END';

5. 在 Aurora PostgreSQL 中执行含有 T-SQL 函数的代码

• select public.check_date(1) as "1 Day", public.check_date(5) as "5 Days"
  

完成全部实验后，需要清理相关的实验环境。清理步骤如下：

1. 在 CloudFormation 控制台的堆栈页面中，选择要删除的堆栈。该堆栈当前必须处于运行状态。在堆栈详细信息窗格中，选择 Delete (删除)