# 字符类型 GaussDB支持的字符类型请参见[表1]。字符串操作符和相关的内置函数请参见[字符处理函数和操作符](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0346.html#ZH-CN_TOPIC_0000002235270249)。 表1字符类型 | 名称 | 描述 | 存储空间 | |:---|:---|:---| | CHAR(n) CHARACTER(n) NCHAR(n) | 定长字符串，不足补空格。n是指字节长度，如不带精度n，默认精度为1。 | n最大为10485760（即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‬。详情请参见[变长类型最大存储长度说明示例。] | | CLOB | 文本大对象。 | 在astore下，最大为32TB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于32TB-1），因此CLOB类型最大值可能小于32TB-1。 在ustore下，最大为1GB-1，但还需要考虑到列描述头信息的大小，以及列所在元组的大小限制（也小于1GB-1），因此CLOB类型最大值可能小于1GB-1。 | | TEXT | 变长字符串。 | 最大存储字节长度为1GB-85-4(存储长度参数的空间)-其余列长度，比如表格式为(a int, b text, c int)，text最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。详情请参见[变长类型最大存储长度说明示例。] | ![](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/public_sys-resources/note_3.0-zh-cn.png) 1. 除了每列的大小限制以外，每个元组的总大小也不可超过1GB-85字节，主要受列的控制头信息、元组控制头信息以及元组中是否存在NULL字段等影响。 2. NCHAR为bpchar类型的别名，VARCHAR2(n)为VARCHAR(n)类型的别名。 3. 超过1GB的clob只有dbe_lob相关高级包支持，系统函数不支持大于1GB clob。 4. 在ORA兼容性下，默认将接收到的空字符串转换为null。 5. GaussDB最大支持1GB数据传输，函数返回结果字符串最大支持1GB。 6. GaussDB目前所支持的字符集可以参考[7.15.61 CREATE DATABASE](https://support.huaweicloud.com/distributed-devg-v3-gaussdb/gaussdb-12-0514.html#ZH-CN_TOPIC_0000002200350050)章节中ENCODING部分介绍。 在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; ``` - 变长类型最大存储长度说明示例。 此示例以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) DISTRIBUTE BY HASH (a); --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) DISTRIBUTE BY HASH (a); --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)); ```