定义用于解析非结构化输出的 Junos PyEZ 操作表

表名称是表的用户定义标识符。YAML 文件或字符串可以包含一个或多个表。YAML 文档的开头必须保持对齐。以下示例定义了一个名为 ChassisFanTable：

用于非结构化输出的 Junos PyEZ 操作表从 CLI 或 vty 命令的文本输出中提取数据。您必须在表定义中包含该 command 属性，以指定要在设备上执行的 CLI 命令或要在给定 FPC 上执行的 vty 命令。您可以将命令定义为简单字符串或 Jinja 模板。

例如，下表在 show chassis fan 设备上执行命令。

下表在目标FPC上执行vty show cmerror module brief 命令。

将命令定义为 Jinja 模板时，还必须提供args参数。该args参数是键值对的字典，用于将模板中的变量映射到渲染模板时使用的值。有关将命令定义为 Jinja 模板的信息，请参阅命令参数 （参数）。

您可以将参数的 command CLI 或 vty 命令定义为 Jinja 模板，用于替换命令参数的变量。使用 Jinja 模板时，还必须定义参数 args 。该 args 参数是键值对的字典，用于将 Jinja 模板中的变量名称映射到渲染模板时使用的值。您可以在表定义中为模板变量提供默认值，也可以在 Junos PyEZ 应用程序中定义这些值。

要定义模板变量的默认值，请在表定义中包括 args 该参数，并将每个模板变量映射到其默认值。下表定义了使用具有一个变量 . protocol该 args 参数定义 的默认值 protocol。当您在脚本中调用 get() 该方法时，应用程序使用默认值，并且不提供替代该默认值的参数。

此外，您可以将 args 参数定义为 Table get() 方法中的字典，以：

• 为表中未定义默认值的任何模板变量定义一个值

• 覆盖表中为一个或多个模板变量定义的默认值

以下示例使用协议“bgp”而不是默认值“ospf”执行上表中的命令。

Junos PyEZ 操作表可以在特定的 FPC 上执行 vty 命令。使用 vty 命令时，Table 必须包含用于target定义目标 FPC 的参数。您可以设置为targetNull并强制用户在应用程序中指定目标 FPC。或者，您可以设置为target默认 FPC，用户可以选择在应用程序中覆盖此值。

下表执行 show memory vty 命令，但将 target: Null.因此，用户必须在 Junos PyEZ 应用程序中指定目标 FPC：

下表在 FPC 1 上执行 show memory vty 命令，除非用户在 Junos PyEZ 应用程序中覆盖此值。

在 Junos PyEZ 应用程序中，您可以定义目标 FPC 或覆盖表中定义的默认 FPC。要指定 FPC，请将 Table 方法get()中的参数设置为target所需的 FPC，例如：

可选的 Table item 属性是一个字符串或正则表达式，用于定义如何拆分命令输出以进行解析。如果输出具有相似的重复数据集，则可以定义以匹配 item 和提取数据的每个迭代。例如， show interfaces 为多个接口返回一组类似的数据。或者，您可以定义 item: '*' 何时需要将数据提取为单个文本块。

请考虑 vty 命令的 show devices local 以下输出：

下表提取了以 开头 TSEC Ethernet Device Driver:的输出的每个部分。在这种情况下，的 key: name 值派生自 中定义 item的正则表达式中的捕获组。

如果要匹配输出的整个部分而不是匹配每一行，也可以定义item为星号 （'*'）。在大多数情况下，如果包含 item: '*'，还必须包含该title参数来指定要提取的输出部分的标题。当您将参数包含在regex视图中并希望每个表达式与整个文本字符串匹配时，提取item: '*'输出非常有用。否则，regex将组合表达式并针对每一行进行匹配。

下表提取标题 Receive: 下的文本块，并将每个正则表达式与整个文本字符串进行匹配：

optional key 属性定义用于唯一标识 Table 项的输出字段。您可以使用单个键或键列表来标识表项。如果表和视图返回迭代数据，则该 key 值必须引用视图中定义的变量或字段名称。

考虑以下 show chassis fan 输出：

下表将 Table 项键定义为 fan-name，该键映射到输出中列 Item 下的值。

在 Junos PyEZ 应用程序中检索和打印数据时，生成的字典中的每个项都使用此字段的值作为其键。

您还可以定义 key 为列表，以使用复合键标识表项。例如：

