18.6.11.1 NDB Cluster 磁盘数据对象

MySQL 8.0 参考手册 / 第 23 章 MySQL NDB Cluster 8.0 / 23.6 NDB Cluster的管理 / 23.6.10 NDB Cluster 磁盘数据表 / 18.6.11.1 NDB Cluster 磁盘数据对象

18.6.11.1 NDB Cluster 磁盘数据对象

NDB Cluster 磁盘数据存储是使用许多磁盘数据对象实现的。其中包括：

表空间充当其他磁盘数据对象的容器。
撤消日志文件撤消回滚事务所需的信息。
一个或多个撤销日志文件被分配给一个日志文件组，然后被分配给一个表空间。
数据文件存储磁盘数据表数据。数据文件直接分配给表空间。

Undo log文件和数据文件是每个数据节点文件系统中的实际文件；默认情况下，它们放置在 NDB Cluster文件中指定的位置，其中是数据节点的节点 ID。在创建撤消日志或数据文件时，通过将绝对路径或相对路径指定为文件名的一部分，可以将它们放置在别处。创建这些文件的语句将在本节后面显示。 ndb_node_id_fsDataDirconfig.ininode_id

NDB Cluster 表空间和日志文件组未作为文件实现。

重要的

尽管并非所有磁盘数据对象都作为文件实现，但它们都共享相同的命名空间。这意味着 每个磁盘数据对象必须唯一命名（而不仅仅是给定类型的每个磁盘数据对象）。例如，您不能将表空间和日志文件组都命名为dd1.

假设您已经设置了一个包含所有节点（包括管理和 SQL 节点）的 NDB Cluster，在磁盘上创建 NDB Cluster 表的基本步骤如下：

创建一个日志文件组，并为其分配一个或多个撤消日志文件（撤消日志文件有时也称为撤消文件）。

笔记

只有磁盘数据表需要撤消日志文件；它们不用于 NDBCLUSTER仅存储在内存中的表。
创建表空间；将日志文件组以及一个或多个数据文件分配给表空间。
创建一个使用此表空间进行数据存储的磁盘数据表。

这些任务中的每一个都可以使用mysql客户端或其他 MySQL 客户端应用程序中的 SQL 语句来完成，如以下示例所示。

我们创建一个名为lg_1 using的日志文件组CREATE LOGFILE GROUP。这个日志文件组将由两个撤销日志文件组成，我们命名为undo_1.log和 undo_2.log，它们的初始大小分别为 16 MB 和 12 MB。（撤消日志文件的默认初始大小为 128 MB。）您还可以选择为日志文件组的撤消缓冲区指定大小，或允许它采用默认值 8 MB。在此示例中，我们将 UNDO 缓冲区的大小设置为 2 MB。必须使用撤消日志文件创建日志文件组；所以我们 undo_1.log在lg_1 这个CREATE LOGFILE GROUP 声明中添加：
```
CREATE LOGFILE GROUP lg_1
    ADD UNDOFILE 'undo_1.log'
    INITIAL_SIZE 16M
    UNDO_BUFFER_SIZE 2M
    ENGINE NDBCLUSTER;
```
要添加undo_2.log到日志文件组，请使用以下ALTER LOGFILE GROUP语句：
```
ALTER LOGFILE GROUP lg_1
    ADD UNDOFILE 'undo_2.log'
    INITIAL_SIZE 12M
    ENGINE NDBCLUSTER;
```
一些注意事项：
- 此处使用的.log文件扩展名不是必需的。我们使用它只是为了使日志文件易于识别。
- 每个CREATE LOGFILE GROUPandALTER LOGFILE GROUP语句都必须包含一个 ENGINE选项。此选项的唯一允许值是 NDBCLUSTER和 NDB。
  
  重要的
  
  在任何给定时间，同一个 NDB Cluster 中最多可以存在一个日志文件组。
