跳到主要内容

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 列已经溢出行外存储，则会报错无法导入数据。

使用示例​

  1. 创建表 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;

  2. String 列 col2 上创建索引 idx_test_tbl1。

    CREATE INDEX idx_test_tbl1 ON test_tbl1(col2);

  3. 查看表 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

  4. 向表 test_tbl1 中插入测试数据。

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

  5. 查看表 test_tbl1 中的数据。

    SELECT * FROM test_tbl1;

    返回结果如下：

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

Contents

编辑此页