Documentation Home
MySQL 8.0 参考手册  / 第8章优化  / 8.4 优化数据库结构  /  8.4.7 表列数和行大小的限制

8.4.7 表列数和行大小的限制

本节介绍对表中列数和各行大小的限制。

列数限制

MySQL 对每个表有 4096 列的硬限制,但对于给定的表,有效最大值可能会更少。确切的列限制取决于几个因素:

行大小限制

给定表的最大行大小由几个因素决定:

  • MySQL 表的内部表示具有 65,535 字节的最大行大小限制,即使存储引擎能够支持更大的行也是如此。 BLOBTEXT列仅对行大小限制贡献 9 到 12 个字节,因为它们的内容与行的其余部分分开存储。

  • 适用于本地存储在数据库页面中的数据的表的最大行大小InnoDB 略小于 4KB、8KB、16KB 和 32KB innodb_page_size 设置的半页。InnoDB例如,对于默认的 16KB页面大小,最大行大小略小于 8KB 。对于 64KB 页面,最大行大小略小于 16KB。请参阅 第 15.22 节,“InnoDB 限制”

    如果包含 可变长度列的行超过InnoDB 最大行大小,则InnoDB选择可变长度列用于外部页外存储,直到该行符合InnoDB 行大小限制。对于页外存储的可变长度列,本地存储的数据量因行格式而异。有关更多信息,请参阅 第 15.10 节,“InnoDB 行格式”

  • 不同的存储格式使用不同数量的页眉和页尾数据,这会影响可用于行的存储量。

