跳到主要内容
版本:3.2

系统限制

本文介绍使用 StarRocks 系统时需要注意的事项。

  • StarRocks 采用 MySQL 协议进行通信,用户可通过 MySQL Client 或者 JDBC 连接到 StarRocks 集群。选择 MySQL Client 版本时建议采用 5.1 及之后的版本,5.1 之前版本不支持长度超过 16 个字符的用户名。

  • 对名称的要求,包括数据目录名 (catalog)、数据库名、表名、视图名、分区名、列名、索引名、用户名、角色名、仓库名 (repository)、资源名 (resource)、存储卷名 (Storage Volume)、Pipe 名等:

    • 只能由数字 (0-9)、字母 (a-z或A-Z),以及下划线 (_) 组成。用户名 (username) 可以使用纯数字命名。
    • 可以以字母或下划线开头。
    • 长度不能超过 64 个字符。几个特殊情况:
      • 数据库名不能超过 256 个字符。
      • 表名和列名不能超过 1024 个字符。
      • 用户名 (username) 不能超过 128 个字符。
    • 列名(包括列别名)、分区名、索引名大小写不敏感,其他名称大小写敏感
  • 对标签(Label)名的要求: 导入数据时可指定任务的标签(Label)。标签名可由数字 (0-9)、字母(a-z或A-Z),以及下划线(_)组成,且长度不能超过 128 个字符。标签名以字母或下划线开头。

  • 建表时,Key 列不能使用 FLOAT 或者 DOUBLE 类型,可用 DECIMAL 类型表示小数。

  • VARCHAR 最大长度:

    • 对于 StarRocks 2.1 之前的版本,长度范围为 1~65533 字节。
    • 【公测中】自 StarRocks 2.1 版本开始,长度范围为 1~1048576 字节。1048578(行最大值)- 2(长度标识位,记录实际数据长度)= 1048576。
  • StarRocks 仅支持 UTF8 编码,不支持 GBK 等编码。

  • 建表后,表类型不支持修改(比如不能将已有的明细表修改为主键表)。如果需要修改表类型,请重新建表。

  • StarRocks 不支持修改表的列名。

  • 一个查询中子查询的最大个数默认为 10000,可以通过 FE 参数 expr_children_limit 设置。