华为云用户手册

字符集检查 对源库和目标库的字符集进行检查，将检查结果展示给用户，该检查仅为字符集兼容结果提示性信息，与后续操作无关，字符集兼容情况如表1到表3所示。 字符集兼容性结果说明： 告警：源库和目标库字符集不完全兼容。 成功：源库和目标库字符集兼容。 表1 Oracle到 GaussDB 字符集兼容情况 源库 目标库 检查结果 SQL_ASCII SQL_ASCII 成功 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 US7ASCII SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 ISO-8859-1 SQL_ASCII 警告 ISO-8859-1 成功 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 LATIN1 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 成功 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 GB2312 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 成功 GBK 成功 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 ZHS16GBK SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 成功 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 GBK SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 成功 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 ZHS32GB18030 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 GB18030 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 AL16UTF16 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF16 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 AL32UTF8 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF8 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF32 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 其他字符集 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 表2 MySQL到GaussDB字符集兼容情况 源库 目标库 检查结果 ISO-8859-1/LATIN1 SQL_ASCII 警告 ISO-8859-1 成功 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 GB2312 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 成功 GBK 成功 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 GBK SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 成功 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 GB18030 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF16 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF8 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF32 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 ASCII SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 UTF8MB3 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 成功 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF8MB4 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 UTF16LE SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 成功 UTF8 成功 UTF32 成功 其他字符集 警告 其他字符集 SQL_ASCII 警告 ISO-8859-1 警告 LATIN1 警告 GB2312 警告 GBK 警告 GB18030 警告 UTF16 警告 UTF8 警告 UTF32 警告 其他字符集 警告 表3 Oracle到MySQL字符集兼容情况 源库 目标库 检查结果 SQL_ASCII ASCII 成功 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 警告 UTF16LE 警告 UTF8 警告 UTF32 警告 UTF8MB4 警告 其他字符集 警告 US7ASCII ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 警告 UTF16LE 警告 UTF8 警告 UTF32 警告 UTF8MB4 警告 其他字符集 警告 ISO-8859-1 ASCII 警告 LATIN1/ISO-8859-1 成功 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 警告 UTF16LE 警告 UTF8 警告 UTF32 警告 UTF8MB4 警告 其他字符集 警告 LATIN1 ASCII 警告 LATIN1/ISO-8859-1 成功 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 警告 UTF16LE 警告 UTF8 警告 UTF32 警告 UTF8MB4 警告 其他字符集 警告 GB2312 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 成功 GBK 成功 UTF8MB3 成功 GB18030 成功 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 ZHS16GBK ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 成功 UTF8MB3 成功 GB18030 成功 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 GBK ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 成功 UTF8MB3 成功 GB18030 成功 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 ZHS32GB18030 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 成功 UTF8MB3 成功 GB18030 成功 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 GB18030 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 成功 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 AL16UTF16 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 UTF16 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 AL32UTF8 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 UTF8 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 UTF32 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 成功 UTF16LE 成功 UTF8 成功 UTF32 成功 UTF8MB4 成功 其他字符集 警告 其他字符集 ASCII 警告 LATIN1/ISO-8859-1 警告 GB2312 警告 GBK 警告 UTF8MB3 警告 GB18030 警告 UTF16 警告 UTF16LE 警告 UTF8 警告 UTF32 警告 UTF8MB4 警告 父主题： 迁移预检查说明

兼容模式检查 目标库为GaussDB时，会进行GaussDB兼容模式的检查。不同源数据库适配程度最高的兼容模式有所不同，如果目标数据库使用的兼容模式与推荐使用的不一致，则将提示风险。GaussDB兼容模式设置，请参考表1。 表1 兼容模式对应情况说明 源数据库 GaussDB兼容模式 MySQL、GoldenDB MySQL兼容模式。 其他 Oracle兼容模式。 MySQL兼容模式包括集中式B兼容模式、M兼容模式、以及分布式MYSQL兼容模式，Oracle兼容模式包括集中式A兼容模式和分布式ORA兼容模式。 父主题： 迁移预检查说明

