字符类型
GaussDB支持的字符类型请参见表1。字符串操作符和相关的内置函数请参见字符处理函数和操作符。
|
名称 |
描述 |
存储空间 |
|---|---|---|
|
CHAR(n) CHARACTER(n) NCHAR(n) |
定长字符串，不足补空格。n是指字节长度，如不带精度n，默认精度为1。 |
最大为10MB。 |
|
VARCHAR(n) CHARACTER VARYING(n) |
变长字符串。PG兼容模式下，n是字符长度。其他兼容模式下，n是指字节长度。 |
n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如表格式为(a int, b varchar, c int)，varchar最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727。详情请参见变长类型最大存储长度说明示例。 |
|
VARCHAR2(n) |
变长字符串。是VARCHAR(n)类型的别名。n是指字节长度。 |
n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如表格式为(a int, b varchar2, c int)，varchar2最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727。详情请参见变长类型最大存储长度说明示例。 |
|
NVARCHAR2(n) |
变长字符串。在SQL_ASCII字符集下，n表示字节；在非SQL_ASCII字符集下，n表示字符。 |
n最大为10485760（即10MB）。 不带n时，最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如表格式为(a int, b nvarchar2, c int)，nvarchar2最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727。详情请参见变长类型最大存储长度说明示例。 |
|
TEXT |
变长字符串。 |
最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如表格式为(a int, b text, c int)，text最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727。详情请参见变长类型最大存储长度说明示例。 |
|
CLOB |
文本大对象。是TEXT类型的别名。 |
在astore下，最大为32TB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于32TB-1），因此CLOB类型最大值可能小于32TB-1。 在ustore下，最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此CLOB类型最大值可能小于1GB-1。 |
- 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-1字节，主要受列的控制头信息、元组控制头信息以及元组中是否存在NULL字段等影响。
- NCHAR为bpchar类型的别名，VARCHAR2(n)为VARCHAR(n)类型的别名。
- 超过1GB的clob只有dbe_lob相关高级包支持，系统函数不支持大于1GB clob。
- 在A兼容性下，默认将接收到的空字符串转换为null。
- GaussDB最大支持1GB数据传输，函数返回结果字符串最大支持1GB。
- GaussDB目前所支持的字符集可以参考CREATE DATABASE章节中ENCODING部分介绍。
在GaussDB里另外还有两种定长字符类型。在表2里显示。name类型只用在内部系统表中，作为存储标识符，不建议普通用户使用。该类型长度当前定为64字节（63可用字符加结束符）。类型"char"只用了一个字节的存储空间。它在系统内部主要用于系统表，主要作为简单化的枚举类型使用。
示例
- 插入的数据长度超过类型规定的长度的示例。
--创建表。 gaussdb=# CREATE TABLE char_type_t1 ( CT_COL1 CHARACTER(4) ); --插入数据。 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) ); --插入数据。 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;
- 变长类型最大存储长度说明示例。
此示例以varchar为例，varchar2/nvarchar/nvarchar2/text同理。
-- 创建表，表中有三列，分别为int、varchar、int，根据计算规则，varchar最大存储长度为1GB-85-4-4-4=1073741727。 gaussdb=# CREATE TABLE varchar_maxlength_test1 (a int, b varchar, c int); -- varchar为1073741728，超过规定长度，插入失败。 gaussdb=# insert into varchar_maxlength_test1 values(1, repeat('a', 1073741728), 1); ERROR: invalid memory alloc request size 1073741824 in tuplesort.cpp:219 -- varchar为1073741727，长度符合要求，插入成功。 gaussdb=# insert into varchar_maxlength_test1 values(1, repeat('a', 1073741727), 1); -- 创建表，表中仅varchar一列，根据计算规则，varchar最大存储长度为1GB-85-4=1073741735。 gaussdb=# CREATE TABLE varchar_maxlength_test2 (a varchar); -- varchar为1073741736，超过规定长度，插入失败。 insert into varchar_maxlength_test2 values(repeat('a', 1073741736)); ERROR: invalid memory alloc request size 1073741824 in tuplesort.cpp:219 -- varchar为1073741735，长度符合要求，插入成功。 insert into varchar_maxlength_test2 values(repeat('a', 1073741735));
