版本：V1.0.0

STRING 类型

STRING 类型作为文本类型的一种，可以更好地支持和迁移 AP 业务，也支持作为主键的不定长字符串。

基本功能

在创建表时，STRING 类型无需指定数据长度，最大可存储的数据长度为 16M（16777216 字节）。
STRING 类型的列（以下简称 String 列）可以作为主键列和索引列，也可以作为 Key/Range columns/List columns 分区类型的分区键。
STRING 类型是一种特殊的 LOB 类型：
- STRING 类型是非主键列，当长度超过 LOB_INROW_THRESHOLD（LOB 列的阈值）时，会溢出到行外存储。
- STRING 类型是主键列，所有数据会行内存储，数据长度会受主键长度的限制。

使用限制

STRING 类型的默认值只支持 NULL。
STRING 类型做非主键列时，是否溢出行外存储受 LOB_INROW_THRESHOLD 的影响。

有关 LOB_INROW_THRESHOLD 的介绍信息，参见 LOB 类型和 ob_default_lob_inrow_threshold。
String 列做主键或索引键时，写入（或更新）时会检查主键或索引键长度，超过 16K 会报错。
创建包含 String 列的索引时，如果主表上的 String 列已经溢出行外存储，则会报错无法创建索引。
String 列创建索引之后，如果写入（或更新） String 列的数据，数据需要溢出行外存储（即数据长度大于LOB_INROW_THRESHOLD），会报错无法写入/更新数据。
String 列做分区键时，如果写入（或更新）数据是已经溢出的 LOB，则会报错无法写入（或更新）数据。（例如：INSERT INTO ... SELECT ...，SELECT 的数据是溢出的）。
旁路导入场景中，如果目标表 String 列上存在索引，并且导入数据后在目标表上 String 列需要溢出行外存储（即数据长度大于 LOB_INROW_THRESHOLD），会报错无法导入数据。
增量旁路导入场景中，如果目标表 String 列上存在索引，源表上对应String 列已经溢出行外存储，则会报错无法导入数据。

使用示例

创建表 test_tbl1，其中 col1、col2、col3 为 String 列，并且 col1 列为主键，表按照 col1 的值进行 KEY 分区，分成 4 个分区。

CREATE TABLE test_tbl1 (col1 STRING PRIMARY KEY,
    col2 STRING,
    col3 STRING,
    col4 VARCHAR(10))
    PARTITION BY KEY(col1) PARTITIONS 4;

String 列 col2 上创建索引 idx_test_tbl1。

CREATE INDEX idx_test_tbl1 ON test_tbl1(col2);

查看表 test_tbl1 定义。

SHOW CREATE TABLE test_tbl1;

返回结果如下：

+-----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table     | Create Table                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+-----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| test_tbl1 | CREATE TABLE `test_tbl1` (
`col1` string NOT NULL,
`col2` string DEFAULT NULL,
`col3` string DEFAULT NULL,
`col4` varchar(10) DEFAULT NULL,
PRIMARY KEY (`col1`),
KEY `idx_test_tbl1` (`col2`) BLOCK_SIZE 16384 LOCAL
) ORGANIZATION INDEX DEFAULT CHARSET = utf8mb4 ROW_FORMAT = DYNAMIC COMPRESSION = 'zstd_1.3.8' REPLICA_NUM = 1 BLOCK_SIZE = 16384 USE_BLOOM_FILTER = FALSE ENABLE_MACRO_BLOCK_BLOOM_FILTER = FALSE TABLET_SIZE = 134217728 PCTFREE = 0
partition by key(col1)
(partition `p0`,
partition `p1`,
partition `p2`,
partition `p3`) |
+-----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set

向表 test_tbl1 中插入测试数据。

INSERT INTO test_tbl1 VALUES("A1", "B1", "C1", "D1"),("A2", "B2", "C2", "D2");

查看表 test_tbl1 中的数据。

SELECT * FROM test_tbl1;

返回结果如下：

+------+------+------+------+
| col1 | col2 | col3 | col4 |
+------+------+------+------+
| A2   | B2   | C2   | D2   |
| A1   | B1   | C1   | D1   |
+------+------+------+------+
2 rows in set

基本功能​

使用限制​

使用示例​

Contents

基本功能

使用限制

使用示例