GaussDB 数据库字符编码与兼容模式

一、问题现象

华为云GaussDB数据库兼容4种数据库类型，在创建数据库之前要确认清楚兼容数据库的类型与字符编码。比如在mysql5.7以上支持insert on duplicate key update SQL语法,若在GaussDB集中式环境创建数据库时默认为O数据库,针对O类型数据库不支持上面mysql5.7 SQL语法，执行时会产生SQL错误，这篇技术文章为了详细说明GaussDB支持的兼容数据库与字符编码。

二、技术背景

GaussDB创建一个新的数据库。缺省情况下新数据库将通过复制标准系统数据库template0来创建，且仅支持使用template0来创建。

• 场景1：集中式创建库语法：

  CREATE DATABASE database_name
    [ [ WITH ] { [ OWNER [=] user_name ] |
               [ TEMPLATE [=] template ] |
               [ ENCODING [=] 'encoding' ] |
               [ LC_COLLATE [=] 'lc_collate' ] |
               [ LC_CTYPE [=] 'lc_ctype' ] |
               [ DBCOMPATIBILITY [=] 'compatibilty_type' ] |
               [ TABLESPACE [=] tablespace_name ] |
               [ CONNECTION LIMIT [=] connlimit ] |
               [ DBTIMEZONE [=] 'time_zone' ]}[...] ];

ENCODING参数为可选，指定数据库使用的字符编码，可以是字符串（如'SQL_ASCII'）、整数编号。不指定时，默认使用模版数据库的编码。模板数据库template0和template1的编码默认与操作系统环境相关。template1不允许修改字符编码，因此若要变更编码，请使用template0创建数据库。常用取值：GBK、UTF8、Latin1、GB18030等，具体支持的字符集如下。

表1 GaussDB KernelopenGaussGaussDB字符集

DBCOMPATIBILITY 可选参数。指定兼容的数据库的类型，默认兼容O。取值范围：A、B、C、PG。分别表示兼容O、MY、TD和POSTGRES。

• 场景2：分布式GausssDB创建库语法

创建库语法跟集式式是一样的，支持的字符编码也一样。区别在于DBCOMPATIBILITY兼容性参数值不一样：DBCOMPATIBILITY也为可选参数，指定兼容的数据库的类型，默认兼容MySQL。取值范围：MYSQL、TD、ORA、PG。分别表示兼容MySQL、TD（Teradata）、Oracle和PostgreSQL。

三、处理过程

因业务需求分别在GaussDB集中式与分布式环境下，创建GB18030的字符编码并且兼容Oracle数据库，本实例以fx为库名，处理过程以下：

• 集中式：

[omm@db01 ~]$ gsql -d postgres -p 30100  -ar
gaussdb=# create database fx encoding 'GB18030' dbcompatibility='A';
CREATE DATABASE
gaussdb=# select datname, pg_encoding_to_char(encoding),datcompatibility from pg_database where  datname='fx';
 datname | pg_encoding_to_char | datcompatibility
---------+---------------------+------------------
 fx      | GB18030             | A
(1 row)
gaussdb=#

• 分布式：

gaussdb=> create database fx encoding 'GB18030' dbcompatibility='ORA';
CREATE DATABASE
gaussdb=> select datname, pg_encoding_to_char(encoding),datcompatibility from pg_database where  datname='fx';
 datname | pg_encoding_to_char | datcompatibility
---------+---------------------+------------------
 fx      | GB18030             | ORA
(1 row)

gaussdb=>

四、总结

使用GaussDB数据库创建数据库前，需要按照业务场景确认数据库采用的字符编码与数据库兼容模式，特别是在做应用适配时确认源库的字符编码与源库的数据类型。