5.8.2.4 命令行帮助

使用 --help (-h) CLI 参数,可以在从命令行集成调用命令时访问 MySQL Shell 在线帮助。帮助在全局、对象和命令级别受支持。

注意

内置的帮助 CLI 参数不映射到任何 API 参数,并且在 CLI 中所有可用的对象和命令中都受支持。

命令和参数的描述取自目标 API 函数的现有文档。

全局 CLI 帮助

要检索可用于 CLI 调用的全局对象列表,请使用以下语法

$ mysqlsh -- --help

在此示例中,-- 启动命令的命令行集成部分。在之后使用 --help-h 选项单独列出此界面中可用的全局对象。

对象帮助

要从命令行集成访问对象帮助,请使用以下语法

$ mysqlsh -- object --help

其中 object 是您要获取帮助的对象,例如 dba 全局对象。此调用显示

  • 对象的简要说明。

  • 可用的命令列表及其简要说明。

要检索嵌套对象的帮助,请在 --help 参数之前提供整个对象列表。例如,要获取有关 shell.options 函数的帮助,请发出以下命令

$ mysqlsh -- shell options --help
命令帮助

要显示有关命令行集成的命令的帮助,请使用以下语法

$ mysqlsh -- object command --help

此调用显示有关 command 的详细信息,包括

  • 命令功能的简要说明。

  • 调用命令的签名。

  • 匿名参数列表及其简要说明。

  • 命名参数列表、其预期数据类型以及解释每个参数目的的简要说明。

对于嵌套对象中的命令,应该在命令之前提供整个对象列表,例如

$ mysqlsh shell options set-persist --help

对于期望特定数据类型的参数,参数将列出为

--name=type
Brief description of the parameter.

类型信息表示参数的预期数据类型,例如:strintuintboollistfloatdict

例如,dump-schemas 参数的 consistent

$ mysqlsh -- util dump-schemas --help
...
--consistent=<bool>
Enable or disable consistent data dumps. Default: true.
...

对于支持不同数据类型的参数,参数将列出为

--name[:type]=value
Brief description of the parameter.

例如,util.importTable() 操作的 columns 键。

$ mysqlsh -- util import-table --help
...
--columns[:<type>]=<value>
Array of strings and/or integers (default: empty array) - This...
...