Microsoft SQL Server To GaussDB配置项使用说明 源数据库数据类型 转换后数据类型 相关的转换配置 TINYINT TINYINT - SMALLINT SMALLINT - INT INT - BIGINT BIGINT - DECIMAL DECIMAL - NUMERIC NUMERIC - FLOAT FLOAT - REAL REAL - SMALLMONEY numeric(10, 4) - MONEY numeric(19, 4) - BIT BOOLEAN bit类型转换 选择配置项的值为“将bit类型转换为boolean类型。”，可与DRS转换后在GaussDB 存储等价。 DATE DATE - SMALLDATETIME SMALLDATETIME - DATETIME TIMESTAMP(3) - DATETIME2(n) TIMESTAMP(n) - DATETIMEOFFSET(n) TIMESTAMPTZ(n) datetimeoffset类型转换 选择配置项的值为“将datetimeoffset类型转换为timestamptz类型“ ，可与DRS转换后在GaussDB 存储等价。 TIME(p) TIME(p) - TIMESTAMP BYTEA - XML XML xml类型转换 选择配置项的值为“将XML类型转换为TEXT类型。”，可与DRS转换后在GaussDB 存储等价。 CHAR(n) CHAR(n) 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 VARCHAR(n) VARCHAR(n) 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 varchar(max) TEXT VARCHAR(MAX)类型转换 选择配置项的值为“将VARCHAR(MAX)类型转换为TEXT类型。 ”，可与DRS转换后在GaussDB 存储等价。 NCHAR(n) NCHAR(n) 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 NVARCHAR(n) NVARCHAR2(n) - NVARCHAR(max) TEXT NVARCHAR(MAX)类型转换 选择配置项的值为“将NVARCHAR(MAX)类型转换为TEXT类型。 ”，可与DRS转换后在GaussDB 存储等价。 BINARY(n) BYTEA - VARBINARY(n) BYTEA - VARBINARY(MAX) BYTEA VARBINARY(MAX)类型转换 选择配置项的值为“将VARBINARY(MAX)类型转换为BYTEA类型。”，可与DRS转换后在GaussDB 存储等价。 IMAGE BYTEA IMAGE类型转换 选择配置项的值为“将IMAGE类型转换为BYTEA类型”，可与DRS转换后在GaussDB 存储等价。 HIERARCHYID BYTEA HIERARCHYID类型转换 选择配置项的值为“将HIERARCHYID类型转换为BYTEA类型。”，可与DRS转换后在GaussDB 存储等价。 NTEXT TEXT NTEXT类型转换 选择配置项的值为“将NTEXT类型转换为TEXT类型。”，可与DRS转换后在GaussDB 存储等价。 TEXT TEXT TEXT类型转换 选择配置项的值为“将TEXT类型转换为TEXT类型。”，可与DRS转换后在GaussDB 存储等价。 UNIQUEIDENTIFIER UUID - 父主题： 数据类型转换说明

PostgreSQL To GaussDB 数据类型转换说明 源数据库数据类型 转换后数据类型 相关的转换配置 SMALLINT SMALLINT - INTEGER INTEGER - BIGINT BIGINT - INTEGER INTEGER - REAL REAL - DOUBLE PRECISION DOUBLE PRECISION - NUMERIC NUMERIC - CHARACTER VARYING CHARACTER VARYING 字符数据类型转换 选择配置项的值为“扩展字符数据类型char/varchar长度。”，可与DRS转换后在GaussDB 存储等价。 CHARACTER CHARACTER 字符数据类型转换 选择配置项的值为“扩展字符数据类型char/varchar长度。”，可与DRS转换后在GaussDB 存储等价。 BIT BIT - BIT VARYING BIT VARYING - BOOLEAN BOOLEAN - BYTEA BYTEA - TEXT TEXT - TIME WITHOUT TIME ZONE TIME WITHOUT TIME ZONE - TIME WITH TIME ZONE TIME WITH TIME ZONE - TIMESTAMP WITHOUT TIME ZONE TIMESTAMP WITHOUT TIME ZONE - TIMESTAMP WITH TIME ZONE TIMESTAMP WITH TIME ZONE - INTERVAL INTERVAL - CIDR CIDR - PATH PATH - BOX BOX - LSEG LSEG - MACADDR MACADDR - POINT POINT - POLYGON POLYGON - INET INET - TSQUERY TSQUERY - TSVECTOR TSVECTOR - UUID UUID - JSON JSON - JSONB JSONB - 父主题： 数据类型转换说明

