可以在表的表注释或列注释中设置许多特定于 NDB Cluster 的选项 NDB。用于控制从任何副本和分区平衡读取的表级选项可以使用 嵌入到表注释中NDB_TABLE。

NDB_COLUMN可以在列注释中使用，以将用于存储部分 blob 值的 blob 部分表列的大小设置NDB为其最大值。这适用于BLOB、 MEDIUMBLOB、LONGBLOB、 TEXT、 MEDIUMTEXT、LONGTEXT和 JSON列。

NDB_TABLE可以在表注释中用于设置与分区平衡相关的选项以及表是否完全复制等。

本节的其余部分描述了这些选项及其使用。

NDB_COLUMN 选项

在 NDB Cluster 中，CREATE TABLEorALTER TABLE 语句中的列注释也可用于指定 NDB_COLUMN选项。NDB 7.5 和 7.6 支持单列注释选项 MAX_BLOB_PART_SIZE；此选项的语法显示如下：

COMMENT 'NDB_COLUMN=MAX_BLOB_PART_SIZE[={0|1}]'

符号及其后面的=值是可选的。使用 0 或 1 以外的任何值都会导致语法错误。

在列注释中使用的效果是将or 列MAX_BLOB_PART_SIZE的 blob 部分大小设置 为(13948)支持的最大字节数。此选项可应用于 MySQL 支持的任何 blob 列类型，但or ( , , , , , ) 除外。 对 列没有影响。 TEXTBLOBNDBTINYBLOBTINYTEXTBLOBMEDIUMBLOBLONGBLOBTEXTMEDIUMTEXTLONGTEXTMAX_BLOB_PART_SIZEJSON

您还应该记住，尤其是在使用 TEXT列时，设置的值 MAX_BLOB_PART_SIZE表示以字节为单位的列大小。它不表示字符数，根据列使用的字符集和排序规则而有所不同。

要查看此选项的效果，我们首先在mysql客户端中运行以下 SQL 语句来创建一个包含两BLOB列的表，一列 ( c1) 没有额外选项，另一列 ( c2) 包含 MAX_BLOB_PART_SIZE：

mysql> CREATE TABLE test.t (
    ->   p INT PRIMARY KEY, 
    ->   c1 BLOB, 
    ->   c2 BLOB COMMENT 'NDB_COLUMN=MAX_BLOB_PART_SIZE'
    -> ) ENGINE NDB;
Query OK, 0 rows affected (0.32 sec)

在系统 shell 中，运行ndb_desc 实用程序以获取有关刚创建的表的信息，如本例所示：

$> ndb_desc -d test t
-- t --
Version: 1
Fragment type: HashMapPartition
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: no
Number of attributes: 3
Number of primary keys: 1
Length of frm data: 324
Row Checksum: 1
Row GCI: 1
SingleUserMode: 0
ForceVarPart: 1
FragmentCount: 2
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
HashMap: DEFAULT-HASHMAP-3840-2
-- Attributes --
p Int PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY
c1 Blob(256,2000,0) NULL AT=MEDIUM_VAR ST=MEMORY BV=2 BT=NDB$BLOB_22_1
c2 Blob(256,13948,0) NULL AT=MEDIUM_VAR ST=MEMORY BV=2 BT=NDB$BLOB_22_2
-- Indexes -- 
PRIMARY KEY(p) - UniqueHashIndex
PRIMARY(p) - OrderedIndex

输出中的列信息列在 Attributes; 对于列c1 ，c2它在此处以强调文本显示。对于c1，blob 部分大小为 2000，默认值；对于c2，它是 13948，由 设置 MAX_BLOB_PART_SIZE。

NDB您可以使用如下语句更改表 的给定 blob 列的 blob 部分大小， ALTER TABLE然后使用以下语句验证更改SHOW CREATE TABLE：

mysql> ALTER TABLE test.t 
    ->    DROP COLUMN c1, 
    ->     ADD COLUMN c1 BLOB COMMENT 'NDB_COLUMN=MAX_BLOB_PART_SIZE',
    ->     CHANGE COLUMN c2 c2 BLOB AFTER c1;
