更新时间:2024-09-05 GMT+08:00
分享

字符类型

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

表1 字符类型

名称

描述

存储空间

CHAR(n)

CHARACTER(n)

NCHAR(n)

定长字符串,不足补空格。n是指字节长度,如不带精度n,默认精度为1。

最大为10MB。

当sql_compatibility = 'B'时,设置参数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-4(存储长度参数的空间)-其余列长度,比如表格式为(a int, b varchar, c int),varchar最大长度为1GB-85-4(存储长度参数的空间)-4(a列int的长度)-4(c列int的长度)=1,073,741,727‬。详情见变长类型最大存储长度说明示例

当sql_compatibility = 'B'时,设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后:

  • n指字符长度,区间[0,10485760],如不带精度n,默认为不限制长度,长度与TEXT类型相同。
  • 输入:
    • 作为表列和临时变量的数据类型:输入字符串字符个数在范围内可以正常输入,sql_mode参数值包含“strict_trans_tables”时,超过范围直接报错,否则按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)类型的别名,为兼容Oracle类型。

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

文本大对象,兼容Oracle类型。

在astore下,最大为32TB-1,但还需要考虑到列描述头信息的大小,以及列所在元组的大小限制(也小于32TB-1),因此CLOB类型最大值可能小于32TB-1。

在ustore下,最大为1GB-1,但还需要考虑到列描述头信息的大小,以及列所在元组的大小限制(也小于1GB-1),因此CLOB类型最大值可能小于1GB-1。

TINYTEXT

MEDIUMTEXT

LONGTEXT

当sql_compatibility = 'B'时,设置参数b_format_version = '5.7'、b_format_dev_version = 's1'后有效。

类型转换成TEXT类型,使用场景与TEXT类型相同。

最大为1GB-1,但还需要考虑到列描述头信息的大小,以及列所在元组的大小限制(也小于1GB-1),因此类型最大值可能小于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)
    );
    
    --插入数据。
    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;
    
    -- 示例:char和varchar类型。
    -- 创建B兼容模式下的数据库。
    gaussdb=# create database gaussdb_m  with dbcompatibility  'b';
    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;
  • 变长类型最大存储长度说明示例。

    此示例以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));

相关文档