Oracle To GaussDB数据类型转换说明 源数据库数据类型 转换后数据类型 相关的转换配置 CHAR CHAR 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), VARCHAR2(n)和NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 VARCHAR VARCHAR 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), VARCHAR2(n)和NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 VARCHAR2 VARCHAR2 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), VARCHAR2(n)和NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 NCHAR NCHAR 字符集不匹配 选择配置项的值为“调整CHAR(n), VARCHAR(n), VARCHAR2(n)和NCHAR(n)的大小。”，可与DRS转换后在GaussDB 存储等价。 NVARCHAR2 NVARCHAR2 - NUMBER NUMBER - NUMBER (6, 3) NUMBER (6, 3) - NUMBER (6, 0) NUMBER (6, 0) - NUMBER (3) NUMBER (3) - NUMBER (6, -2) NUMBER (6, -2) - BINARY_FLOAT REAL - BINARY_DOUBLE BINARY_DOUBLE - FLOAT DOUBLE PRECISION float数据类型 选择配置项的值为“将FLOAT/FLOAT(n)转换为DOUBLE PRECISION”，可与DRS转换后在GaussDB 存储等价。 INT NUMBER(38) 整型数据类型 选择配置项的值为“将INT, INTEGER和SMALLINT转换成NUMBER(38)”，可与DRS转换后在GaussDB 存储等价。 INTEGER NUMBER(38) 整型数据类型 选择配置项的值为“将INT, INTEGER和SMALLINT转换成NUMBER(38)”，可与DRS转换后在GaussDB 存储等价。 DATE DATE - TIMESTAMP TIMESTAMP(6) - TIMESTAMP_TZ TIMESTAMP(6) WITH TIME ZONE - TIMESTAMP_LTZ TIMESTAMP(6) WITH TIME ZONE - INTERVAL_YM INTERVAL YEAR TO MONTH - INTERVAL_DS INTERVAL DAY TO SECOND - BLOB BLOB - CLOB CLOB - NCLOB TEXT nclob数据类型 选择配置项的值为“将NCLOB转换为TEXT数据类型。”，可与DRS转换后在GaussDB 存储等价。 LONG TEXT long数据类型 选择配置项的值为“将LONG类型转换为TEXT数据类型。”，可与DRS转换后在GaussDB 存储等价。 LONG_RAW BYTEA long raw数据类型 选择配置项的值为“将LONG RAW转换为BYTEA数据类型。”，可与DRS转换后在GaussDB 存储等价。 RAW RAW - RowID CHAR(18) - NUMBER(*，0) NUMBER(38, 0) - 父主题： 数据类型转换说明