- 当您使用将撤消日志文件添加到日志文件组时，将在集群中每个数据节点的目录中创建一个名称为的文件，其中是数据节点的节点 ID。每个撤消日志文件的大小都在 SQL 语句中指定。例如，如果 NDB Cluster 有 4 个数据节点，那么刚才显示的语句创建 4 个撤消日志文件，每个 1 个在 4 个数据节点的数据目录中；这些文件中的每一个都被命名 ADD UNDOFILE 'filename'filenamendb_node_id_fsDataDirnode_idALTER LOGFILE GROUPundo_2.log每个文件的大小为 12 MB。
- UNDO_BUFFER_SIZE受可用系统内存量的限制。
- 有关该 CREATE LOGFILE GROUP 语句的更多信息，请参阅第 13.1.14 节，“CREATE LOGFILE GROUP 语句”。有关的更多信息ALTER LOGFILE GROUP，请参阅第 13.1.4 节，“ALTER LOGFILE GROUP 语句”。
现在我们可以创建一个表空间，其中包含 NDB Cluster Disk Data 表用于存储其数据的文件。表空间还与特定的日志文件组相关联。创建新表空间时，必须指定用于撤销日志记录的日志文件组；您还必须指定一个数据文件。创建表空间后，可以向表空间中添加更多的数据文件；也可以从表空间中删除数据文件（本节稍后提供删除数据文件的示例）。
假设我们希望创建一个名为 ts_1which的表空间lg_1 用作其日志文件组。该表空间将包含两个名为data_1.dat和的数据文件data_2.dat，其初始大小分别为 32 MB 和 48 MB。（默认值为 INITIAL_SIZE128 MB。）我们可以使用两个 SQL 语句来完成此操作，如下所示：
```
CREATE TABLESPACE ts_1
    ADD DATAFILE 'data_1.dat'
    USE LOGFILE GROUP lg_1
    INITIAL_SIZE 32M
    ENGINE NDBCLUSTER;

ALTER TABLESPACE ts_1
    ADD DATAFILE 'data_2.dat'
    INITIAL_SIZE 48M
    ENGINE NDBCLUSTER;
```
该语句用数据文件CREATE TABLESPACE 创建一个表空间，并与日志文件组相关联。添加第二个数据文件 ( )。 ts_1data_1.datts_1lg_1ALTER TABLESPACEdata_2.dat
一些注意事项：
- 与.log本例中用于撤消日志文件的文件扩展名一样.dat，文件扩展名没有特殊意义；它仅用于轻松识别数据文件。
- 当您使用将数据文件添加到表空间时，将在集群中每个数据节点的目录中创建名称为的文件，其中是数据节点的节点 ID。每个数据文件的大小都在 SQL 语句中指定。例如，如果 NDB Cluster 有 4 个数据节点，那么刚才显示的语句创建 4 个数据文件，每个 4 个数据节点的数据目录中各 1 个；每个文件都有名称，每个文件的大小为 48 MB。 ADD DATAFILE 'filename'filenamendb_node_id_fsDataDirnode_idALTER TABLESPACEdata_2.dat
- 所有CREATE TABLESPACEand ALTER TABLESPACE 语句都必须包含一个ENGINE 子句；只有使用与表空间相同的存储引擎的表才能在表空间中创建。对于 NDB Cluster 表空间，此选项的唯一允许值是NDBCLUSTER和 NDB。
- 有关 CREATE TABLESPACEand ALTER TABLESPACE 语句的更多信息，请参阅第 13.1.18 节，“CREATE TABLESPACE 语句”和第 13.1.8 节，“ALTER TABLESPACE 语句”。
现在可以创建一个表，其非索引列存储在表空间的磁盘上 ts_1：
```
CREATE TABLE dt_1 (
    member_id INT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
    last_name VARCHAR(50) NOT NULL,
    first_name VARCHAR(50) NOT NULL,
    dob DATE NOT NULL,
    joined DATE NOT NULL,
    INDEX(last_name, first_name)
    )
    TABLESPACE ts_1 STORAGE DISK
    ENGINE NDBCLUSTER;
```
该TABLESPACE ... STORAGE DISK选项告诉NDBCLUSTER存储引擎使用表空间ts_1来存储磁盘数据。
如图所示创建表后，您可以像对任何其他 MySQL 表一样对其 ts_1执行 INSERT、 SELECT、 UPDATE和语句。DELETE
还可以通过在or语句中使用STORAGE子句作为列定义的一部分来指定单个列是存储在磁盘上还是内存中。导致列存储在磁盘上，并导致使用内存存储。有关详细信息，请参阅第 13.1.17 节，“CREATE TABLE 语句”。 CREATE TABLEALTER TABLESTORAGE DISKSTORAGE MEMORY

隐式存储在磁盘上的列的索引。 对于dt_1刚刚显示的示例中定义的表，只有dob和 joined列存储在磁盘上。id这是因为、 last_name、和列上有索引first_name，所以属于这些列的数据存储在 RAM 中。只有非索引列可以保存在磁盘上；索引和索引列数据继续存储在内存中。在设计磁盘数据表时，必须牢记索引使用和 RAM 保护之间的权衡。

STORAGE DISK如果不先将其存储类型更改为，则不能向已显式声明的列添加索引MEMORY；任何这样做的尝试都会因错误而失败。隐式使用磁盘存储的列可以被索引；完成后，列的存储类型将更改为MEMORY自动。“ 隐式”是指未声明其存储类型但继承自父表的列。在以下 CREATE TABLE 语句（使用ts_1先前定义的表空间）中，列 c2和c3隐式使用磁盘存储：

