MySQL8 中文参考(九十一)
25.5.11 ndb_drop_table — 删除 NDB 表
原文:
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-drop-table.html
ndb_drop_table 删除指定的 NDB 表。(如果尝试在使用其他存储引擎创建的表上使用此操作,会出现错误 723:表不存在。)此操作非常快速;在某些情况下,比在 NDB 表上使用 MySQL 的 DROP TABLE 语句快一个数量级。
用法
ndb_drop_table -c *connection_string* *tbl_name* -d *db_name*
可用于 ndb_drop_table 的选项显示在下表中。表后面会有额外的描述。
表 25.33 与程序 ndb_drop_table 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用或移除 |
|---|---|---|
--character-sets-dir=path | 包含字符集的目录 | 移除:8.0.31 |
--connect-retries=# | 在放弃之前重试连接的次数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-retry-delay=# | 尝试联系管理服务器之间等待的秒数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-string=connection_string,-c connection_string | 与 --ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--core-file | 在错误时写入核心文件;用于调试 | 移除:8.0.31 |
--database=name,-d name | 表所在数据库的名称 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-extra-file=path | 在全局文件读取后读取给定文件 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-file=path | 仅从给定文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-group-suffix=string | 还读取 concat(group, suffix) 的组 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--help,-? | 显示帮助文本并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--login-path=path | 从登录文件中读取给定路径 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-connectstring=connection_string,-c connection_string | 设置连接到 ndb_mgmd 的连接字符串。语法:“[nodeid=id;][host=]hostname[:port]”。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-mgmd-host=connection_string,-c connection_string | 与 --ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-nodeid=# | 设置此节点的节点 ID,覆盖 --ndb-connectstring 设置的任何 ID | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-optimized-node-selection | 启用用于事务节点选择的优化。默认情况下启用;使用 --skip-ndb-optimized-node-selection 来禁用 | 移除:8.0.31 |
--no-defaults | 不从登录文件以外的任何选项文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--print-defaults | 打印程序参数列表并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--usage,-? | 显示帮助文本并退出;与 --help 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--version,-V | 显示版本信息并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
| 格式 | 描述 | 添加、弃用或移除 |
-
--character-sets-dir命令行格式 --character-sets-dir=path移除 8.0.31 包含字符集的目录。
-
--connect-retries命令行格式 --connect-retries=#类型 整数 默认值 12最小值 0最大值 12在放弃之前重试连接的次数。
-
--connect-retry-delay命令行格式 --connect-retry-delay=#类型 整数 默认值 5最小值 0最大值 5尝试联系管理服务器之间等待的秒数。
-
--connect-string命令行格式 --connect-string=connection_string类型 字符串 默认值 [无]与
--ndb-connectstring相同。 -
--core-file命令行格式 --core-file移除 8.0.31 在错误时写入核心文件;用于调试。
-
--database,-d命令行格式 --database=name类型 字符串 默认值 TEST_DB表所在的数据库的名称。
-
--defaults-extra-file命令行格式 --defaults-extra-file=path类型 字符串 默认值 [无]在读取全局文件后读取给定文件。
-
--defaults-file命令行格式 --defaults-file=path类型 字符串 默认值 [无]仅从给定文件中读取默认选项。
-
--defaults-group-suffix命令行格式 --defaults-group-suffix=string类型 字符串 默认值 [无]还读取具有 concat(group, suffix) 的组。
-
--help命令行格式 --help显示帮助文本并退出。
-
--login-path命令行格式 --login-path=path类型 字符串 默认值 [��]从登录文件中读取给定路径。
-
--ndb-connectstring命令行格式 --ndb-connectstring=connection_string类型 字符串 默认值 [无]设置用于连接到 ndb_mgmd 的连接字符串。语法:"[nodeid=id;][host=]hostname[:port]"。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目。
-
--ndb-mgmd-host命令行格式 --ndb-mgmd-host=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--ndb-nodeid命令行格式 --ndb-nodeid=#类型 整数 默认值 [none]设置此节点的节点 ID,覆盖由
--ndb-connectstring设置的任何 ID。 -
--ndb-optimized-node-selection命令行格式 --ndb-optimized-node-selection已移除 8.0.31 启用优化以选择事务节点。默认启用;使用
--skip-ndb-optimized-node-selection来禁用。 -
--no-defaults命令行格式 --no-defaults不要从登录文件以外的任何选项文件中读取默认选项。
-
--print-defaults命令行格式 --print-defaults打印程序参数列表并退出。
-
--usage命令行格式 --usage显示帮助文本并退出;与
--help相同。 -
--version命令行格式 --version显示版本信息并退出。
25.5.12 ndb_error_reporter — NDB Error-Reporting Utility
原文:
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-error-reporter.html
ndb_error_reporter 从数据节点和管理节点日志文件创建一个归档,可用于帮助诊断集群中的错误或其他问题。强烈建议在提交 NDB Cluster 错误报告时使用此实用程序。
可用于ndb_error_reporter的选项如下表所示。表后面是附加描述。
表 25.34 与程序 ndb_error_reporter 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用或移除 |
|---|---|---|
--connection-timeout=# | 连接到节点时等待的秒数,超时前 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--dry-scp | 禁用与远程主机的 scp;仅用于测试 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--fs | 在错误报告中包含文件系统数据;可能使用大量磁盘空间 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--help,-? | 显示帮助文本并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--skip-nodegroup=# | 跳过具有此 ID 的节点组中的所有节点 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
用法
ndb_error_reporter *path/to/config-file* [*username*] [*options*]
此实用程序旨在在管理节点主机上使用,并需要管理主机配置文件的路径(通常命名为config.ini)。可选地,您可以提供能够使用 SSH 访问集群数据节点的用户的名称,以复制数据节点日志文件。ndb_error_reporter 然后将所有这些文件包含在创建的归档中,该归档位于运行它的相同目录中。归档的名称为ndb_error_report_*YYYYMMDDhhmmss*.tar.bz2,其中*YYYYMMDDhhmmss*是日期时间字符串。
ndb_error_reporter 还接受以下列出的选项:
-
--connection-timeout=*timeout*命令行格式 --connection-timeout=#类型 整数 默认值 0在尝试连接节点时等待这么多秒,然后超时。
-
--dry-scp命令行格式 --dry-scp运行ndb_error_reporter,不使用 scp 从远程主机。仅用于测试。
-
--help命令行格式 --help显示帮助文本并退出。
-
--fs命令行格式 --fs将数据节点文件系统复制到管理主机并包含在归档中。
因为数据节点文件系统可能非常庞大,即使经过压缩,我们要求您请不要将使用此选项创建的归档发送给 Oracle,除非有明确要求。
-
--skip-nodegroup=*nodegroup_id*命令行格式 --connection-timeout=#类型 整数 默认值 0跳过所有属于具有提供的节点组 ID 的节点组的节点。
25.5.13 ndb_import — 将 CSV 数据导入到 NDB 中
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-import.html
ndb_import是通过 NDB API 直接将 CSV 格式的数据导入到NDB中的工具,例如由mysqldump --tab生成的数据。ndb_import需要连接到 NDB 管理服务器(ndb_mgmd)才能正常工作;它不需要连接到 MySQL 服务器。
用法
ndb_import *db_name* *file_name* *options*
ndb_import需要两个参数。*db_name是要导入数据的表所在的数据库的名称;file_name*是要读取数据的 CSV 文件的名称;如果文件不在当前目录中,则必须包含该文件的路径。文件的名称必须与表的名称匹配;文件的扩展名(如果有)不会被考虑。ndb_import支持的选项包括用于指定字段分隔符、转义符和行终止符的选项,在本节的后续部分中进行了描述。
在 NDB 8.0.30 之前,ndb_import会拒绝从 CSV 文件中读取的任何空行。从 NDB 8.0.30 开始,当导入单列时,可以用作列值的空值,ndb_import 会像LOAD DATA语句一样处理。
ndb_import必须能够连接到 NDB 集群管理服务器;因此,在集群config.ini文件中必须有一个未使用的[api]插槽。
要复制使用不同存储引擎(如InnoDB)的现有表作为NDB表,可以使用mysql客户端执行SELECT INTO OUTFILE语句将现有表导出为 CSV 文件,然后执行CREATE TABLE LIKE语句创建具有与现有表相同结构的新表,然后在新表上执行ALTER TABLE ... ENGINE=NDB;之后,从系统 shell 中调用ndb_import将数据加载到新的NDB表中。例如,假设您已经以具有适当权限的 MySQL 用户登录,可以将名为myinnodb_table的现有InnoDB表从名为myinnodb的数据库导出到名为myndb_table的NDB表中,如下所示:
-
在mysql客户端中:
mysql> USE myinnodb; mysql> SELECT * INTO OUTFILE '/tmp/myndb_table.csv' > FIELDS TERMINATED BY ',' OPTIONALLY ENCLOSED BY '"' ESCAPED BY '\\' > LINES TERMINATED BY '\n' > FROM myinnodbtable; mysql> CREATE DATABASE myndb; mysql> USE myndb; mysql> CREATE TABLE myndb_table LIKE myinnodb.myinnodb_table; mysql> ALTER TABLE myndb_table ENGINE=NDB; mysql> EXIT; Bye $>一旦目标数据库和表已创建,运行中的mysqld不再需要。如果愿意,可以在继续之前使用mysqladmin shutdown或其他方法停止它。
-
在系统 shell 中:
# if you are not already in the MySQL bin directory: $> cd *path-to-mysql-bin-dir* $> ndb_import myndb /tmp/myndb_table.csv --fields-optionally-enclosed-by='"' \ --fields-terminated-by="," --fields-escaped-by='\\'输出应类似于此处所示:
job-1 import myndb.myndb_table from /tmp/myndb_table.csv job-1 [running] import myndb.myndb_table from /tmp/myndb_table.csv job-1 [success] import myndb.myndb_table from /tmp/myndb_table.csv job-1 imported 19984 rows in 0h0m9s at 2277 rows/s jobs summary: defined: 1 run: 1 with success: 1 with failure: 0 $>
所有可与ndb_import一起使用的选项均显示在以下表中。表后面是附加描述。
表 25.35 与程序 ndb_import 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用或移除 |
|---|---|---|
--abort-on-error | 在任何致命错误时转储核心;用于调试 | (在基于 MySQL 8.0 的所有 NDB 版本中���持) |
--ai-increment=# | 对于具有隐藏 PK 的表,指定自增增量。参见 mysqld | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ai-offset=# | 对于具有隐藏 PK 的表,指定自增偏移量。参见 mysqld | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ai-prefetch-sz=# | 对于具有隐藏 PK 的表,指定预取的自增值数量。参见 mysqld | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--character-sets-dir=path | 包含字符集的目录 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-retries=# | 放弃之前尝试连接的次数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-retry-delay=# | 尝试联系管理服务器之间等待的秒数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-string=connection_string,-c connection_string | 与 --ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connections=# | 要创建的集群连接数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--continue | 作业失败时,继续下一个作业 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--core-file | 在错误时编写核心文件;用于调试 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--csvopt=opts | 设置典型 CSV 选项值的简写选项。请参阅语法和其他信息的文档 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--db-workers=# | 每个数据节点执行数据库操作的线程数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-extra-file=path | 在读取全局文件后读取给定文件 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-file=path | 仅从给定文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-group-suffix=string | 也读取连接组与连接后缀的连接 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--errins-type=name | 错误插入类型,用于测试目的;使用 "list" 获取所有可能的值 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--errins-delay=# | 错误插入延迟(毫秒);添加随机变化 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--fields-enclosed-by=char | 与 LOAD DATA 语句的 FIELDS ENCLOSED BY 选项相同。对于 CSV 输入,这与使用--fields-optionally-enclosed-by 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--fields-escaped-by=char | 与 LOAD DATA 语句的 FIELDS ESCAPED BY 选项相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--fields-optionally-enclosed-by=char | 与 LOAD DATA 语句的 FIELDS OPTIONALLY ENCLOSED BY 选项相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--fields-terminated-by=char | 与 LOAD DATA 语句的 FIELDS TERMINATED BY 选项相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--help,-? | 显示帮助文本并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--idlesleep=# | 等待更多工作的毫秒数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--idlespin=# | 在 idlesleep 之前重试的次数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ignore-lines=# | 忽略输入文件中的前#行。用于跳过非数据标题 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--input-type=name | 输入类型:random 或 csv | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--input-workers=# | 处理输入的线程数。如果--input-type 是 csv,则必须是 2 或更多 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--keep-state | 通常在作业完成时删除状态文件(除非是非空的*.rej 文件)。使用此选项会导致保留所有状态文件 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--lines-terminated-by=char | 与 LOAD DATA 语句的 LINES TERMINATED BY 选项相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--login-path=path | 从登录文件中读取给定路径 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--max-rows=# | 仅导入此数量的输入数据行;默认为 0,即导入所有行 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--missing-ai-column='name' | 表示要导入的 CSV 文件中缺少自增值。 | 新增:NDB 8.0.30 |
--monitor=# | 如果有变化(状态、拒绝行、临时错误),定期打印正在运行作业的状态。值 0 禁用。值 1 打印任何看到的变化。较高的值按指数方式减少状态打印,直到达到某个预定义限制 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-connectstring=connection_string,-c connection_string | 设置用于连接到 ndb_mgmd 的连接字符串。���法:“[nodeid=id;][host=]hostname[:port]”。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-mgmd-host=connection_string,-c connection_string | 与--ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-nodeid=# | 为此节点设置节点 ID,覆盖--ndb-connectstring 设置的任何 ID | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-optimized-node-selection | 启用用于事务节点选择的优化。默认启用;使用--skip-ndb-optimized-node-selection 来禁用 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--no-asynch | 将数据库操作作为批处理,在单个事务中运行 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--no-defaults | 不从登录文件以外的任何选项文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--no-hint | 告诉事务协调器在选择数据节点时不要使用分发键提示 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--opbatch=# | 数据库执行批处理是一组事务和操作发送到 NDB 内核。此选项限制了数据库执行批处理中的 NDB 操作(包括 blob 操作)。因此,它还限制了异步事务的数量。值 0 无效 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--opbytes=# | 限制执行批处理中的字节数(默认值 0 = 无限制) | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--output-type=name | 输出类型:ndb 为默认值,null 用于测试 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--output-workers=# | 处理输出或中继数据库操作的线程数 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--pagesize=# | 将 I/O 缓冲区对齐到给定大小 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--pagecnt=# | I/O 缓冲区大小,以页面大小的倍数计算。CSV 输入工作程序分配双倍大小的缓冲区 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--polltimeout=# | 每个轮询的超时时间用于已完成的异步事务;轮询将继续进行,直到所有轮询完成或发生错误 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--print-defaults | 打印程序参数列表并退出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--rejects=# | 限制数据加载中被拒绝的行数(具有永久错误的行)。默认值为 0,表示任何被拒绝的行都会导致致命错误。超过限制的行也会添加到*.rej 文件中 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--resume | 如果作业中止(临时错误,用户中断),则恢复尚未处理的行 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--rowbatch=# | 限制行队列中的行数(默认值 0 = 无限制);如果--input-type 为 random,则必须为 1 或更多 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--rowbytes=# | 限制行队列中的字节数(0 = 无限制) | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--state-dir=path | 写入状态文件的位置;默认为当前目录 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--stats | 将性能相关选项和内部统计信息保存在 *.sto 和 *.stt 文件中。即使未使用 --keep-state,这些文件在成功完成后也会保留 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--table=name,-t name | 导入数据的目标名称;默认为输入文件的基本名称 | 新增:NDB 8.0.28 |
--tempdelay=# | 在临时错误之间休眠的毫秒数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--temperrors=# | 每个执行批次中事务由于临时错误而失败的次数;0 表示任何临时错误都是致命的。这些错误不会导致任何行被写入 .rej 文件 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--usage,-? | 显示帮助文本并退出;与 --help 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
[--verbose[=#]](mysql-cluster-programs-ndb-import.html#option_ndb_import_verbose),[-v [#]](mysql-cluster-programs-ndb-import.html#option_ndb_import_verbose) | 启用详细输出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--version,-V | 显示版本信息并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
| 格式 | 描述 | 添加、弃用或移除 |
-
--abort-on-error命令行格式 --abort-on-error在任何致命错误时转储核心;仅用于调试目的。
-
--ai-increment=#命令行格式 --ai-increment=#类型 整数 默认值 1最小值 1最大值 4294967295对于具有隐藏主键的表,指定自增增量,就像 MySQL Server 中的
auto_increment_increment系统变量一样。 -
--ai-offset=#命令行格式 --ai-offset=#类型 整数 默认值 1最小值 1最大值 4294967295对于具有隐藏主键的表,指定自增偏移量。类似于
auto_increment_offset系统变量。 -
--ai-prefetch-sz=#命令行格式 --ai-prefetch-sz=#类型 整数 默认值 1024最小值 1最大值 4294967295对于具有隐藏主键的表,指定预取的自增值数量。类似于 MySQL 服务器中的
ndb_autoincrement_prefetch_sz系统变量的行为。 -
--character-sets-dir命令行格式 --character-sets-dir=path包含字符集的目录。
-
--connections=#命令行格式 --connections=#类型 整数 默认值 1最小值 1最大值 4294967295创建的集群连接数。
-
--connect-retries命令行格式 --connect-retries=#类型 整数 默认值 12最小值 0最大值 12在放弃之前重试连接的次数。
-
--connect-retry-delay命令行格式 --connect-retry-delay=#类型 整数 默认值 5最小值 0最大值 5尝试联系管理服务器之间等待的秒数。
-
--connect-string命令行格式 --connect-string=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--continue命令行格式 --continue当作业失败时,继续下一个作业。
-
--core-file命令行格式 --core-file在错误时写入核心文件;用于调试。
-
--csvopt=string命令行格式 --csvopt=opts类型 字符串 默认值 [none]提供了一种设置典型 CSV 导入选项的快捷方法。此选项的参数是一个由以下一个或多个参数组成的字符串:
-
c: 字段以逗号终止 -
d: 使用默认值,除非被另一个参数覆盖 -
n: 行以\n终止 -
q: 字段可选地由双引号字符(")包围 -
r: 行以\r终止
在 NDB 8.0.28 及更高版本中,处理此选项参数中使用的参数顺序,使得最右边的参数始终优先于已在同一参数值中使用的可能冲突的参数。这也适用于给定参数的任何重复实例。在 NDB 8.0.28 之前,参数的顺序没有任何区别,除了当同时指定
n和r时,最后出现的(最右边的)参数实际上生效。此选项旨在用于在难以传输转义符或引号的条件下进行测试。
-
-
--db-workers=#命令行格式 --db-workers=#类型 整数 默认值 4最小值 1最大值 4294967295每个数据节点执行数据库操作的线程数。
-
--defaults-file命令行格式 --defaults-file=path类型 字符串 默认值 [none]仅从给定文件中读取默认选项。
-
--defaults-extra-file命令行格式 --defaults-extra-file=path类型 字符串 默认值 [none]在读取全局文件后读取给定文件。
-
--defaults-group-suffix命令行格式 --defaults-group-suffix=string类型 字符串 默认值 [none]还读取连接(group,suffix)的组。
-
--errins-type=name命令行格式 --errins-type=name类型 枚举 默认值 [none]有效值 stopjob``stopall``sighup``sigint``list错误插入类型;使用
list作为name值以获取所有可能的值。此选项仅用于测试目的。 -
--errins-delay=#命令行格式 --errins-delay=#类型 整数 默认值 1000最小值 0最大值 4294967295单位 毫秒 错误插入延迟(毫秒);添加随机变化。此选项仅用于测试目的。
-
--fields-enclosed-by=char命令行格式 --fields-enclosed-by=char类型 字符串 默认值 [none]这与
LOAD DATA语句中的FIELDS ENCLOSED BY选项的工作方式相同,指定一个字符作为引用字段值的解释。对于 CSV 输入,这与--fields-optionally-enclosed-by相同。 -
--fields-escaped-by=name命令行格式 --fields-escaped-by=char类型 字符串 默认值 \指定一个转义字符,与 SQL
LOAD DATA语句中的FIELDS ESCAPED BY选项的工作方式相同。 -
--fields-optionally-enclosed-by=char命令行格式 --fields-optionally-enclosed-by=char类型 字符串 默认值 [none]这与
LOAD DATA语句中的FIELDS OPTIONALLY ENCLOSED BY选项的工作方式相同,指定一个字符作为可选引用字段值的解释。对于 CSV 输入,这与--fields-enclosed-by相同。 -
--fields-terminated-by=char命令行格式 --fields-terminated-by=char类型 字符串 默认值 \t这与
LOAD DATA语句中的FIELDS TERMINATED BY选项的工作方式相同,指定一个字符作为字段分隔符的解释。 -
--help命令行格式 --help显示帮助文本并退出。
-
--idlesleep=#命令行格式 --idlesleep=#类型 整数 默认值 1最小值 1最大值 4294967295单位 毫秒 等待更多工作执行的毫秒数。
-
--idlespin=#命令行格式 --idlespin=#类型 整数 默认值 0最小值 0最大值 4294967295重试之前睡眠的次数。
-
--ignore-lines=#命令行格式 --ignore-lines=#类型 整数 默认值 0最小值 0最大值 4294967295使 ndb_import 忽略输入文件的前*
#*行。这可用于跳过不包含任何数据的文件头。 -
--input-type=name命令行格式 --input-type=name类型 枚举 默认值 csv有效值 random``csv设置输入类型的类型。默认为
csv;random仅用于测试目的。 -
--input-workers=#命令行格式 --input-workers=#类型 整数 默认值 4最小值 1最大值 4294967295设置处理输入的线程数。
-
--keep-state命令行格式 --keep-state默认情况下,ndb_import 在完成作业时会删除所有状态文件(除非是非空的
*.rej文件)。指定此选项(不需要参数)可以强制程序保留所有状态文件。 -
--lines-terminated-by=name命令行格式 --lines-terminated-by=char类型 字符串 默认值 \n这与
LOAD DATA语句的LINES TERMINATED BY选项的工作方式相同,指定要解释为行尾的字符。 -
--log-level=#命令行格式 --log-level=#类型 整数 默认值 0最小值 0最大值 2在给定级别执行内部日志记录。此选项主要用于内部和开发目的。
在 NDB 的调试版本中,可以使用此选项将日志级别设置为最大值 4。
-
--login-path命令行格式 --login-path=path类型 字符串 默认值 [none]从登录文件中读取给定路径。
-
--max-rows=#命令行格式 --max-rows=#类型 整数 默认值 0最小值 0最大值 4294967295单位 字节 仅导入此数量的输入数据行;默认值为 0,表示导入所有行。
-
--missing-ai-column命令行格式 --missing-ai-column='name'引入版本 8.0.30-ndb-8.0.30 类型 布尔值 默认值 FALSE当导入单个表或多个表时,可以使用此选项。使用时,表示要导入的 CSV 文件不包含任何
AUTO_INCREMENT列的值,并且 ndb_import 应该提供这些值;如果使用了该选项且AUTO_INCREMENT列包含任何值,则无法继续导入操作。 -
--monitor=#命令行格式 --monitor=#类型 整数 默认值 2最小值 0最大值 4294967295单位 字节 定期打印正在运行的作业的状态,如果有变化(状态、拒绝行、临时错误)。设置为 0 以禁用此报告。设置为 1 会打印任何看到的变化。较高的值会减少此状态报告的频率。
-
--ndb-connectstring命令行格式 --ndb-connectstring=connection_string类型 字符串 默认值 [none]设置连接到 ndb_mgmd 的连接字符串。语法:"[nodeid=id;][host=]hostname[:port]"。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目。
-
--ndb-mgmd-host命令行格式 --ndb-mgmd-host=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--ndb-nodeid命令行格式 --ndb-nodeid=#类型 整数 默认值 [none]为此节点设置节点 ID,覆盖由
--ndb-connectstring设置的任何 ID。 -
--ndb-optimized-node-selection命令行格式 --ndb-optimized-node-selection启用优化以选择事务节点。默认情况下启用;使用
--skip-ndb-optimized-node-selection来禁用。 -
--no-asynch命令行格式 --no-asynch将数据库操作作为批处理,在单个事务中运行。
-
--no-defaults命令行格式 --no-defaults不要从除登录文件以外的任何选项文件中读取默认选项。
-
--no-hint命令行格式 --no-hint不要使用分布键提示来选择数据节点。
-
--opbatch=#命令行格式 --opbatch=#类型 整数 默认值 256最小值 1最大值 4294967295单位 字节 设置每个执行批次的操作数限制(包括 blob 操作),从而限制异步事务��数量。
-
--opbytes=#命令行格式 --opbytes=#类型 整数 默认值 0最小值 0最大值 4294967295单位 字节 设置每次执行批处理的字节数限制。使用 0 表示无限制。
-
--output-type=name命令行格式 --output-type=name类型 枚举 默认值 ndb有效值 null设置输出类型。
ndb是默认值。null仅用于测试。 -
--output-workers=#命令行格式 --output-workers=#类型 整数 默认值 2最小值 1最大值 4294967295设置处理输出或中继数据库操作的线程数。
-
--pagesize=#命令行格式 --pagesize=#类型 整数 默认值 4096最小值 1最大值 4294967295单位 字节 对齐 I/O 缓冲区到指定大小。
-
--pagecnt=#命令行格式 --pagecnt=#类型 整数 默认值 64最小值 1最大值 4294967295设置 I/O 缓冲区的大小,以页大小的倍数计算。CSV 输入工作程序分配的缓冲区大小加倍。
-
--polltimeout=#命令行格式 --polltimeout=#类型 整数 默认值 1000最小值 1最大值 4294967295单位 毫秒 设置每次轮询已完成的异步事务的超时时间;轮询将继续直到所有轮询完成,或发生错误。
-
--print-defaults命令行格式 --print-defaults打印程序参数列表并退出。
-
--rejects=#命令行格式 --rejects=#类型 整数 默认值 0最小值 0最大值 4294967295限制数据加载中被拒绝的行数(具有永久错误的行)。默认值为 0,这意味着任何被拒绝的行都会导致致命错误。导致超出限制的行��添加到
.rej文件中。此选项设置的限制在当前运行期间有效。使用
--resume重新启动的运行被视为此目的上的“新”运行。 -
--resume命令行格式 --resume如果作业中止(由于临时数据库错误或用户中断),则恢复尚未处理的任何行。
-
--rowbatch=#命令行格式 --rowbatch=#类型 整数 默认值 0最小值 0最大值 4294967295单位 行 设置每个行队列的行数限制。使用 0 表示无限制。
-
--rowbytes=#命令行格式 --rowbytes=#类型 整数 默认值 262144最小值 0最大值 4294967295单位 字节 设置每个行队列的字节限制。使用 0 表示无限制。
-
--stats命令行格式 --stats保存与性能和其他内部统计信息相关的选项信息在名为
*.sto和*.stt的文件中。这些文件始终在成功完成时保留(即使未指定--keep-state)。 -
--state-dir=name命令行格式 --state-dir=path类型 字符串 默认值 .写入程序运行产生的状态文件(
*tbl_name*.map、*tbl_name*.rej、*tbl_name*.res和*tbl_name*.stt)的位置;默认为当前目录。 -
--table=*name*命令行格式 --table=name引入版本 8.0.28-ndb-8.0.28 类型 字符串 默认值 [输入文件基本名称]默认情况下,ndb_import 尝试将数据导入到与正在读取数据的 CSV 文件的基本名称相同的表中。从 NDB 8.0.28 开始,您可以通过使用
--table选项(简写-t)来覆盖表名的选择。 -
--tempdelay=#命令行格式 --tempdelay=#类型 整数 默认值 10最小值 0最大值 4294967295单位 毫秒 临时错误之间休眠的毫秒数。
-
--temperrors=#命令行格式 --temperrors=#类型 整数 默认值 0最小值 0最大值 4294967295每个执行批次中由于临时错误而导致事务失败的次数。默认值为 0,这意味着任何临时错误都是致命的。临时错误不会导致任何行被添加到
.rej文件中。 -
--verbose,-v命令行格式 --verbose[=#]类型 布尔值 默认值 false启用详细输出。
-
--usage命令行格式 --usage显示帮助文本并退出;与
--help相同。 -
--version命令行格式 --version显示版本信息并退出。
与LOAD DATA一样,用于字段和行格式化的选项必须与用于创建 CSV 文件的选项相匹配,无论是使用SELECT INTO ... OUTFILE还是其他方式完成的。没有相当于LOAD DATA语句的STARTING WITH选项。
25.5.14 ndb_index_stat — NDB 索引统计实用程序
原文:
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-index-stat.html
ndb_index_stat提供了关于NDB表上索引的每个片段的统计信息。这包括缓存版本和年龄,每个分区的索引条目数,以及索引的内存消耗。
用法
要获取关于给定NDB表的基本索引统计信息,请按照这里显示的方式调用ndb_index_stat,将表名作为第一个参数,并紧接着指定包含此表的数据库的名称,使用--database(-d)选项:
ndb_index_stat *table* -d *database*
在这个例子中,我们使用ndb_index_stat来获取关于test数据库中名为mytable的NDB表的信息:
$> ndb_index_stat -d test mytable
table:City index:PRIMARY fragCount:2
sampleVersion:3 loadTime:1399585986 sampleCount:1994 keyBytes:7976
query cache: valid:1 sampleCount:1994 totalBytes:27916
times in ms: save: 7.133 sort: 1.974 sort per sample: 0.000
sampleVersion是取得统计数据的缓存的版本号。使用--update选项运行ndb_index_stat会导致 sampleVersion 递增。
loadTime显示了缓存上次更新的时间。这是自 Unix 纪元以来的秒数。
sampleCount是每个分区找到的索引条目数。您可以通过将此乘以片段数(显示为fragCount)来估算总条目数。
sampleCount可以与SHOW INDEX或INFORMATION_SCHEMA.STATISTICS的基数进行比较,尽管后两者提供了整个表的视图,而ndb_index_stat提供了每个片段的平均值。
keyBytes是索引使用的字节数。在这个例子中,主键是一个整数,每个索引需要四个字节,所以在这种情况下可以按照这里显示的方式计算keyBytes:
keyBytes = sampleCount * (4 bytes per index) = 1994 * 4 = 7976
这些信息也可以使用INFORMATION_SCHEMA.COLUMNS中的相应列定义来获取(这需要一个 MySQL 服务器和一个 MySQL 客户端应用程序)。
totalBytes是表上所有索引消耗的总内存,以字节为单位。
前面示例中显示的时间是每次调用ndb_index_stat的特定时间。
--verbose选项提供一些额外的输出,如下所示:
$> ndb_index_stat -d test mytable --verbose
random seed 1337010518
connected
loop 1 of 1
table:mytable index:PRIMARY fragCount:4
sampleVersion:2 loadTime:1336751773 sampleCount:0 keyBytes:0
read stats
query cache created
query cache: valid:1 sampleCount:0 totalBytes:0
times in ms: save: 20.766 sort: 0.001
disconnected
$>
如果程序的输出为空,这可能表示尚无统计数据。要强制创建它们(或更新如果它们已经存在),请使用--update选项调用ndb_index_stat,或在mysql客户端中对表执行ANALYZE TABLE。
选项
以下表格包括特定于 NDB Cluster ndb_index_stat 实用程序的选项。表后列出了附加描述。
表 25.36 与程序 ndb_index_stat 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用���移除 |
|---|---|---|
--character-sets-dir=path | 包含字符集的目录 | 移除:8.0.31 |
--connect-retries=# | 放弃之前重试连接的次数 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
--connect-retry-delay=# | 尝试联系管理服务器之间等待的秒数 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
--connect-string=connection_string,-c connection_string | 与--ndb-connectstring 相同 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
--core-file | 在错误时写入核心文件;用于调试 | 移除:8.0.31 |
--database=name,-d name | 包含表的数据库名称 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
--defaults-extra-file=path | 在全局文件读取后读取给定文件 | (支持所有基于 MySQL 8.0 的 NDB 版本) |
--defaults-file=path | 仅从给定文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-group-suffix=string | 也读取 concat(group, suffix) 组 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--delete | 删除表的索引统计信息,停止之前配置的任何自动更新 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--dump | 打印查询缓存 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--help,-? | 显示帮助文本并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--login-path=path | 从登录文件中读取给定路径 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--loops=# | 设置执行给定命令的次数;默认为 0 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-connectstring=connection_string,-c connection_string | 设置连接到 ndb_mgmd 的��接字符串。语法:"[nodeid=id;][host=]hostname[:port]"。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-mgmd-host=connection_string,-c connection_string | 与 --ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-nodeid=# | 为此节点设置节点 ID,覆盖 --ndb-connectstring 设置的任何 ID | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-optimized-node-selection | 启用对事务节点选择的优化。默认启用;使用 --skip-ndb-optimized-node-selection 来禁用 | 移除:8.0.31 |
--no-defaults | 不从登录文件以外的任何选项文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--print-defaults | 打印程序参数列表并退出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--query=# | 在第一个键属性上执行随机范围查询(必须为无符号整数) | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-drop | 删除 NDB 内核中的所有统计表和事件(所有统计数据都将丢失) | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-create | 在 NDB 内核中创建所有统计表和事件,如果它们尚不存在 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-create-if-not-exist | 在 NDB 内核中创建任何尚不存在的统计表和事件 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-create-if-not-valid | 在 NDB 内核中创建任何尚不存在的统计表或事件,之前会删除任何无效的表或事件 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-check | 验证 NDB 系统索引统计和事件表是否存在 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-skip-tables | 不对表应用 sys-* 选项 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--sys-skip-events | 不对事件应用 sys-* 选项 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--update | 更新表的索引统计信息,重新启动之前配置的任何自动更新 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--usage,-? | 显示帮助文本并退出;与 --help 相同 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--verbose,-v | 打开详细输出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--version,-V | 显示版本信息并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
| 格式 | 描述 | 添加、弃用或移除 |
-
--character-sets-dir命令行格式 --character-sets-dir=path移除 8.0.31 包含字符集的目录。
-
--connect-retries命令行格式 --connect-retries=#类型 整数 默认值 12最小值 0最大值 12在放弃之前重试连接的次数。
-
--connect-retry-delay命令行格式 --connect-retry-delay=#类型 整数 默认值 5最小值 0最大值 5尝试联系管理服务器之间等待的秒数。
-
--connect-string命令行格式 --connect-string=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--core-file命令行格式 --core-file移除 8.0.31 在错误时写入核心文件;用于调试。
-
--database=*name*,-d *name*命令行格式 --database=name类型 字符串 默认值 [none]最小值 最大值 包含被查询表的数据库的名称。
-
--defaults-extra-file命令行格式 --defaults-extra-file=path类型 字符串 默认值 [none]在读取全局文件后读取给定文件。
-
--defaults-file命令行格式 --defaults-file=path类型 字符串 默认值 [none]仅从给定文件中读取默认选项。
-
--defaults-group-suffix命令行格式 --defaults-group-suffix=string类型 字符串 默认值 [none]还读取连接组与连接后缀的连接。
-
--delete命令行格式 --delete删除给定表的索引统计信息,停止先前配置的任何自动更新。
-
--dump命令行格式 --dump转储查询缓存的内容。
-
--help命令行格式 --help显示帮助文本并退出。
-
--login-path命令行格式 --login-path=path类型 字符串 默认值 [none]从登录文件中读取给定路径。
-
--loops=*#*命令行格式 --loops=#类型 数字 默认值 0最小值 0最大值 MAX_INT重复命令此次数(用于测试)。
-
--ndb-connectstring命令行格式 --ndb-connectstring=connection_string类型 字符串 默认值 [none]设置用于连接到 ndb_mgmd 的连接字符串。语法:"[nodeid=id;][host=]hostname[:port]"。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目。
-
--ndb-mgmd-host命令行格式 --ndb-mgmd-host=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--ndb-nodeid命令行格式 --ndb-nodeid=#类型 整数 默认值 [none]设置此节点的节点 ID,覆盖由
--ndb-connectstring设置的任何 ID。 -
--ndb-optimized-node-selection命令行格式 --ndb-optimized-node-selection已移除 8.0.31 启用优化以选择事务节点。默认启用;使用
--skip-ndb-optimized-node-selection来禁用。 -
--no-defaults命令��格式 --no-defaults不要从除登录文件以外的任何选项文件中读取默认选项。
-
--print-defaults命令行格式 --print-defaults打印程序参数列表并退出。
-
--query=*#*命令行格式 --query=#类型 数字 默认值 0最小值 0最大值 MAX_INT对第一个键属性执行随机范围查询(必须为 int unsigned)。
-
--sys-drop命令行格式 --sys-drop删除 NDB 内核中的所有统计表和事件。这将导致所有统计数据丢失。
-
--sys-create命令行格式 --sys-create在 NDB 内核中创建所有统计表和事件。仅当它们之前不存在时才有效。
-
--sys-create-if-not-exist命令行格式 --sys-create-if-not-exist在调用程序时创建任何尚不存在的 NDB 系统统计表或事件(或两者)。
-
--sys-create-if-not-valid命令行格式 --sys-create-if-not-valid在删除任何无效的统计表后,创建任何尚不存在的 NDB 系统统计表或事件。
-
--sys-check命令行格式 --sys-check验证 NDB 内核中是否存在所有必需的系统统计表和事件。
-
--sys-skip-tables命令行格式 --sys-skip-tables不要将任何
--sys-*选项应用于任何统计表。 -
--sys-skip-events命令行格式 --sys-skip-events不要将任何
--sys-*选项应用于任何事件。 -
--update命令行格式 --update更新给定表的索引统计信息,并重新启动先前配置的任何自动更新。
-
--usage命令行格式 --usage显示帮助文本并退出;与
--help相同。 -
--verbose命令行格式 --verbose打开详细输出。
-
--version命令行格式 --version显示版本信息并退出。
ndb_index_stat 系统选项。 以下选项用于在 NDB 内核中生成和更新统计表。这些选项中的任何一个都不能与统计选项混合使用(参见 ndb_index_stat 统计选项)。
-
--sys-drop -
--sys-create -
--sys-create-if-not-exist -
--sys-create-if-not-valid -
--sys-check -
--sys-skip-tables -
--sys-skip-events
ndb_index_stat 统计选项。 这里列出的选项用于生成索引统计信息。它们与给定的表和数据库一起工作。它们不能与系统选项混合使用(参见 ndb_index_stat 系统选项)。
-
--database -
--delete -
--update -
--dump -
--query
25.5.15 ndb_move_data — NDB 数据复制实用程序
原文:
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-move-data.html
ndb_move_data将数据从一个 NDB 表复制到另一个。
用法
通过指定源表和目标表的名称来调用该程序;这两个表中的任何一个或两者都可以选择性地带有数据库名称。这两个表都必须使用 NDB 存储引擎。
ndb_move_data *options* *source* *target*
可与ndb_move_data一起使用的选项显示在下表中。表后面会有附加描述。
表 25.37 与程序 ndb_move_data 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用或移除 |
|---|---|---|
--abort-on-error | 在永久错误时转储核心(调试选项) | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--character-sets-dir=path | 字符集所在目录 | 移除:8.0.31 |
--connect-retries=# | 在放弃之前重试连接的次数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-retry-delay=# | 尝试联系管理服务器之间等待的秒数 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--connect-string=connection_string,-c connection_string | 与 --ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--core-file | 在错误时写入核心文件;用于调试 | 移除:8.0.31 |
--database=name,-d name | 表所在数据库的名称 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-extra-file=path | 在全局文件读取后读取给定文件 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-file=path | 仅从给定文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-group-suffix=string | 还读取具有 concat(group, suffix) 的组 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--drop-source | 在移动所有行后删除源表 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--error-insert | 插入随机临时错误(用于测试) | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--exclude-missing-columns | 忽略源表或目标表中的额外列 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--help,-? | 显示帮助文本并退出 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--login-path=path | 从登录文件中读取给定路径 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--lossy-conversions,-l | 允许属性数据在转换为较小类型时被截断 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-connectstring=connection_string,-c connection_string | 设置用于连接到 ndb_mgmd 的连接字符串。语法:"[nodeid=id;][host=]hostname[:port]"。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-mgmd-host=connection_string,-c connection_string | 与 --ndb-connectstring 相同 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-nodeid=# | 为此节点设置节点 ID,覆盖由 --ndb-connectstring 设置的任何 ID | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--ndb-optimized-node-selection | 启用用于事务节点选择的优化。默认启用;使用 --skip-ndb-optimized-node-selection 来禁用 | 已移除:8.0.31 |
--no-defaults | 不从登录文件以外的任何选项文件中读取默认选项 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--print-defaults | 打印程序参数列表并退出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--promote-attributes,-A | 允许将属性数据转换为更大类型 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
[--staging-tries=x[,y[,z]]](mysql-cluster-programs-ndb-move-data.html#option_ndb_move_data_staging-tries) | 指定临时错误的尝试次数;格式为 x[,y[,z]],其中 x=最大尝试次数(0=无限制),y=最小延迟(毫秒),z=最大延迟(毫秒) | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--usage,-? | 显示帮助文本并退出;与 --help 相同 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--verbose | 启用详细消息 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--version,-V | 显示版本信息并退出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
| 格式 | 描述 | 添加、弃用或移除 |
-
--abort-on-error命令行格式 --abort-on-error在永久错误时转储核心(调试选项)。
-
--character-sets-dir=name命令行格式 --character-sets-dir=path移除 8.0.31 类型 字符串 默认值 [none]存放字符集的目录。
-
--connect-retry-delay命令行格式 --connect-retry-delay=#类型 整数 默认值 5最小值 0最大值 5尝试联系管理服务器之间等待的秒数。
-
--connect-retries命令行格式 --connect-retries=#类型 整数 默认值 12最小值 0最大值 12连接失败前重试的次数。
-
--connect-string命令行格式 --connect-string=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--core-file命令行格式 --core-file已移除 8.0.31 在错误时写入核心文件;用于调试。
-
--database=dbname,-d命令行格式 --database=name类型 字符串 默认值 TEST_DB表所在的数据库名称。
-
--defaults-extra-file命令行格式 --defaults-extra-file=path类型 字符串 默认值 [none]在全局文件读取后读取给定文件。
-
--defaults-file命令行格式 --defaults-file=path类型 字符串 默认值 [none]仅从给定文件中读取默认选项。
-
--defaults-group-suffix命令行格式 --defaults-group-suffix=string类型 字符串 默认值 [none]还读取具有 concat(group, suffix)的组。
-
--drop-source命令行格式 --drop-source在移动所有行后删除源表。
-
--error-insert命令行格式 --error-insert插入随机临时错误(测试选项)。
-
--exclude-missing-columns命令行格式 --exclude-missing-columns忽略源表或目标表中的额外列。
-
--help命令行格式 --help显示帮助文本并退出。
-
--login-path命令行格式 --login-path=path类型 字符串 默认值 [none]从登录文件中读取给定路径。
-
--lossy-conversions,-l命令行格式 --lossy-conversions允许属性数据在转换为较小类型时被截断。
-
--ndb-connectstring命令行格式 --ndb-connectstring=connection_string类型 字符串 默认值 [none]设置用于连接到 ndb_mgmd 的连接字符串。语法:“[nodeid=id;][host=]hostname[:port]”。覆盖 NDB_CONNECTSTRING 和 my.cnf 中的条目。
-
--ndb-mgmd-host命令行格式 --ndb-mgmd-host=connection_string类型 字符串 默认值 [none]与
--ndb-connectstring相同。 -
--ndb-nodeid命令行格式 --ndb-nodeid=#类型 整数 默认值 [none]为此节点设置节点 ID,覆盖由
--ndb-connectstring设置的任何 ID。 -
--ndb-optimized-node-selection命令行格式 --ndb-optimized-node-selection已移除 8.0.31 启用优化以选择事务节点。默认启用;使用
--skip-ndb-optimized-node-selection来禁用。 -
--no-defaults命令行格式 --no-defaults不要从除登录文件以外的任何选项文件中读取默认选项。
-
--print-defaults命令行格式 --print-defaults打印程序参数列表并退出。
-
--promote-attributes,-A命令行格式 --promote-attributes允许将属性数据转换为更大的类型。
-
--staging-tries=x[,y[,z]]命令行格式 --staging-tries=x[,y[,z]]类型 字符串 默认值 0,1000,60000指定在临时错误上的尝试次数。格式为 x[,y[,z]],其中 x=最大尝试次数(0=无限制),y=最小延迟(毫秒),z=最大延迟(毫秒)。
-
--usage命令行格式 --usage显示帮助文本并退出;与
--help相同。 -
--verbose命令行格式 --verbose启用详细消息。
-
--version命令行格式 --version显示版本信息并退出。
25.5.16 ndb_perror — Obtain NDB Error Message Information
原文:
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-perror.html
ndb_perror显示有关 NDB 错误的信息,给定其错误代码。这包括错误消息、错误类型以及错误是永久的还是临时的。这旨在作为perror --ndb的替代品,后者不再受支持。
用法
ndb_perror [*options*] *error_code*
ndb_perror不需要访问运行中的 NDB 集群或任何节点(包括 SQL 节点)。要查看有关给定 NDB 错误的信息,请调用该程序,并将错误代码作为参数,如下所示:
$> ndb_perror 323
NDB error code 323: Invalid nodegroup id, nodegroup already existing: Permanent error: Application error
为了仅显示错误消息,请使用带有--silent选项(简写为-s)调用ndb_perror,如下所示:
$> ndb_perror -s 323
Invalid nodegroup id, nodegroup already existing: Permanent error: Application error
与perror类似,ndb_perror接受多个错误代码:
$> ndb_perror 321 1001
NDB error code 321: Invalid nodegroup id: Permanent error: Application error
NDB error code 1001: Illegal connect string
ndb_perror的其他程序选项将在本节后面描述。
ndb_perror替换了不再受 NDB Cluster 支持的perror --ndb。为了在脚本和其他可能依赖于perror获取 NDB 错误信息的应用程序中更容易进行替换,ndb_perror支持自己的“虚拟”--ndb选项,不执行任何操作。
以下表格包括所有特定于 NDB Cluster 程序ndb_perror的选项。表格后面是附加描述。
表 25.38 与程序 ndb_perror 一起使用的命令行选项
| 格式 | 描述 | 添加、弃用或移除 |
|---|---|---|
--defaults-extra-file=path | 在读取全局文件后读取给定文件 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--defaults-file=path | 仅从给定文件中读取默认选项 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--defaults-group-suffix=string | 也读取带有连接(group, suffix)的组 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--help,-? | 显示帮助文本 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--login-path=path | 从登录文件中读取给定路径 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--ndb | 为依赖于旧版本 perror 的应用程序兼容性而存在;无任何作用 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--no-defaults | 除登录文件外不从任何选项文件中读取默认选项 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--print-defaults | 打印程序参数列表并退出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--silent,-s | 仅显示错误消息 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--version,-V | 打印程序版本信息并退出 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
--verbose,-v | 冗长输出;使用 --silent 禁用 | (适用于基于 MySQL 8.0 的所有 NDB 版本) |
| 格式 | 描述 | 添加、弃用或移除 |
附加选项
-
--defaults-extra-file命令行格式 --defaults-extra-file=path类型 字符串 默认值 [none]在读取全局文件后读取给定文件。
-
--defaults-file命令行格式 --defaults-file=path类型 字符串 默认值 [none]仅从给定文件中读取默认选项。
-
--defaults-group-suffix命令行格式 --defaults-group-suffix=string类型 字符串 默认值 [none]还读取连接(group, suffix)的组。
-
--help,-?命令行格式 --help显示程序帮助文本并退出。
-
--login-path命令行格式 --login-path=path类型 字符串 默认值 [none]从登录文件中读取给定路径。
-
--ndb命令行格式 --ndb为了与依赖于旧版本perror的应用程序兼容,该程序使用了该程序的
--ndb选项。当与ndb_perror一起使用时,该选项不起作用,并被忽略。 -
--no-defaults命令行格式 --no-defaults不从登录文件以外的任何选项文件中读取默认选项。
-
--print-defaults命令行格式 --print-defaults打印程序参数列表并退出。
-
--silent,-s命令行格式 --silent仅显示错误消息。
-
--version,-V命令行格式 --version打印程序版本信息并退出。
-
--verbose,-v命令行格式 --verbose冗长输出;使用
--silent禁用。
25.5.17 ndb_print_backup_file — 打印 NDB 备份文件内容
原文:
dev.mysql.com/doc/refman/8.0/en/mysql-cluster-programs-ndb-print-backup-file.html
ndb_print_backup_file 从集群备份文件中获取诊断信息。
表 25.39 与程序 ndb_print_backup_file 一起使用的命令行选项
| 格式 | 描述 | 新增、弃用或移除 |
|---|---|---|
--backup-key=key,-K password | 使用此密码解密文件 | 新增: NDB 8.0.31 |
--backup-key-from-stdin | 从 STDIN 安全获取解密密钥 | 新增: NDB 8.0.31 |
--backup-password=password,-P password | 使用此密码解密文件 | 新增: NDB 8.0.22 |
--backup-password-from-stdin | 从 STDIN 安全获取解密密码 | 新增: NDB 8.0.24 |
--control-directory-number=#,-c # | 控制目录编号 | 新增: NDB 8.0.24 |
--defaults-extra-file=path | 在全局文件读取后读取给定文件 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-file=path | 仅从给定文件中读取默认选项 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--defaults-group-suffix=string | 也读取 concat(group, suffix) 组 | (在基于 MySQL 8.0 的所有 NDB 版本中支持) |
--fragment-id=#,-f # | 片段 ID | 新增: NDB 8.0.24 |
--help,--usage,-h,-? | 打印使用信息 | 新增:NDB 8.0.24 |
--login-path=path | 从登录文件中读取给定路径 | (所有基于 MySQL 8.0 的 NDB 版本都支持) |
--no-defaults | 不从登录文件以外的任何选项文件中读取默认选项 | (所有基于 MySQL 8.0 的 NDB 版本都支持) |
--no-print-rows,-u | 不打印行 | 新增:NDB 8.0.24 |
--print-defaults | 打印程序参数列表并退出 | (所有基于 MySQL 8.0 的 NDB 版本都支持) |
--print-header-words,-h | 打印标题词 | 新增:NDB 8.0.24 |
--print-restored-rows | 打印恢复的行 | 新增:NDB 8.0.24 |
--print-rows,-U | 打印行。默认启用;使用 --no-print-rows 禁用 | 新增:NDB 8.0.24 |
--print-rows-per-page | 每页打印行数 | 新增:NDB 8.0.24 |
--rowid-file=path,-n path | 包含要检查的行 ID 的文件 | 新增:NDB 8.0.24 |
--show-ignored-rows,-i | 显示被忽略的行 | 新增:NDB 8.0.24 |
--table-id=#,-t # | 表 ID;与--print-restored rows 一起使用 | 添加:NDB 8.0.24 |
--usage,-? | 显示帮助文本并退出;与--help 相同 | (基于 MySQL 8.0 的所有 NDB 版本都支持) |
[--verbose[=#]](mysql-cluster-programs-ndb-print-backup-file.html#option_ndb_print_backup_file_verbose),-v | 详细级别 | 添加:NDB 8.0.24 |
--version,-V | 显示版本信息并退出 | (基于 MySQL 8.0 的所有 NDB 版本都支持) |
| 格式 | 描述 | 添加、弃用或移除 |
用法
ndb_print_backup_file [-P *password*] *file_name*
file_name 是集群备份文件的名称。这可以是集群备份目录中找到的任何文件(.Data、.ctl或.log文件)。这些文件位于数据节点的备份目录中的子目录BACKUP-*#*下,其中*#*是备份的序列号。有关集群备份文件及其内容的更多信息,请参见第 25.6.8.1 节,“NDB 集群备份概念”。
与ndb_print_schema_file和ndb_print_sys_file(以及大多数旨在在管理服务器主机上运行或连接到管理服务器的其他NDB实用程序不同)ndb_print_backup_file必须在集群数据节点上运行,因为它直接访问数据节点文件系统。由于它不使用管理服务器,因此即使管理服务器未运行,甚至当集群完全关闭时,也可以使用此实用程序。
在 NDB 8.0 中,此程序还可用于读取撤销日志文件。
选项
在 NDB 8.0.24 之前,ndb_print_backup_file仅支持-P选项。从 NDB 8.0.24���始,该程序支持许多选项,这些选项在以下列表中描述。
-
--backup-key,-K命令行格式 --backup-key=key引入版本 8.0.31-ndb-8.0.31 指定解密加密备份所需的密钥。
-
--backup-key-from-stdin命令行格式 --backup-key-from-stdin引入版本 8.0.31-ndb-8.0.31 允许从标准输入输入解密密钥,类似于在调用mysql时不提供密码后输入密码。
-
--backup-password命令行格式 --backup-password=password引入版本 8.0.22-ndb-8.0.22 类型 字符串 默认值 [无]指定解密加密备份所需的密码。
从 NDB 8.0.24 开始提供此选项的长格式。
-
--backup-password-from-stdin命令行格式 --backup-password-from-stdin引入版本 8.0.24-ndb-8.0.24 允许从标准输入输入密码,类似于在调用mysql时不提供密码后输入密码。
-
--control-directory-number命令行格式 --control-directory-number=#引入版本 8.0.24-ndb-8.0.24 类型 整数 默认值 0控制文件目录编号。与
--print-restored-rows一起使用。 -
--defaults-extra-file命令行格式 --defaults-extra-file=path类型 字符串 默认值 [无]在读取全局文件后读取给定文件。
-
--defaults-file命令行格式 --defaults-file=path类型 字符串 默认值 [无]仅从给定文件读取默认选项。
-
--defaults-group-suffix命令行格式 --defaults-group-suffix=string类型 字符串 默认值 [无]还读取带有 concat(group, suffix)的组。
-
--fragment-id命令行格式 --fragment-id=#引入版本 8.0.24-ndb-8.0.24 类型 整数 默认值 0片段 ID。与
--print-restored-rows一起使用。 -
--help命令行格式 --help``--usage引入版本 8.0.24-ndb-8.0.24 打印程序使用信息。
-
--login-path命令行格式 --login-path=path类型 字符串 默认值 [无]从登录文件中读取给定路径。
-
--no-defaults命令行格式 --no-defaults不要从除登录文件之外的任何选项文件中读取默认选项。
-
--no-print-rows命令行格式 --no-print-rows引入版本 8.0.24-ndb-8.0.24 不在输出中包含行。
-
--print-defaults命令行格式 --print-defaults打印程序参数列表并退出。
-
--print-header-words命令行格式 --print-header-words引入版本 8.0.24-ndb-8.0.24 在输出中包含标题词。
-
--print-restored-rows命令行格式 --print-restored-rows引入版本 8.0.24-ndb-8.0.24 在输出中包含恢复的行,使用文件
LCP/*c*/T*t*F*f*.ctl,其值设置如下:-
c是使用--control-directory-number设置的控制文件编号。 -
t是使用--table-id设置的表 ID。 -
f是使用--fragment-id设置的片段 ID。
-
-
--print-rows命令行格式 --print-rows引入版本 8.0.24-ndb-8.0.24 打印行。此选项默认启用;要禁用它,请使用
--no-print-rows。 -
--print-rows-per-page命令行格式 --print-rows-per-page引入版本 8.0.24-ndb-8.0.24 打印每页行数。
-
--rowid-file命令行格式 --rowid-file=path引入版本 8.0.24-ndb-8.0.24 类型 文件名 默认值 [none]用于检查行 ID 的文件。
-
--show-ignored-rows命令行格式 --show-ignored-rows引入版本 8.0.24-ndb-8.0.24 显示被忽略的行。
-
--table-id命令行格式 --table-id=#引入版本 8.0.24-ndb-8.0.24 类型 整数 默认值 [none]表 ID。与
--print-restored-rows一起使用。 -
--usage命令行格式 --usage显示帮助文本并退出;与
--help相同。 -
--verbose命令行格式 --verbose[=#]引入版本 8.0.24-ndb-8.0.24 类型 整数 默认值 0输出的详细程度。较大的值表示增加的详细程度。
-
--version命令行格式 --version显示版本信息并退出。