MySQL To GaussDB数据类型转换说明 源数据库数据类型 转换后数据类型（GaussDB V2.0-8.0 以前版本） 转换后数据类型（GaussDB V2.0-8.0 及其以后版本） 相关的转换配置 CHAR CHAR CHAR 字符集长度转换 选择配置项的值为“扩展字符数据类型长度”，可与DRS转换后在GaussDB 存储等价。 VARCHAR VARCHAR VARCHAR 字符集长度转换 选择配置项的值为“扩展字符数据类型长度。”，可与DRS转换后在GaussDB 存储等价。 BINARY BYTEA BYTEA - VARBINARY BYTEA BYTEA - TINYBLOB BYTEA TINYBLOB - BLOB BLOB BLOB BLOB类型转换 选择配置项的值为“BLOB类型保持不变”，可与DRS转换后在GaussDB 存储等价。 MEDIUMBLOB BYTEA MEDIUMBLOB - LONGBLOB BYTEA LONGBLOB LONGBLOB类型转换 选择配置项的值为“迁移脚本，将LONGBLOB类型转换为BYTEA类型。”，可与DRS转换后在GaussDB 存储等价。 TINYTEXT TEXT TINYTEXT - TEXT TEXT TEXT TEXT数据类型转换 选择配置项的值为“不转换，保留TEXT数据类型，并注释长度”，可与DRS转换后在GaussDB 存储等价。 MEDIUMTEXT TEXT MEDIUMTEXT - LONGTEXT CLOB LONGTEXT LONGTEXT类型转换 选择配置项的值为“迁移脚本，将LONGTEXT类型转换为CLOB类型。”，可与DRS转换后在GaussDB 存储等价。 ENUM VARCHAR VARCHAR - SET SET SET - TINYINT SMALLINT TINYINT TINYINT类型转换 选择配置项的值为“转换TINYINT类型。”，可与DRS转换后在GaussDB 存储等价。 类型转换后是否添加CHECK约束 选择配置项的值为“不添加CHECK约束。”，可与DRS转换后在GaussDB 存储等价。 SMALLINT SMALLINT SMALLINT 无符号整数类型转换 选择配置项的值为“类型保持不变，不做转换”，可与DRS转换后在GaussDB 存储等价。 类型转换后是否添加CHECK约束 选择配置项的值为“不添加CHECK约束。”，可与DRS转换后在GaussDB 存储等价。 MEDIUMINT INTEGER MEDIUMINT 有符号整数类型转换 选择配置项的值为“类型保持不变，不做转换”，可与DRS转换后在GaussDB 存储等价。 无符号整数类型转换 选择配置项的值为“类型保持不变，不做转换”，可与DRS转换后在GaussDB 存储等价。 类型转换后是否添加CHECK约束 选择配置项的值为“不添加CHECK约束。”，可与DRS转换后在GaussDB 存储等价。 INT INT INT - BIGINT BIGINT BIGINT - FLOAT FLOAT4 FLOAT FLOAT类型转换 选择配置项的值为“类型转换为DOUBLE PRECISION，注释掉精度和标度，注释掉符号和填充关键字（UNSIGNED、SIGNED、ZEROFILL）”，可与DRS转换后在GaussDB 存储等价。 类型转换后是否添加CHECK约束 选择配置项的值为“不添加CHECK约束。”，可与DRS转换后在GaussDB 存储等价。 DOUBLE DOUBLE PRECISION DOUBLE DOUBLE类型转换 选择配置项的值为“类型转换为DOUBLE PRECISION，注释掉精度和标度，注释掉符号和填充关键字（UNSIGNED、SIGNED、ZEROFILL）”，可与DRS转换后在GaussDB 存储等价。 类型转换后是否添加CHECK约束 选择配置项的值为“不添加CHECK约束。”，可与DRS转换后在GaussDB 存储等价。 DATE DATE DATE - DATETIME TIMESTAMP DATETIME - TIMESTAMP TIMESTAMP WITH TIME ZONE TIMESTAMP - TIME TIME TIME - BIT BIT BIT - JSON JSONB JSONB json数据类型转换 选择配置项的值为“不转换，保留JSON数据类型。”，可与DRS转换后在GaussDB 存储等价。 YEAR SMALLINT SMALLINT 类型转换后是否添加CHECK约束 选择配置项的值为“不添加CHECK约束。”，可与DRS转换后在GaussDB 存储等价。 DECIMAL DECIMAL DECIMAL - NUMERIC NUMERIC NUMERIC - 父主题： 数据类型转换说明

日期时间函数转换说明 在使用 UGO 进行语法转换时，如果所选目标库为 GaussDB V2.0-3.2 或以下的版本，GaussDB 部分时间函数与事务相关详情可参见表1。这些函数返回的都是事务的开始时间，而在源库中获取的为系统当前时间，在长事务的场景下，源库和目标库 GaussDB 得到的时间不一致。因此在 UGO 转换后，如果转换后的语句中存在上述函数，则用户需要自行分析上述函数是否存在长事务中并确认影响，如有影响需手工修改保证最终的准确性。 表1 与事务相关的时间函数说明 序号 函数名称 1 CURRENT_DATE 2 CURRENT_TIME 3 CURRENT_TIME(precision) 4 CURRENT_TIMESTAMP(precision) 5 LOCALTIME 6 LOCALTIMESTAMP 7 LOCALTIME(precision) 8 LOCALTIMESTAMP(precision)

