### 23.5.29 ndb_top - 查看 NDB 线程的 CPU 使用信息

[](<>)

[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)在终端中显示有关 NDB Cluster 数据节点上 NDB 线程的 CPU 使用情况的运行信息。每个线程在输出中由两行表示，第一行显示系统统计信息，第二行显示线程的测量统计信息。

[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)从 MySQL NDB Cluster 7.6.3 开始可用。

#### 用法

```
ndb_top [-h hostname] [-t port] [-u user] [-p pass] [-n node_id]
```

[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)连接到作为集群 SQL 节点运行的 MySQL 服务器。默认情况下，它会尝试连接到[**mysqld**](mysqld.html)继续运行`本地主机`和端口 3306，作为 MySQL`根`未指定密码的用户。您可以分别使用覆盖默认主机和端口，[`- 主持人`](mysql-cluster-programs-ndb-top.html#option_ndb_top_host)(`-h`） 和[`- 港口`](mysql-cluster-programs-ndb-top.html#option_ndb_top_port)(`-t`）。要指定 MySQL 用户和密码，请使用[`- 用户`](mysql-cluster-programs-ndb-top.html#option_ndb_top_user)(`-u`） 和[`--密码`](https://dev.mysql.com/doc/refman/5.7/en/mysql-cluster-programs-ndb-top.html#option_ndb_top_passwd)(`-p`） 选项。此用户必须能够读取[`ndbinfo`](mysql-cluster-ndbinfo.html)数据库（[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)使用来自[`ndbinfo.cpustat`](mysql-cluster-ndbinfo-cpustat.html)和相关表格）。

有关 MySQL 用户帐户和密码的更多信息，请参阅[第 6.2 节，“访问控制和帐户管理”](access-control.html).

输出以纯文本或 ASCII 图形形式提供；您可以使用[`- 文本`](mysql-cluster-programs-ndb-top.html#option_ndb_top_text)(`-x`） 和[`- 图形`](mysql-cluster-programs-ndb-top.html#option_ndb_top_graph)(`-g`) 选项。这两种显示模式提供相同的信息；它们可以同时使用。必须至少使用一种显示模式。

默认情况下支持并启用图形的彩色显示（[`- 颜色`](mysql-cluster-programs-ndb-top.html#option_ndb_top_color)要么`-c`选项）。启用颜色支持后，图形显示将 OS 用户时间显示为蓝色，OS 系统时间显示为绿色，空闲时间显示为空白。对于测量的负载，蓝色表示执行时间，黄色表示发送时间，红色表示发送缓冲区完全等待所花费的时间，空白表示空闲时间。图表显示中显示的百分比是所有非空闲线程的百分比总和。颜色当前不可配置；您可以使用灰度代替`--跳过颜色`.

排序后的视图 ([`- 种类`](mysql-cluster-programs-ndb-top.html#option_ndb_top_sort),`-r`) 基于测量负载和操作系统报告的负载的最大值。可以使用[`--测量负载`](mysql-cluster-programs-ndb-top.html#option_ndb_top_measured-load)(`-m`） 和[`--os-加载`](mysql-cluster-programs-ndb-top.html#option_ndb_top_os-load)(`-o`） 选项。必须启用至少显示这些负载之一。

程序尝试从具有节点 ID 的数据节点获取统计信息[`--node-id`](mysql-cluster-programs-ndb-top.html#option_ndb_top_node-id)(`-n`） 选项;如果未指定，则为 1。[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)无法提供有关其他类型节点的信息。

视图会根据终端窗口的高度和宽度自行调整；支持的最小宽度为 76 个字符。

一旦开始，[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)连续运行直到被迫退出；您可以使用退出程序`Ctrl-C`.显示每秒更新一次；要设置不同的延迟间隔，请使用[`- 睡觉时间`](mysql-cluster-programs-ndb-top.html#option_ndb_top_sleep-time)(`-s`）。

笔记

[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)适用于 macOS、Linux 和 Solaris。Windows 平台目前不支持它。

下表包括特定于 NDB Cluster 程序的所有选项[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html).附加说明如下表。

[](<>)

**表 23.49 与程序 ndb 一起使用的命令行选项\_最佳**

| 格式 | 描述 | 添加、弃用或删除 |
| --- | --- | -------- |
| `[--color](mysql-cluster-programs-ndb-top.html#option_ndb_top_color)`,<br/><br/>`[-c](mysql-cluster-programs-ndb-top.html#option_ndb_top_color)` | 以彩色显示 ASCII 图形；使用 --skip-colors 禁用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-extra-file=path](mysql-cluster-programs-ndb-top.html#option_ndb_top_defaults-extra-file)` | 读取全局文件后读取给定文件 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-file=path](mysql-cluster-programs-ndb-top.html#option_ndb_top_defaults-file)` | 仅从给定文件中读取默认选项 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--defaults-group-suffix=string](mysql-cluster-programs-ndb-top.html#option_ndb_top_defaults-group-suffix)` | 还阅读带有 concat(group, suffix) 的组 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--graph](mysql-cluster-programs-ndb-top.html#option_ndb_top_graph)`,<br/><br/>`[-g](mysql-cluster-programs-ndb-top.html#option_ndb_top_graph)` | 使用图表显示数据；使用 --skip-graphs 禁用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--help](mysql-cluster-programs-ndb-top.html#option_ndb_top_help)` | 显示程序使用信息 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--host=string](mysql-cluster-programs-ndb-top.html#option_ndb_top_host)`,<br/><br/>`[-h 字符串](mysql-cluster-programs-ndb-top.html#option_ndb_top_host)` | 要连接的 MySQL 服务器的主机名或 IP 地址 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--login-path=path](mysql-cluster-programs-ndb-top.html#option_ndb_top_login-path)` | 从登录文件中读取给定路径 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--measured-load](mysql-cluster-programs-ndb-top.html#option_ndb_top_measured-load)`,<br/><br/>`[-m](mysql-cluster-programs-ndb-top.html#option_ndb_top_measured-load)` | 按线程显示测量的负载 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--no-defaults](mysql-cluster-programs-ndb-top.html#option_ndb_top_no-defaults)` | 不要从登录文件以外的任何选项文件中读取默认选项 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--node-id=#](mysql-cluster-programs-ndb-top.html#option_ndb_top_node-id)`,<br/><br/>`[-n #](mysql-cluster-programs-ndb-top.html#option_ndb_top_node-id)` | 具有此节点 ID 的监视节点 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--os-load](mysql-cluster-programs-ndb-top.html#option_ndb_top_os-load)`,<br/><br/>`[-o](mysql-cluster-programs-ndb-top.html#option_ndb_top_os-load)` | 显示由操作系统测量的负载 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--password=password](mysql-cluster-programs-ndb-top.html#option_ndb_top_password)`,<br/><br/>`[-p 密码](mysql-cluster-programs-ndb-top.html#option_ndb_top_password)` | 使用此密码连接 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--port=#](mysql-cluster-programs-ndb-top.html#option_ndb_top_port)`,<br/><br/>`[-P #](mysql-cluster-programs-ndb-top.html#option_ndb_top_port)` (>=7.6.6) | 连接到 MySQL 服务器时使用的端口号 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--print-defaults](mysql-cluster-programs-ndb-top.html#option_ndb_top_print-defaults)` | 打印程序参数列表并退出 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--sleep-time=#](mysql-cluster-programs-ndb-top.html#option_ndb_top_sleep-time)`,<br/><br/>`[-s #](mysql-cluster-programs-ndb-top.html#option_ndb_top_sleep-time)` | 显示刷新之间的等待时间，以秒为单位 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--socket=path](mysql-cluster-programs-ndb-top.html#option_ndb_top_socket)`,<br/><br/>`[-S 路径](mysql-cluster-programs-ndb-top.html#option_ndb_top_socket)` | 用于连接的套接字文件 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--sort](mysql-cluster-programs-ndb-top.html#option_ndb_top_sort)`,<br/><br/>`[-r](mysql-cluster-programs-ndb-top.html#option_ndb_top_sort)` | 按使用情况对线程进行排序；使用 --skip-sort 禁用 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--text](mysql-cluster-programs-ndb-top.html#option_ndb_top_text)`,<br/><br/>`[-t](mysql-cluster-programs-ndb-top.html#option_ndb_top_text)`(>=7.6.6) | 使用文本显示数据 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--usage](mysql-cluster-programs-ndb-top.html#option_ndb_top_usage)` | 显示程序使用信息；与 --help 相同 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |
| `[--user=name](mysql-cluster-programs-ndb-top.html#option_ndb_top_user)`,<br/><br/>`[-u 名称](mysql-cluster-programs-ndb-top.html#option_ndb_top_user)` | 以此 MySQL 用户身份连接 | （所有基于 MySQL 8.0 的 NDB 版本都支持） |

#### 其他选项

-   [](<>) `- 颜色`,`-c`

    [](<>)[](<>)

    | 命令行格式 | `- 颜色` |
    | ----- | ------ |

    以彩色显示 ASCII 图形；采用`--跳过颜色`禁用。

-   [](<>) `--defaults-额外文件`

    [](<>)[](<>)

    | 命令行格式 | `--defaults-extra-file=路径` |
    | ----- | -------------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    读取全局文件后读取给定文件。

-   [](<>) `--defaults 文件`

    [](<>)[](<>)

    | 命令行格式 | `--defaults-file=路径` |
    | ----- | -------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    仅从给定文件中读取默认选项。

-   [](<>) `--defaults-组后缀`

    [](<>)[](<>)

    | 命令行格式 | `--defaults-group-suffix=字符串` |
    | ----- | ----------------------------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    还可以阅读带有 concat(group, suffix) 的组。

-   [](<>) `- 图形`,`-g`

    [](<>)[](<>)

    | 命令行格式 | `- 图形` |
    | ----- | ------ |

    使用图表显示数据；采用`--跳过图`禁用。此选项或[`- 文本`](mysql-cluster-programs-ndb-top.html#option_ndb_top_text)必须是真实的；两种选择都可能是真的。

-   [](<>) `- 帮助`,`-？`

    [](<>)[](<>)

    | 命令行格式 | `- 帮助` |
    | ----- | ------ |

    显示程序使用信息。

-   [](<>) `- 主持人[`=*`姓名]`*,`-h`

    [](<>)[](<>)

    | 命令行格式 | `--主机=字符串` |
    | ----- | ---------- |
    | 类型 | 细绳 |
    | 默认值 | `本地主机` |

    要连接的 MySQL 服务器的主机名或 IP 地址。

-   [](<>) `--登录路径`

    [](<>)[](<>)

    | 命令行格式 | `--登录路径=路径` |
    | ----- | ----------- |
    | 类型 | 细绳 |
    | 默认值 | `[没有]` |

    从登录文件中读取给定的路径。

-   [](<>) `--测量负载`,`-m`

    [](<>)[](<>)

    | 命令行格式 | `--测量负载` |
    | ----- | -------- |

    按线程显示测量的负载。此选项或[`--os-加载`](mysql-cluster-programs-ndb-top.html#option_ndb_top_os-load)必须是真实的；两种选择都可能是真的。

-   [](<>) `--no-defaults`

    [](<>)[](<>)

    | 命令行格式 | `--no-defaults` |
    | ----- | --------------- |

    不要从登录文件以外的任何选项文件中读取默认选项。

-   [](<>) `--node-id[`=*`#]`*,`-n`

    [](<>)[](<>)

    | 命令行格式 | `--node-id=#` |
    | ----- | ------------- |
    | 类型 | 整数 |
    | 默认值 | `1` |

    观察具有此节点 ID 的数据节点。

-   [](<>) `--os-加载`,`-o`

    [](<>)[](<>)

    | 命令行格式 | `--os-加载` |
    | ----- | --------- |

    显示由操作系统测量的负载。此选项或[`--测量负载`](mysql-cluster-programs-ndb-top.html#option_ndb_top_measured-load)必须是真实的；两种选择都可能是真的。

-   [](<>) `- 密码[`=*`密码]`*,`-p`

    [](<>)[](<>)

    | 命令行格式 | `--password=密码` |
    | ----- | --------------- |
    | 类型 | 细绳 |
    | 默认值 | `空值` |

    使用此密码和指定的 MySQL 用户连接到 MySQL 服务器[`- 用户`](mysql-cluster-programs-ndb-top.html#option_ndb_top_user).

    此密码仅与 MySQL 用户帐户相关联，与加密时使用的密码没有任何关系`新开发银行`备份。

-   [](<>) `- 港口[`=*`#]`*, `-P`

    [](<>)[](<>)

    | 命令行格式 | `--端口=#` |
    | ----- | -------- |
    | 类型 | 整数 |
    | 默认值 | `3306` |

    连接到 MySQL 服务器时使用的端口号。

    （以前，此选项的缩写形式是`-t`, 它被重新用作的缩写形式[`- 文本`](mysql-cluster-programs-ndb-top.html#option_ndb_top_text).)

-   [](<>) `--打印默认值`

    [](<>)[](<>)

    | 命令行格式 | `--打印默认值` |
    | ----- | --------- |

    打印程序参数列表并退出。

-   [](<>) `- 睡觉时间[`=*`秒]`*, `-s`

    [](<>)[](<>)

    | 命令行格式 | `--睡眠时间=#` |
    | ----- | ---------- |
    | 类型 | 整数 |
    | 默认值 | `1` |

    显示刷新之间的等待时间，以秒为单位。

-   [](<>) `--socket=*`路径/到/文件`*`, *`-S`*

    [](<>)[](<>)

    | 命令行格式 | `--socket=路径` |
    | ----- | ------------- |
    | 类型 | 路径名 |
    | 默认值 | `[没有]` |

    使用指定的套接字文件进行连接。

-   [](<>) `- 种类`, `-r`

    [](<>)[](<>)

    | 命令行格式 | `- 种类` |
    | ----- | ------ |

    按使用情况对线程进行排序；采用`--跳过排序`禁用。

-   [](<>) `- 文本`,`-t`

    [](<>)[](<>)

    | 命令行格式 | `- 文本` |
    | ----- | ------ |

    使用文本显示数据。此选项或[`- 图形`](mysql-cluster-programs-ndb-top.html#option_ndb_top_graph)必须是真实的；两种选择都可能是真的。

    （此选项的简短形式是`-x`在以前版本的 NDB Cluster 中，但不再支持。）

-   [](<>) `- 用法`

    [](<>)[](<>)

    | 命令行格式 | `- 用法` |
    | ----- | ------ |

    显示帮助文本并退出；与...一样[`- 帮助`](mysql-cluster-programs-ndb-top.html#option_ndb_top_help).

-   [](<>) `- 用户[`=*`姓名]`*,`-u`

    [](<>)[](<>)

    | 命令行格式 | `--user=name` |
    | ----- | ------------- |
    | 类型 | 细绳 |
    | 默认值 | `根` |

    以此 MySQL 用户身份连接。通常需要由管理员提供的密码[`- 密码`](mysql-cluster-programs-ndb-top.html#option_ndb_top_password)选项。

**样本输出。**下图显示[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)在 Linux 系统的终端窗口中运行[**ndbmtd**](mysql-cluster-programs-ndbmtd.html)中等负载下的数据节点。在这里，程序已使用[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html) [`-n8`](mysql-cluster-programs-ndb-top.html#option_ndb_top_node-id) [`-x`](mysql-cluster-programs-ndb-top.html#option_ndb_top_text)提供文本和图形输出：

[](<>)

**图 23.26 ndb\_在终端中运行**

<img alt="Display from ndb_top, running in a terminal window. Shows information for each node, including the utilized resources." src="images/ndb-top-1.png" height="675" width="800" />

从 NDB 8.0.20 开始，[**数据库\_最佳**](mysql-cluster-programs-ndb-top.html)还显示线程的旋转时间，以绿色显示。