该 key 参数定义唯一标识表项的输出字段。在表中包括 key 该参数时，可以使用可选 key_items 参数仅返回某些键值的数据。 key_items 定义要检索数据的表项的键或键列表。您可以在表定义或 Junos PyEZ 应用程序中定义 key_items 该参数。

考虑以下 show chassis fan 输出：

下表将 Table 项键定义为 fan-name ，并且仅检索键值 Fan 1等于 的 Table 项的数据。

在 Junos PyEZ 应用程序中，您可以定义返回，key_items也可以覆盖表中定义的。key_items将 Table 方法get()中的参数设置为key_items所需项的列表或元组。例如：

表可以包括可选 title 参数，用于定义命令输出中要从中提取和解析数据的部分的起点。当“表”定义 item: '*'时，必须包含 title 以指定要提取的输出部分的标题

例如，考虑以下命令输出，它包含在一组更大的输出中：

下表使用该 title 参数从输出部分提取 TSEC status counters 和分析数据。在这种情况下，Table 定义 item 为 '*'，它将数据视为单个文本字符串。

某些操作命令返回的输出仅由键值对组成。如果只想检索整组数据并提取每个键值对，则可以使用该 delimiter 参数而不是定义单独的视图。该 delimiter 参数定义如何拆分每个数据对。Junos PyEZ 使用分隔符在指定边界处拆分数据，并将每个键值对存储在字典中。

请考虑 vty 命令的 show link stats 以下输出。

下表将分隔符定义为冒号 （:) 字符：

在 Junos PyEZ 应用程序中检索数据时，该表会在分隔符处拆分每行输出，并将键值对存储在字典中。

您可以使用可选 eval 参数在表和视图返回的最终数据中添加或修改键值对。该 eval 参数将键名映射到包含数学表达式的字符串。您可以在表和视图中包含该 eval 参数，并且 eval 可以定义和计算多个值。

在表中使用时eval，它会引用完整的数据字典进行计算。键和计算值将作为单个附加项添加到字典中。在视图中使用时eval，将在数据的每次迭代时计算表达式。计算值将添加到该迭代的数据中。如果键名称与视图中定义的键匹配，eval则eval将该键的值替换为计算值。如果键名称与视图中定义的键不匹配，eval则eval将新键和计算值添加到数据中。

表达 eval 式可以引用 data 视图返回的字典。表达式必须使用 Jinja 模板变量进行引用 data ，以便 Junos PyEZ 可以在计算表达式时使用字典替换该变量。

从 Junos PyEZ 2.8.1 版开始，表和视图 eval 语句中使用的表达式将使用受限实现进行评估，以降低代码执行安全风险。在计算之前，Junos PyEZ 会根据一组受支持的 Python 语法、函数、方法和运算来解析和验证每个表达式。包含不受支持或不安全元素的表达式将被拒绝并显示 UnsafeExpressionError 错误。 表 2 概述了支持的表达式。

+ - * / // % **

以下示例 eval 在表定义中使用，以在数据字典中包含一个附加条目。添加项的键是 total_interrupts，其值是中断次数的总和。

您还可以在表中定义 eval 以计算和添加多个键值对，例如：

有关在视图中使用的信息eval，请参阅评估表达式 （eval）。

该 view 属性将 Table 定义与特定视图相关联。视图定义应如何解析表输出，并将用户定义的 Python 变量名称映射到所选表项中的输出字段。您可以自定义“视图”以仅从“表”项中选择某些字段。

如果输出仅包含键值对，则可以使用 Table 的 delimiter 参数提取数据并将键值对存储在字典中。在这种情况下，无需定义单独的视图。

Junos PyEZ 表可以引用 TextFSM 模板来解析来自瞻博网络设备或其他供应商设备的命令输出。您必须在 Junos PyEZ 服务器或虚拟环境中安装该 ntc-templates 库，才能在表中使用 TextFSM 模板。

要使用 TextFSM 模板解析命令输出，请包含在use_textfsm: True表中。您可以仅使用 TextFSM 模板，也可以将该模板与 Junos PyEZ 视图结合使用。Junos PyEZ 使用和platformcommand值来确定模板的文件名。

例如，下表使用 juniper_junos_show_arp_no-resolve.textfsm 模板来解析来自 瞻博网络 Junos 设备的命令输出：

有关将 Junos PyEZ 表与 TextFSM 模板配合使用的详细信息，请参阅将 Junos PyEZ 表与 TextFSM 模板配合使用。