Query OK, 0 rows affected (0.47 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> SHOW CREATE TABLE test.t\G
*************************** 1. row ***************************
       Table: t
Create Table: CREATE TABLE `t` (
  `p` int(11) NOT NULL,
  `c1` blob COMMENT 'NDB_COLUMN=MAX_BLOB_PART_SIZE',
  `c2` blob,
  PRIMARY KEY (`p`)
) ENGINE=ndbcluster DEFAULT CHARSET=latin1
1 row in set (0.00 sec)

mysql> EXIT
Bye

ndb_desc 的输出显示列的 blob 部分大小已按预期更改：

$> ndb_desc -d test t
-- t --
Version: 16777220
Fragment type: HashMapPartition
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: no
Number of attributes: 3
Number of primary keys: 1
Length of frm data: 324
Row Checksum: 1
Row GCI: 1
SingleUserMode: 0
ForceVarPart: 1
FragmentCount: 2
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
HashMap: DEFAULT-HASHMAP-3840-2
-- Attributes --
p Int PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY
c1 Blob(256,13948,0) NULL AT=MEDIUM_VAR ST=MEMORY BV=2 BT=NDB$BLOB_26_1
c2 Blob(256,2000,0) NULL AT=MEDIUM_VAR ST=MEMORY BV=2 BT=NDB$BLOB_26_2
-- Indexes -- 
PRIMARY KEY(p) - UniqueHashIndex
PRIMARY(p) - OrderedIndex

NDBT_ProgramExit: 0 - OK

必须使用复制来更改列的 blob 部分大小ALTER TABLE；此操作不能在线执行（请参阅 第 21.6.12 节，“在 NDB Cluster 中使用 ALTER TABLE 进行在线操作”）。

有关如何NDB 存储 blob 类型的列的更多信息，请参阅 字符串类型存储要求。

NDB_TABLE 选项

在 MySQL NDB Cluster 7.5 及更高版本中， CREATE TABLEorALTER TABLE语句中的表注释也可用于指定一个 NDB_TABLE选项，该选项由一个或多个名称-值对组成，如果需要，用逗号分隔，跟在字符串 之后NDB_TABLE=。名称和值语法的完整语法如下所示：

COMMENT="NDB_TABLE=ndb_table_option[,ndb_table_option[,...]]"

ndb_table_option: {
    NOLOGGING={1 | 0}
  | READ_BACKUP={1 | 0}
  | PARTITION_BALANCE={FOR_RP_BY_NODE | FOR_RA_BY_NODE | FOR_RP_BY_LDM
                      | FOR_RA_BY_LDM | FOR_RA_BY_LDM_X_2
                      | FOR_RA_BY_LDM_X_3 | FOR_RA_BY_LDM_X_4}
  | FULLY_REPLICATED={1 | 0}
}

带引号的字符串中不允许有空格。该字符串不区分大小写。

可以通过这种方式设置为注释一部分的四个NDB表选项将在接下来的几段中进行更详细的描述。

NOLOGGING：使用1对应 ndb_table_no_logging开启，没有实际作用。作为占位符提供，主要是为了ALTER TABLE 语句的完整性。

READ_BACKUPndb_read_backup：将此选项设置为 1 与启用时效果相同 ；允许从任何副本读取。这样做以相对较小的写入性能成本极大地提高了从表中读取的性能。

从 MySQL NDB Cluster 7.5.3 开始，您可以 READ_BACKUP在线设置现有表（Bug #80858，Bug #23001617），使用ALTER TABLE 类似于此处显示的语句之一：

ALTER TABLE ... ALGORITHM=INPLACE, COMMENT="NDB_TABLE=READ_BACKUP=1";

ALTER TABLE ... ALGORITHM=INPLACE, COMMENT="NDB_TABLE=READ_BACKUP=0";

在 MySQL NDB Cluster 7.5.4 之前，设置 READ_BACKUP为 1 也会导致 FRAGMENT_COUNT_TYPE设置为 ONE_PER_LDM_PER_NODE_GROUP.

有关ALGORITHM 选项的更多信息ALTER TABLE，请参阅 第 21.6.12 节，“在 NDB Cluster 中使用 ALTER TABLE 进行在线操作”。

PARTITION_BALANCE：提供对分区分配和放置的额外控制。支持以下四种方案：

从 NDB 7.5.4 开始，PARTITION_BALANCE 是设置每个表的分区数的首选界面。从 NDB 7.5.4 开始不推荐使用MAX_ROWS强制分区数，在 NDB 7.6 中继续支持以实现向后兼容性，但在 MySQL NDB Cluster 的未来版本中将被删除。（缺陷 #81759，缺陷 #23544301）

在 MySQL NDB Cluster 7.5.4 之前， PARTITION_BALANCE被命名为 FRAGMENT_COUNT_TYPE，并被接受为其值之一（与刚刚显示的清单的顺序相同） ONE_PER_NODE，，，， 或 。（缺陷 #81761，缺陷 #23547525） ONE_PER_NODE_GROUPONE_PER_LDM_PER_NODEONE_PER_LDM_PER_NODE_GROUP

FULLY_REPLICATED控制表是否完全复制，即每个数据节点是否有表的完整副本。要启用表的完全复制，请使用FULLY_REPLICATED=1.

也可以使用 ndb_fully_replicated系统变量控制此设置。将其设置为ON默认为所有新NDB表启用该选项；默认值为 OFF，它保持以前的行为（在 MySQL NDB Cluster 7.5.1 和更早版本中，在引入对完全复制表的支持之前）。系统 ndb_data_node_neighbour变量也用于完全复制的表，以确保当访问完全复制的表时，我们访问的是该 MySQL 服务器本地的数据节点。

CREATE TABLE此处显示了在创建表时使用此类注释 的语句示例NDB：

mysql> CREATE TABLE t1 (
     >     c1 INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
     >     c2 VARCHAR(100),
     >     c3 VARCHAR(100) )
     > ENGINE=NDB
     >
COMMENT="NDB_TABLE=READ_BACKUP=0,PARTITION_BALANCE=FOR_RP_BY_NODE";

注释显示为 的输出的一部分 SHOW CREATE TABLE。评论的文本也可以从查询 MySQL 信息模式TABLES表中获得，如本例所示：

mysql> SELECT TABLE_NAME, TABLE_SCHEMA, TABLE_COMMENT
     > FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME="t1"\G
*************************** 1. row ***************************
   TABLE_NAME: t1
 TABLE_SCHEMA: test
TABLE_COMMENT: NDB_TABLE=READ_BACKUP=0,PARTITION_BALANCE=FOR_RP_BY_NODE
1 row in set (0.01 sec)

ALTER TABLE表格语句 也支持此注释语法 NDB，如下所示：

mysql> ALTER TABLE t1 COMMENT="NDB_TABLE=PARTITION_BALANCE=FOR_RA_BY_NODE";
Query OK, 0 rows affected (0.40 sec)
Records: 0  Duplicates: 0  Warnings: 0

从 NDB 7.6.15 开始，该TABLE_COMMENT 列显示重新创建表所需的注释，因为它位于ALTER TABLE 语句之后，如下所示：

mysql> SELECT TABLE_NAME, TABLE_SCHEMA, TABLE_COMMENT
    ->     FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME="t1"\G
*************************** 1. row ***************************
   TABLE_NAME: t1
 TABLE_SCHEMA: test
TABLE_COMMENT: NDB_TABLE=READ_BACKUP=0,PARTITION_BALANCE=FOR_RP_BY_NODE
1 row in set (0.01 sec)

mysql> SELECT TABLE_NAME, TABLE_SCHEMA, TABLE_COMMENT
     > FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME="t1";
+------------+--------------+--------------------------------------------------+
| TABLE_NAME | TABLE_SCHEMA | TABLE_COMMENT                                    |
+------------+--------------+--------------------------------------------------+
| t1         | c            | NDB_TABLE=PARTITION_BALANCE=FOR_RA_BY_NODE       |
| t1         | d            |                                                  |
+------------+--------------+--------------------------------------------------+
2 rows in set (0.01 sec)

请记住，与一起使用的表格注释ALTER TABLE会替换表格可能具有的任何现有注释。

mysql> ALTER TABLE t1 COMMENT="NDB_TABLE=PARTITION_BALANCE=FOR_RA_BY_NODE";
Query OK, 0 rows affected (0.40 sec)
Records: 0  Duplicates: 0  Warnings: 0

mysql> SELECT TABLE_NAME, TABLE_SCHEMA, TABLE_COMMENT
     > FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_NAME="t1";
+------------+--------------+--------------------------------------------------+
| TABLE_NAME | TABLE_SCHEMA | TABLE_COMMENT                                    |
+------------+--------------+--------------------------------------------------+
| t1         | c            | NDB_TABLE=PARTITION_BALANCE=FOR_RA_BY_NODE       |
| t1         | d            |                                                  |
+------------+--------------+--------------------------------------------------+
2 rows in set (0.01 sec)

在 NDB 7.6.15 之前，使用 with 的表注释ALTER TABLE替换了表可能具有的任何现有注释。这意味着（例如）该 READ_BACKUP值不会转移到ALTER TABLE语句设置的新注释中，并且任何未指定的值都将恢复为默认值。(BUG#30428829) 因此不再有任何方法可以使用 SQL 来检索之前为评论设置的值。为了防止评论值恢复为默认值，有必要保留现有评论字符串中的任何此类值，并将它们包含在传递给 的评论中ALTER TABLE。

您还可以在ndb_descPARTITION_BALANCE的输出中 看到该选项的值 。ndb_desc还显示是否为表设置了和 选项。有关详细信息，请参阅此程序的说明。 READ_BACKUPFULLY_REPLICATED