mysql> CREATE TABLE ti (
    ->     c1 INT PRIMARY KEY,
    ->     c2 INT,
    ->     c3 INT,
    ->     c4 INT
    -> )
    ->     STORAGE DISK
    ->     TABLESPACE ts_1
    ->     ENGINE NDBCLUSTER;
Query OK, 0 rows affected (1.31 sec)

因为c2、c3和 c4本身没有用声明 STORAGE DISK，所以可以对它们进行索引。在这里，我们分别使用和为c2和添加索引： c3CREATE INDEXALTER TABLE

mysql> CREATE INDEX i1 ON ti(c2);
Query OK, 0 rows affected (2.72 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> ALTER TABLE ti ADD INDEX i2(c3);
Query OK, 0 rows affected (0.92 sec)
Records: 0  Duplicates: 0  Warnings: 0

SHOW CREATE TABLE确认索引已添加。

mysql> SHOW CREATE TABLE ti\G
*************************** 1. row ***************************
       Table: ti
Create Table: CREATE TABLE `ti` (
  `c1` int(11) NOT NULL,
  `c2` int(11) DEFAULT NULL,
  `c3` int(11) DEFAULT NULL,
  `c4` int(11) DEFAULT NULL,
  PRIMARY KEY (`c1`),
  KEY `i1` (`c2`),
  KEY `i2` (`c3`)
) /*!50100 TABLESPACE `ts_1` STORAGE DISK */ ENGINE=ndbcluster DEFAULT CHARSET=latin1
1 row in set (0.00 sec)

您可以使用ndb_desc看到索引列（强调的文本）现在使用内存而不是磁盘存储：

$> ./ndb_desc -d test t1
-- t1 --
Version: 33554433
Fragment type: HashMapPartition
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: no
Number of attributes: 4
Number of primary keys: 1
Length of frm data: 317
Max Rows: 0
Row Checksum: 1
Row GCI: 1
SingleUserMode: 0
ForceVarPart: 1
PartitionCount: 4
FragmentCount: 4
PartitionBalance: FOR_RP_BY_LDM
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
Table options:
HashMap: DEFAULT-HASHMAP-3840-4
-- Attributes --
c1 Int PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY
c2 Int NULL AT=FIXED ST=MEMORY
c3 Int NULL AT=FIXED ST=MEMORY
c4 Int NULL AT=FIXED ST=DISK
-- Indexes --
PRIMARY KEY(c1) - UniqueHashIndex
i2(c3) - OrderedIndex
PRIMARY(c1) - OrderedIndex
i1(c2) - OrderedIndex

NDBT_ProgramExit: 0 - OK

性能说明。 如果磁盘数据文件保存在与数据节点文件系统不同的物理磁盘上，则使用磁盘数据存储的集群的性能会大大提高。必须对集群中的每个数据节点执行此操作才能获得任何明显的好处。

您可以将绝对和相对文件系统路径与 ADD UNDOFILE和一起使用ADD DATAFILE。相对路径是相对于数据节点的数据目录计算的。您也可以使用符号链接；有关更多信息和示例，请参阅第 18.6.11.2 节，“对磁盘数据对象使用符号链接” 。

必须按特定顺序创建日志文件组、表空间和使用它们的任何磁盘数据表。删除任何这些对象也是如此：

只要有任何表空间正在使用日志文件组，就不能删除它。
只要表空间包含任何数据文件，它就不能被删除。
只要还有任何表正在使用表空间，就不能从表空间中删除任何数据文件。
无法删除与创建文件的表空间不同的表空间关联创建的文件。（漏洞 #20053）

例如，要删除到目前为止在本节中创建的所有对象，您可以使用以下语句：

mysql> DROP TABLE dt_1;

mysql> ALTER TABLESPACE ts_1
    -> DROP DATAFILE 'data_2.dat'
    -> ENGINE NDBCLUSTER;

mysql> ALTER TABLESPACE ts_1
    -> DROP DATAFILE 'data_1.dat'
    -> ENGINE NDBCLUSTER;

mysql> DROP TABLESPACE ts_1
    -> ENGINE NDBCLUSTER;

mysql> DROP LOGFILE GROUP lg_1
    -> ENGINE NDBCLUSTER;

这些语句必须按所示顺序执行，但两个ALTER TABLESPACE ... DROP DATAFILE语句可以按任一顺序执行。

FILES您可以通过查询数据库中的表来获取有关磁盘数据表使用的数据文件的INFORMATION_SCHEMA信息。额外的 “NULL行”提供有关撤消日志文件的附加信息。有关更多信息和示例，请参阅第 21.5.1 节，“INFORMATION_SCHEMA FILES 表”。