MySQL 8.0 Reference Manual Including MySQL NDB Cluster 8.0
In MySQL 8.0, partitioning support is not actually
provided by the MySQL Server, but rather by a table storage
engine's own or native partitioning handler. In MySQL
8.0, only the InnoDB
storage engine provides a native partitioning handler. This
means that partitioned tables cannot be created using any other
storage engine.
MySQL Cluster's NDB
storage engine
also provides native partitioning support, but is not
currently supported in MySQL 8.0.
ALTER
TABLE ... OPTIMIZE PARTITION
does not work correctly
with partitioned tables that use InnoDB
. Use
ALTER TABLE ... REBUILD PARTITION
and
ALTER TABLE ... ANALYZE PARTITION
, instead,
for such tables. For more information, see
Section 13.1.9.1, “ALTER TABLE Partition Operations”.
User-defined partitioning and the NDB storage engine (NDB Cluster).
Partitioning by KEY
(including
LINEAR KEY
) is the only type of
partitioning supported for the
NDB
storage engine. It is not
possible under normal circumstances in NDB Cluster to create
an NDB Cluster table using any partitioning type other than
[LINEAR
] KEY
, and
attempting to do so fails with an error.
Exception (not for production): It is
possible to override this restriction by setting the
new
system variable on NDB
Cluster SQL nodes to ON
. If you choose to do
this, you should be aware that tables using partitioning types
other than [LINEAR] KEY
are not supported in
production. In such cases, you can create and use
tables with partitioning types other than KEY
or LINEAR KEY
, but you do this entirely at
your own risk.
The maximum number of partitions that can be defined for an
NDB
table depends on the number of
data nodes and node groups in the cluster, the version of the
NDB Cluster software in use, and other factors. See
NDB and user-defined partitioning,
for more information.
The maximum amount of fixed-size data that can be stored per
partition in an NDB
table is 128 TB.
Previously, this was 16 GB.
CREATE TABLE
and
ALTER
TABLE
statements that would cause a user-partitioned
NDB
table not to meet either or
both of the following two requirements are not permitted, and
fail with an error:
The table must have an explicit primary key.
All columns listed in the table's partitioning expression must be part of the primary key.
Exception.
If a user-partitioned NDB
table
is created using an empty column-list (that is, using
PARTITION BY KEY()
or PARTITION BY
LINEAR KEY()
), then no explicit primary key is
required.
Upgrading partitioned tables.
When performing an upgrade, tables which are partitioned by
KEY
must be dumped and reloaded.
Partitioned tables using storage engines other than
InnoDB
cannot be upgraded from MySQL 5.7 or
earlier to MySQL 8.0 or later; you must either drop the
partitioning from such tables with ALTER TABLE ...
REMOVE PARTITIONING
or convert them to
InnoDB
using ALTER TABLE ...
ENGINE=INNODB
prior to the upgrade.
For information about converting MyISAM
tables to InnoDB
, see
Section 15.6.1.5, “Converting Tables from MyISAM to InnoDB”.