PostgreSQL迁移到GaussDB 模式兼容性： PostgreSQL 支持迁移到 GaussDB(O模式)； GaussDB(O模式)中将空字符串存储为 NULL，执行SQL语句“ select '' is null;”结果为True，与 Oracle 数据库行为一致； 影响范围： 如果源库是 PostgreSQL，目标库是 GaussDB(O模式)，则需要适配改造涉及空字符串或 NULL 语法的 SQL。 影响范围包括 DML、DDL、系统函数，例如 SQL语句“ select '' is null;”，“select regexp_matches('test1', 'test1', '');”。 UGO 评估功能支持评估PostgreSQL到GaussDB 链路中 “IS NULL ”空字符串语法。

导入模板文件 当需要跨云上账户，导入其他账户中预设好并导出的转换配置模板文件时，请在“导入模板文件”页签内创建转换模板。如何导出转换配置模板，请参考导出转换配置模板。 登录UGO控制台。 单击左侧导航栏“转换配置管理”，进入转换配置管理页面。 单击“创建配置模板”，进入“创建配置模板”页面，单击“导入模板文件”按钮，进入“导入模板文件”页签。 单击“添加文件”按钮，上传其他实例导出的ugotmplt格式模板文件，系统会识别并展示“模板名称”、“源数据库类型”、“目标数据库类型”和预设好的“特性配置”列表。 图2 通过导入模板文件创建配置模板 （可选）在配置项列表中，根据当前UGO实例需要迁移的数据库场景，进行微调。

操作场景 标签管理服务（Tag Management Service，TMS）用于用户在云平台，通过统一的标签管理各种资源。TMS服务与各服务共同实现标签管理能力，TMS提供全局标签管理能力，各服务维护自身标签管理 。 建议您先在TMS系统中设置预定义标签。 标签由“键”和“值”组成，每个标签中的一个“键”只能对应一个“值”。 每个实例最多支持10个标签配额。 用户可在创建数据库评估或对象迁移项目时添加标签，也可在项目创建成功后再添加标签。

支持审计操作的关键列表 云审计 服务是安全解决方案中专业的日志审计服务，记录了数据库和应用迁移 UGO的相关操作事件，方便您日后的查询、审计和回溯。 表1 云审计服务支持的UGO操作列表 操作名称 资源类型 事件名称 创建数据库评估项目 evaluate createEvaluationJob 创建对象迁移项目 migrate createMigrationJob 数据库评估项目测试连接 evaluate testConnection 对象迁移项目测试连接 migrate testConnection 删除数据库评估项目 evaluate deleteEvaluationJob 删除对象迁移项目 migrate deleteMigrationJob 开始对象迁移验证 migrate startVerify 停止对象迁移验证 migrate stopVerify 开始对象迁移 migrate startMigrate 停止对象迁移 migrate stopMigrate 停止数据库评估项目 evaluate stopEvaluationJob 恢复数据库评估项目 evaluate resumeEvaluationJob 确认目标库 evaluate confirmEvaluationJob 重新开始数据库评估 evaluate reanalyzeEvaluation 预检查 evaluate preCheck 上传证书 evaluate uploadCertFile 测试网络稳定性 evaluate testNetwork 父主题： 对接云审计服务

对象迁移 在完成了数据库评估，并确认目标数据库后，可以开始正式的数据库对象迁移，在该模块中，UGO将一步一步引导用户制定转换计划、设计转换方案，并帮用户完成语法自动转换和一键迁移。对于转换失败或迁移失败的对象，还提供了对象编辑、批量修改等功能，简化手动改造工作的同时还会确保每次修改的留痕，提供历史修改记录查看和回滚的能力。 实施对象迁移 对象迁移项目管理 迁移预检查说明 语法转换说明 数据类型转换说明

UGO自定义策略样例 示例1：授权用户创建评估项目 { "Version": "1.1", "Statement": [{ "Action": ["ugo:evaluationJob:create"] "Effect": "Allow", }] } 示例2：拒绝用户删除评估项目 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先。 如果您给用户授予UGO FullAccess的系统策略，但不希望用户拥有UGO FullAccess中定义的删除评估项目，您可以创建一条拒绝删除云服务的自定义策略，然后同时将UGO FullAccess和拒绝策略授予用户，根据Deny优先原则，则用户可以对评估项目执行除了删除评估项目外的所有操作。拒绝策略示例如下： { "Version": "1.1", "Statement": [{ "Action": ["ugo:evaluationJob:delete"], "Effect": "Deny" }] }

