GaussDB支持的字符类型

字符类型

GaussDB支持的字符类型如表1所示 。字符串操作符和相关的内置函数请参见字符处理函数和操作符。

表1 字符类型

名称	描述	存储空间
CHAR(n) CHARACTER(n) NCHAR(n)	定长字符串，不足补空格。n是指字节长度，如不带精度n，默认精度为1。	n最大为10485760（即10MB）。
	当sql_compatibility = 'MYSQL'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后： 类型：n指字符长度，区间[0,10485760]。如不带精度n，默认精度为1。定长字符串，不足补充空格。 输入： 作为表列和临时变量的数据类型：输入字符串字符个数在范围内可以正常输入，sql_mode参数值包含“strict_trans_tables”时，超过范围直接报错，否则按n最大字符长度截断处理并告警。 输出： 作为表列和临时变量的数据类型：sql_mode参数值包含“pad_char_to_full_length”时，输出带有尾部空格的字符串，否则输出不带尾部空格的字符串。 作为函数参数和返回值，存储过程的参数：不支持长度校验（例如：自定义函数入参为CHAR(5)类型，输入一个字符串'123456'，不校验长度，可以直接传入参数）。	最大为10M个字符。
VARCHAR(n) CHARACTER VARYING(n)	变长字符串。PG兼容模式下，n是字符长度。其他兼容模式下，n是指字节长度。	n最大为10485760（即10MB）。 不带n最大存储长度为1GB-85-前n列长度，比如(a int, b varchar)最大长度为1GB-85-4=1,073,741,735‬。
	当sql_compatibility = 'MYSQL'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后： n指字节长度，区间[0,10485760]，如不带精度n，默认为不限制长度，长度与TEXT类型相同。 输入： 作为表列和临时变量的数据类型：输入字符串字符个数在范围内可以正常输入，sql_mode参数值包含“strict_trans_tables”时，超过范围直接报错，否则按n最大字符长度截断处理并告警。 输出：原字符串输出。	带有n最大为10M个字符，不带n的情况最大存储长度为1GB-85-前n列长度，比如(a int, b varchar)最大长度为1GB-85-4=1,073,741,735‬。
VARCHAR2(n)	变长字符串。是VARCHAR(n)类型的别名。	n最大为10485760（即10MB）。 不带n最大存储长度为1GB-85-前n列长度，比如(a int, b varchar)最大长度为1GB-85-4=1,073,741,735‬。
NVARCHAR2(n)	变长字符串。在SQL_ASCII字符集下，n表示的字节；在非SQL_ASCII字符集下，n表示的是字符。	n最大为10485760（即10MB）。 不带n最大存储长度为1GB-85-前n列长度，比如(a int, b varchar)最大长度为1GB-85-4=1,073,741,735‬。
TEXT	变长字符串。	最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此TEXT类型最大值可能小于1GB-1。
CLOB	文本大对象。	在ustore下，最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此CLOB类型最大值可能小于1GB-1。
TINYTEXT MEDIUMTEXT LONGTEXT	当sql_compatibility = 'MYSQL'时，设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后可以使用这些类型。 类型转换成TEXT类型，使用场景与TEXT类型相同。	最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此TEXT类型最大值可能小于1GB-1。

1. 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-1字节，主要受列的控制头信息、元组控制头信息以及元组中是否存在NULL字段等影响。
2. NCHAR为bpchar类型的别名，VARCHAR2(n)为VARCHAR(n)类型的别名。
3. 超过1GB的clob只有dbe_lob相关高级包支持，系统函数不支持大于1GB clob。
4. 在A兼容模式下，默认将接收到的空字符串转换为null。

GaussDB还支持另外两种定长字符类型，如表2所示。name类型只用在内部系统表中，作为存储标识符，不建议普通用户使用。该类型长度当前定为64字节（63可用字符加结束符）。类型“char”只用了一个字节的存储空间，在系统内部主要用于系统表，主要作为简单化的枚举类型使用。

表2 特殊字符类型

名称	描述	存储空间
name	用于对象名的内部类型。	64字节。
"char"	单字节内部类型。	1字节。

示例

--创建表。
gaussdb=# CREATE TABLE char_type_t1 
(
    CT_COL1 CHARACTER(4)
)DISTRIBUTE BY HASH (CT_COL1);

--插入数据。
gaussdb=# INSERT INTO char_type_t1 VALUES ('ok');

--查询表中的数据。
gaussdb=# SELECT ct_col1, char_length(ct_col1) FROM char_type_t1;
 ct_col1 | char_length 
---------+-------------
 ok      |           4
(1 row)

--删除表。
gaussdb=# DROP TABLE char_type_t1;

 

 

--创建表。
gaussdb=# CREATE TABLE char_type_t2  
(
    CT_COL1 VARCHAR(5)
)DISTRIBUTE BY HASH (CT_COL1);

--插入数据。
gaussdb=# INSERT INTO char_type_t2 VALUES ('ok');

gaussdb=# INSERT INTO char_type_t2 VALUES ('good');

--插入的数据长度超过类型规定的长度报错。
gaussdb=# INSERT INTO char_type_t2 VALUES ('too long');
ERROR:  value too long for type character varying(5)
CONTEXT:  referenced column: ct_col1

--明确类型的长度，超过数据类型长度后会自动截断。
gaussdb=# INSERT INTO char_type_t2 VALUES ('too long'::varchar(5));

--查询数据。
gaussdb=# SELECT ct_col1, char_length(ct_col1) FROM char_type_t2;
 ct_col1 | char_length 
---------+-------------
 ok      |           2
 good    |           4
 too l   |           5
(3 rows)

--删除数据。
gaussdb=# DROP TABLE char_type_t2;

-- 示例：char和varchar类型。
-- 创建MYSQL兼容模式下的数据库。
gaussdb=# create database gaussdb_m  with dbcompatibility  'MYSQL';
gaussdb=# \c gaussdb_m
-- 设置兼容版本控制参数。
gaussdb_m=# set b_format_version='5.7';
gaussdb_m=# set b_format_dev_version='s1';
-- 创建表。
gaussdb_m=# create table t1(a char(5), b varchar(5));
-- 插入数据。
gaussdb_m=# insert into t1 values('一二三四五','一二三四五');
-- 查看数据。
gaussdb_m=# select char_length(a),char_length(b) from t1;
 char_length | char_length 
-------------+-------------
           5 |           5
(1 row)
gaussdb_m=# select length(a),length(b) from t1;
 length | length 
--------+--------
     15 |     15
(1 row)
gaussdb_m=# select * from t1;
     a      |     b      
------------+------------
 一二三四五 | 一二三四五
(1 row)
-- 删除表。
gaussdb_m=# drop table t1;
-- 示例：tinytext，mediumtext，longtext类型。
-- 创建表。
gaussdb_m=# create table t2(a tinytext, b mediumtext, c longtext);
-- 插入数据。
gaussdb_m=# insert into t2 values('abcde','abcde','abcde');
-- 查看数据。
gaussdb_m=# select * from t2;
   a   |   b   |   c   
-------+-------+-------
 abcde | abcde | abcde
(1 row)
-- 删除表和数据库。
gaussdb_m=# drop table t2;
gaussdb_m=# \c postgres;
gaussdb=# drop database gaussdb_m;
-- 重置参数。
gaussdb=# reset all;

 

 

 

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html