行大小限制示例
  • MySQL 的最大行大小限制为 65,535 字节,在以下示例中InnoDB 进行了MyISAM说明。无论存储引擎如何,都会强制执行该限制,即使存储引擎可能能够支持更大的行。

    mysql> CREATE TABLE t (a VARCHAR(10000), b VARCHAR(10000),
           c VARCHAR(10000), d VARCHAR(10000), e VARCHAR(10000),
           f VARCHAR(10000), g VARCHAR(6000)) ENGINE=InnoDB CHARACTER SET latin1;
    ERROR 1118 (42000): Row size too large. The maximum row size for the used
    table type, not counting BLOBs, is 65535. This includes storage overhead,
    check the manual. You have to change some columns to TEXT or BLOBs
    mysql> CREATE TABLE t (a VARCHAR(10000), b VARCHAR(10000),
           c VARCHAR(10000), d VARCHAR(10000), e VARCHAR(10000),
           f VARCHAR(10000), g VARCHAR(6000)) ENGINE=MyISAM CHARACTER SET latin1;
    ERROR 1118 (42000): Row size too large. The maximum row size for the used
    table type, not counting BLOBs, is 65535. This includes storage overhead,
    check the manual. You have to change some columns to TEXT or BLOBs

    在以下MyISAM示例中,更改列以TEXT 避免 65,535 字节的行大小限制并允许操作成功,因为 BLOBTEXT仅对行大小贡献 9 到 12 字节。

    mysql> CREATE TABLE t (a VARCHAR(10000), b VARCHAR(10000),
           c VARCHAR(10000), d VARCHAR(10000), e VARCHAR(10000),
           f VARCHAR(10000), g TEXT(6000)) ENGINE=MyISAM CHARACTER SET latin1;
    Query OK, 0 rows affected (0.02 sec)

    该操作对InnoDB 表成功,因为更改列以 TEXT避免 MySQL 65,535 字节的行大小限制,并且InnoDB 可变长度列的页外存储避免了 InnoDB行大小限制。

    mysql> CREATE TABLE t (a VARCHAR(10000), b VARCHAR(10000),
           c VARCHAR(10000), d VARCHAR(10000), e VARCHAR(10000),
           f VARCHAR(10000), g TEXT(6000)) ENGINE=InnoDB CHARACTER SET latin1;
    Query OK, 0 rows affected (0.02 sec)
  • 可变长度列的存储包括计入行大小的长度字节。例如,一 VARCHAR(255) CHARACTER SET utf8mb3列需要两个字节来存储值的长度,因此每个值最多可以占用 767 个字节。

    创建表的语句t1 成功,因为列需要 32,765 + 2 字节和 32,766 + 2 字节,这在 65,535 字节的最大行大小范围内:

    mysql> CREATE TABLE t1
           (c1 VARCHAR(32765) NOT NULL, c2 VARCHAR(32766) NOT NULL)
           ENGINE = InnoDB CHARACTER SET latin1;
    Query OK, 0 rows affected (0.02 sec)

    create table语句t2失败是因为虽然列长度在65535字节的最大长度以内,但是需要额外增加两个字节来记录长度,导致行大小超过65535字节:

    mysql> CREATE TABLE t2
           (c1 VARCHAR(65535) NOT NULL)
           ENGINE = InnoDB CHARACTER SET latin1;
    ERROR 1118 (42000): Row size too large. The maximum row size for the used
    table type, not counting BLOBs, is 65535. This includes storage overhead,
    check the manual. You have to change some columns to TEXT or BLOBs

    将列长度减少到 65,533 或更少允许语句成功。

    mysql> CREATE TABLE t2
           (c1 VARCHAR(65533) NOT NULL)
           ENGINE = InnoDB CHARACTER SET latin1;
    Query OK, 0 rows affected (0.01 sec)
  • 对于MyISAM表格, NULL列需要在行中有额外的空间来记录它们的值是否为 NULL. 每NULL 列额外占用一位,四舍五入到最接近的字节。

    create table 语句t3失败,因为除了可变长度列长度字节所需的空间外,还 MyISAM需要列空间,导致行大小超过 65,535 字节:NULL

    mysql> CREATE TABLE t3
           (c1 VARCHAR(32765) NULL, c2 VARCHAR(32766) NULL)
           ENGINE = MyISAM CHARACTER SET latin1;
    ERROR 1118 (42000): Row size too large. The maximum row size for the used
    table type, not counting BLOBs, is 65535. This includes storage overhead,
    check the manual. You have to change some columns to TEXT or BLOBs

    有关列存储的信息,请参阅 第 15.10 节,“InnoDB 行格式”InnoDB NULL

  • InnoDB对于 4KB、8KB、16KB 和 32KB 设置,将行大小(对于本地存储在数据库页面中的数据)限制为略小于数据库页面的一半, innodb_page_size 对于 64KB 页面限制为略小于 16KB。

    创建表的语句t4失败,因为定义的列超过了 16KBInnoDB页的行大小限制。

    mysql> CREATE TABLE t4 (
           c1 CHAR(255),c2 CHAR(255),c3 CHAR(255),
           c4 CHAR(255),c5 CHAR(255),c6 CHAR(255),
           c7 CHAR(255),c8 CHAR(255),c9 CHAR(255),
           c10 CHAR(255),c11 CHAR(255),c12 CHAR(255),
           c13 CHAR(255),c14 CHAR(255),c15 CHAR(255),
           c16 CHAR(255),c17 CHAR(255),c18 CHAR(255),
           c19 CHAR(255),c20 CHAR(255),c21 CHAR(255),
           c22 CHAR(255),c23 CHAR(255),c24 CHAR(255),
           c25 CHAR(255),c26 CHAR(255),c27 CHAR(255),
           c28 CHAR(255),c29 CHAR(255),c30 CHAR(255),
           c31 CHAR(255),c32 CHAR(255),c33 CHAR(255)
           ) ENGINE=InnoDB ROW_FORMAT=DYNAMIC DEFAULT CHARSET latin1;
    ERROR 1118 (42000): Row size too large (> 8126). Changing some columns to TEXT or BLOB may help.
    In current row format, BLOB prefix of 0 bytes is stored inline.