创建委托 登录 统一身份认证 服务控制台，在左侧导航栏单击“委托”，进入“委托”界面。 单击“创建委托”，进入“创建委托”界面。 填写委托信息。 委托名称：输入“serverless_trust”。 委托类型：选择“云服务”。 云服务：选择“ 函数工作流 FunctionGraph”。 持续时间：选择“永久”。 权限选择：单击“配置权限”，在“配置权限”界面勾选“Tenant Administrator”，单击“确定”。 Tenant Administrator：拥有该权限的用户可以对企业拥有的所有云资源执行任意操作。 单击“确定”，完成权限委托设置。

告警消息推送 在 SMN 消息通知服务创建主题，此处以主题名称cts_test为例，创建过程请参考创建主题。 在SMN 消息通知 服务订阅主题，用于将告警消息推送至该主题下的订阅终端，此处以添加邮件订阅终端为例，订阅cts_test主题，订阅过程请参考订阅主题。 订阅主题可选择通过邮件、短信、HTTP/HTTPS等形式推送告警消息。 本案例中推送告警消息的事件是：当日志事件通过 CTS 触发器触发函数执行时，函数中过滤白名单告警日志，产生的告警消息推送至SMN主题的订阅终端。

在 云日志服务LTS 查询审计事件 在追踪器页面，单击system追踪器右侧的LTS日志流名称，进入到system-trace日志流详情页面。 图3 单击日志流名称 图4 system-trace日志流页面 单击右上角的“15分钟(相对)”，设置查询的时间范围。 在搜索框中输入trace_name : createServer，单击查询，查询创建云服务器的事件详情。 图5 搜索createServer事件

CTS最佳实践汇总 本文汇总了基于云审计服务（CTS，Cloud Trace Service）常见应用场景的操作实践，为每个实践提供详细的方案描述和操作指导，帮助用户轻松构建基于CTS的审计事件业务。 表1 CTS最佳实践一览表 最佳实践 说明 结合函数工作流对登录/登出进行审计分析 本章节介绍如何通过CTS云审计服务，完成对公有云账户的各个云服务资源操作和结果的实时记录。 通过在函数工作流服务中创建CTS触发器获取订阅的资源操作信息，经由自定义函数对资源操作的信息进行分析和处理，产生告警日志。再由SMN消息通知服务通过短信和邮件推送告警信息，通知业务人员进行处理。 CTS安全最佳实践 本章节提供了CTS使用过程中的安全最佳实践，旨在为提高整体安全能力提供可操作的规范性指导。 通过 云日志 服务LTS存储和查询审计事件 本章节以“创建云服务器”（操作名称：createServer）为例，为您介绍如何通过云日志服务（LTS）存储和查询审计事件。 使用云审计服务监控“创建 IAM 用户”操作 本章节为您介绍如何通过云审计服务的操作审计和关键操作通知功能，对“创建IAM用户”操作进行监控，并通过邮件通知方式进行告警。

处理结果 若用户触发账号的登录/登出操作，订阅服务类型日志被触发，日志会直接调用用户函数，通过函数代码对当前登录/出的账号进行IP过滤，若不在白名单内，可收到SMN发送的通知消息邮件，如图1所示。 图1 告警消息邮件通知 邮件信息中包含非法请求ip地址和用户执行的动作（login/logout）。 可以通过函数指标查看函数的调用情况，如图2所示。 图2 函数指标 父主题： 结合函数工作流对登录/登出进行审计分析

开启云审计服务配置OBS桶，将审计事件归档OBS永久存储 由于CTS只支持查询7天的审计事件，为了您事后审计、查询、分析等要求，启用CTS追踪器请配置OBS服务桶（建议您配置独立OBS桶并配置KMS加密存储专门用于归档审计事件）。当云上资源发生变化时，CTS服务将审计事件归档至OBS的桶，操作详情参考：追踪器配置OBS转储。 使用 数据加密 服务（DEW）中的密钥对OBS桶中的对象进行全量加密或者部分加密，详细操作请参见OBS服务端加密。 图1 配置转储 父主题： CTS安全最佳实践

