系统限制

本主题描述了使用 StarRocks 时适用的规则和限制。

• StarRocks 使用 MySQL 协议进行通信。您可以通过 MySQL 客户端或 JDBC 连接到 StarRocks 集群。建议您使用 5.1 或更高版本的 MySQL 客户端。低于 5.1 的版本不支持超过 16 个字符的用户名。

• 对象（例如目录、数据库、表、视图、分区、列、索引、用户名、角色、存储库、资源、存储卷和管道）的命名约定

  • 名称只能由数字 (0-9)、字母 (a-z 或 A-Z) 和下划线 (_) 组成。 用户名可以全部为数字。
  • 名称可以字母或下划线 (_) 开头。
  • 名称长度不能超过 64 个字符，其中：
    • 数据库名称不能超过 256 个字符。
    • 表名和列名不能超过 1024 个字符。
    • 用户名不能超过 128 个字符。
  • 列名（列别名）、分区名和索引名不区分大小写。其他名称区分大小写。

• 标签的命名约定：您可以在加载数据时指定作业的标签。标签名称可以由数字 (0-9)、字母 (a-z 或 A-Z) 和下划线 (_) 组成，且长度不得超过 128 个字符。标签名称可以字母或下划线 (_) 开头。

• 创建表时，键列不能是 FLOAT 或 DOUBLE 类型。您可以使用 DECIMAL 类型表示小数。

• VARCHAR 值的最大长度在不同版本中有所不同

  • 在 StarRocks 2.1 之前的版本中，长度范围为 1 到 65533 字节。
  • [预览] 在 StarRocks 2.1 及更高版本中，长度范围为 1 到 1048576 字节。VARCHAR 值的最大长度 = 最大行大小（1048578 字节）- 长度前缀（2 字节）。长度前缀表示值中的字节数。
  • 默认长度为 1 字节。

• StarRocks 仅支持 UTF-8 编码，不支持 GBK。

• StarRocks 不支持修改现有表的表类型。例如，您不能将 Duplicate Key 表更改为 Primary Key 表。您必须创建一个新表。

• 默认情况下，一个查询最多可以嵌套 10,000 个子查询，这由 FE 参数 expr_children_limit 控制。