此工具可用于检查和删除 NDB 表中孤立的 BLOB 列部分,以及生成列出任何孤立部分的文件。它有时可用于诊断和修复包含 BLOB 或 TEXT 列的损坏或损坏的 NDB 表。
ndb_blob_tool 的基本语法如下所示
ndb_blob_tool [options] table [column, ...]除非您使用 --help 选项,否则必须通过包含一个或多个选项 --check-orphans、--delete-orphans 或 --dump-file 来指定要执行的操作。这些选项使 ndb_blob_tool 分别检查孤立的 BLOB 部分、删除任何孤立的 BLOB 部分以及生成列出孤立的 BLOB 部分的转储文件,并在本节后面详细介绍。
调用 ndb_blob_tool 时,您还必须指定表的名称。此外,您还可以选择在表名后跟一个或多个来自该表的 BLOB 或 TEXT 列的名称(以逗号分隔)。如果未列出任何列,则该工具将处理该表的所有 BLOB 和 TEXT 列。如果需要指定数据库,请使用 --database (-d) 选项。
--verbose 选项在输出中提供有关工具进度的附加信息。
下表显示了可与 ndb_mgmd 一起使用的所有选项。表格后有其他说明。
-
命令行格式 --add-missing对于 NDB 集群表中没有相应 BLOB 部分的每个内联部分,写入一个所需长度的虚拟 BLOB 部分,该部分由空格组成。
-
命令行格式 --character-sets-dir=路径包含字符集的目录。
-
命令行格式 --check-missing检查 NDB 集群表中没有相应 BLOB 部分的内联部分。
-
命令行格式 --check-orphans检查 NDB 集群表中没有相应内联部分的 BLOB 部分。
-
命令行格式 --connect-retries=#类型 整数 默认值 12最小值 0最大值 12放弃之前重试连接的次数。
-
命令行格式 --connect-retry-delay=#类型 整数 默认值 5最小值 0最大值 5尝试联系管理服务器之间的等待秒数。
-
命令行格式 --connect-string=连接字符串类型 字符串 默认值 [无]与
--ndb-connectstring相同。 -
命令行格式 --core-file出错时写入核心文件;用于调试。
--database=,数据库名-d命令行格式 --database=名称类型 字符串 默认值 [无]指定要在其中查找表的数据库。
-
命令行格式 --defaults-extra-file=路径类型 字符串 默认值 [无]读取全局文件后读取给定文件。
-
命令行格式 --defaults-file=路径类型 字符串 默认值 [无]仅从给定文件读取默认选项。
-
命令行格式 --defaults-group-suffix=字符串类型 字符串 默认值 [无]还读取带有 concat(组,后缀)的组。
-
命令行格式 --delete-orphans从 NDB 集群表中删除没有相应内联部分的 BLOB 部分。
-
命令行格式 --dump-file=文件类型 文件名 默认值 [无]将孤立的 BLOB 列部分列表写入
文件。写入文件的信息包括每个孤立的 BLOB 部分的表键和 BLOB 部分号。 -
命令行格式 --help显示帮助文本并退出。
-
命令行格式 --login-path=路径类型 字符串 默认值 [无]从登录文件读取给定路径。
-
命令行格式 --no-login-paths跳过从登录路径文件读取选项。
-
命令行格式 --ndb-connectstring=连接字符串类型 字符串 默认值 [无]设置用于连接到 ndb_mgmd 的连接字符串。语法:
[nodeid=。覆盖id;][host=]主机名[:端口]]NDB_CONNECTSTRING和my.cnf中的条目。 -
命令行格式 --ndb-mgm-tls=级别类型 枚举 默认值 relaxed有效值 relaxedstrict设置连接到管理服务器所需的 TLS 支持级别;
relaxed或strict之一。relaxed(默认值)表示尝试 TLS 连接,但不要求成功;strict表示连接需要 TLS。 -
命令行格式 --ndb-mgmd-host=连接字符串类型 字符串 默认值 [无]与
--ndb-connectstring相同。 -
命令行格式 --ndb-nodeid=#类型 整数 默认值 [无]设置此节点的节点 ID,覆盖 --ndb-connectstring 设置的任何 ID。
--ndb-optimized-node-selection命令行格式 --ndb-optimized-node-selection启用针对事务的节点选择的优化。默认情况下启用;使用
--skip-ndb-optimized-node-selection禁用。-
命令行格式 --ndb-tls-search-path=列表类型 路径名 默认值 (Unix) $HOME/ndb-tls默认值 (Windows) $HOMEDIR/ndb-tls指定要搜索 CA 文件的目录列表。在 Unix 平台上,目录名用冒号 (
:) 分隔;在 Windows 系统上,使用分号 (;) 作为分隔符。目录引用可以是相对的,也可以是绝对的;它可能包含一个或多个环境变量,每个变量都由前缀美元符号 ($) 表示,并在使用前进行扩展。搜索从最左侧命名的目录开始,并从左到右进行,直到找到文件。空字符串表示空搜索路径,这会导致所有搜索失败。由单个点 (
.) 组成的字符串表示搜索路径仅限于当前工作目录。如果未提供搜索路径,则使用编译的默认值。此值取决于使用的平台:在 Windows 上,这是
\ndb-tls;在其他平台(包括 Linux)上,这是$HOME/ndb-tls。这可以通过使用-DWITH_NDB_TLS_SEARCH_PATH编译 NDB 集群来覆盖。 -
命令行格式 --no-defaults除了登录文件之外,不要从任何选项文件读取默认选项。
-
命令行格式 --print-defaults打印程序参数列表并退出。
-
命令行格式 --usage显示帮助文本并退出;与 --help 相同。
-
命令行格式 --verbose在工具的输出中提供有关其进度的额外信息。
-
命令行格式 --version显示版本信息并退出。
例子
首先,我们使用此处显示的 CREATE TABLE 语句在 test 数据库中创建一个 NDB 表
USE test;
CREATE TABLE btest (
c0 BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
c1 TEXT,
c2 BLOB
) ENGINE=NDB;然后,我们使用一系列类似于以下语句的语句向该表中插入几行:
INSERT INTO btest VALUES (NULL, 'x', REPEAT('x', 1000));当使用 --check-orphans 选项针对此表运行时,ndb_blob_tool 会生成以下输出:
$> ndb_blob_tool --check-orphans --verbose -d test btest
connected
processing 2 blobs
processing blob #0 c1 NDB$BLOB_19_1
NDB$BLOB_19_1: nextResult: res=1
total parts: 0
orphan parts: 0
processing blob #1 c2 NDB$BLOB_19_2
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=0
NDB$BLOB_19_2: nextResult: res=1
total parts: 10
orphan parts: 0
disconnected该工具报告说,没有与列 c1 关联的 NDB BLOB 列部分,即使 c1 是 TEXT 列。这是因为在 NDB 表中,只有 BLOB 或 TEXT 列值的前 256 个字节存储在行内,并且只有超过此限制的部分(如果有)才会单独存储;因此,如果在这些类型之一的给定列中没有使用超过 256 个字节的值,则 NDB 不会为该列创建 BLOB 列部分。有关更多信息,请参见 第 13.7 节 “数据类型存储需求”。