准备工作 为用户添加操作权限。 如果您是以主账号登录华为云，请跳到下一个任务。 如果您是以IAM用户登录华为云，需要联系CTS管理员（主账号或admin用户组中的用户）对IAM用户授予CTS FullAccess权限。授权方法请参见给IAM用户授权。 开通消息通知服务(SMN)，并创建主题（本实践要求主题的名称为“cts-test”），添加订阅（本实践要求订阅的协议选择“邮件”），才能在CTS控制台使用关键操作消息通知功能。具体操作，请参见创建主题和添加订阅。 使用消息通知服务（SMN）创建主题、添加邮件订阅，这会产生额外费用，SMN的计费详情请参考产品价格详情。

步骤二：创建关键操作通知 在云审计控制台，单击左侧导航树的“关键操作通知”。 在关键操作通知界面，单击“创建关键操作通知”。 参照下表中的本实践要求参数，设置关键操作通知的参数信息，单击“确定”。 图2 创建关键操作通知 表1 设置参数信息 参数 参数说明 本实践要求 通知名称 填写通知的名称，用于标识和区分关键操作通知。 对创建IAM用户操作告警 操作类型 根据具体使用场景，选择“完整”和“自定义操作”触发场景。 自定义 操作列表 当操作类型选择“自定义”时，可以自定义选择触发通知的操作范围。 服务类型选择：IAM 资源类型选择：user 操作名称选择：createUser 高级筛选 可以通过配置筛选条件设置触发通知的操作范围。 不设置 指定用户 当指定的用户发起关键操作时，可以通过SMN通知相关的订阅者。 不指定 发送通知 当选择“发送”通知时，需要设置创建云服务委托和SMN主题。当选择“不发送”通知时，则无需配置。 发送 创建云服务委托 勾选创建云服务委托后，用户在创建关键操作通知时，云审计服务将会自动创建一个云服务委托，委托授权您使用消息通知服务（SMN）。 勾选 SMN主题 需要选择已创建的SMN主题或者单击链接跳转到消息通知服务页面创建新的主题。 cts-test

其他限制 云服务器因欠费而处于冻结状态，此时无法创建私有镜像，您必须先续费，解冻资源后再进行创建。 通过x86 CPU架构的云服务器创建的私有镜像，不能用于创建鲲鹏CPU架构的云服务器，也不能在鲲鹏CPU架构云服务器切换操作系统时使用。 通过外部镜像文件创建私有镜像时，若架构类型选择“x86”，则该私有镜像不能用于创建鲲鹏CPU架构的云服务器，也不能在鲲鹏CPU架构云服务器切换操作系统时使用。 32位操作系统的私有镜像不能创建超过4G内存规格的云服务器。因为32位系统的内存寻址空间最大为4GB。

前提条件 已准备好存有数据的MySQL数据库，本案例以云数据库的RDS for MySQ L实例 为例，具体操作请参见购买RDS for MySQL实例。 已准备好用于同步数据的Logstash集群，具体操作请参见xxx。本文以7.10.0版本的Logstash集群为例。 已准备好Elasticsearch集群，具体操作请参见。本文以7.10.2版本的Elasticsearch集群为例。 以上三者在同一VPC下面。 当使用的是自建或第三方MySQL数据库时，则需要确认数据库驱动是否是MariaDB驱动。 是，则可以直接开始配置数据同步。 否，则需要参考常见问题：MySQL驱动不兼容怎么办？上传与RDS版本兼容的SQL JDBC驱动到Logstash集群中。

约束限制 Elasticsearch中的_id字段必须与MySQL中的id字段相同。 这是为了确保当MySQL中的记录写入Elasticsearch时，同步任务可在MySQL记录与Elasticsearch索引之间建立一个直接映射的关系。例如，当MySQL中更新了某条记录时，同步任务会覆盖Elasticsearch中与更新记录具有相同ID的索引。 当MySQL中插入或者更新数据时，对应记录必须有一个包含更新或插入时间的字段。 Logstash在每次轮询MySQL时，会记录最后读取记录的时间戳，并在下一次读取时只获取该时间戳之后更新或插入的符合条件的记录。 确保MySQL数据库、Logstash集群和Elasticsearch集群在同一时区，否则当同步与时间相关的数据时，同步前后的数据可能存在时区差。

应用场景 CSS 服务的Logstash集群默认安装了logstash-input-jdbc插件，该插件为Logstash提供了从关系型数据库RDS MySQL中导入和处理数据的能力，通过配置Logstash配置文件，定义JDBC输入和Elasticsearch输出，实现定期同步数据库中的数据到Elasticsearch。该方案可以用于以下场景： 数据实时更新与同步：将RDS MySQL中的数据实时同步到Elasticsearch，以便利用Elasticsearch强大的搜索和分析能力。 日志分析 与检索：将MySQL中的日志数据同步到Elasticsearch，进行快速检索和分析。 应用性能监控：将应用性能数据存储在MySQL中，通过Logstash同步到Elasticsearch，进行实时监控和性能分析。 数据备份与恢复：通过Logstash将MySQL数据备份到Elasticsearch，以便在数据丢失或损坏时快速恢复。

方案架构 图1 RDS MySQL数据同步至Elasticsearch 使用Logstash将RDS MySQL数据同步至Elasticsearch的方案流程如图1所示。 在 CS S服务的Logstash中通过默认插件logstash-input-jdbc，在Logstash配置文件中配置数据库JDBC输入和Elasticsearch输出，将全量或增量RDS MySQL数据实时同步至Elasticsearch。

迁移时长 迁移过程的耗时长短依赖于源集群和目标集群的节点个数或索引shard个数。迁移过程分为备份阶段和恢复阶段，备份阶段耗时由源集群决定，恢复阶段耗时由目标集群决定。迁移总时长的评估公式如下： 当索引shard个数大于节点个数时 总时长(S)=（800G÷40MB÷源集群节点个数+800G÷40MB÷目的集群节点个数）x索引个数 当索引shard个数小于节点个数时 总时长(S)=（800G÷40MB÷源集群索引shard个数+800G÷40MB÷目的集群索引shard个数）x索引个数 评估公式是基于理想状态下（即单节点以最快速度40MB/s传输）的迁移时长，实际迁移时长还会受到网络、资源等因素影响。

方案优势 易于操作和管理：在CSS服务控制台使用集群快照功能实现备份恢复，操作简单，且易于管理和自动化。 适用于大规模数据迁移：快照备份适用于数据量大的场景，特别是当数据量达到GB、TB甚至PB级别时。 支持跨地域和跨账号迁移：通过结合OBS的跨区域复制功能，可以实现跨地域和跨账号的数据迁移。 恢复过程可控：在恢复数据时，可以选择恢复特定索引或全部索引，并且可以指定恢复到特定的集群状态。 迁移时长可控：基于迁移时长评估公式可以配置数据迁移速率，理想状态下等于文件复制速率。

应用场景 通过备份与恢复实现华为云Elasticsearch集群间数据迁移仅适用于源集群和目标集群都是CSS服务的集群，且依赖 对象存储服务 OBS。常用于以下场景： 跨地域或跨账号迁移：将其他Region或账号下的Elasticsearch集群迁移到当前集群中。 跨版本迁移：将低版本的Elasticsearch集群数据迁移到高版本的集群中。 集群合并：将两个Elasticsearch集群的索引数据合并到一个集群中。

前提条件 源Elasticsearch集群和目标Elasticsearch集群处于可用状态。 集群间需要保证网络连通。 如果源集群、Logstash和目标集群在不同VPC，则需要先打通VPC网络建立对等连接。具体操作请参见对等连接简介。 如果是自建Elasticsearch集群迁移至华为云，则可以通过给自建Elasticsearch集群配置公网访问打通网络。 如果是第三方Elasticsearch集群迁移至华为云，则需要建立企业内部数据中心到华为云的VPN通道或专线。 确认集群的索引已开启“_source”。 集群索引的“_source”默认是开启的。执行命令GET {index}/_search，当返回的索引信息里有“_source”信息时表示已开启。