\pset

设置一些选项来控制 Vertica 如何设置查询结果输出格式。

语法

\pset output-option

输出选项

format format‑option

设置输出格式，其中 format‑option 是以下项之一：

• u[naligned] 将每一行的所有列数据写入一行，其中每个字段仅由当前分隔符分隔。将此输出用作其他程序的输入，例如用于 CSV 输入的逗号分隔字段。

• a[ligned] （默认值）：呈现按列对齐的输出。

• h[tml]：将 HTML 标记中的输出呈现为表。

• l[atex]：在 LaTex 标记中呈现输出。

border int

仅当输出格式设置为 html 时有效，指定表边框，其中 int 指定边框类型。

expanded

在常规格式和扩展格式之间切换。如果启用了扩展格式，则所有输出都包含两个列，并且列名称位于左列而数据位于右列。这种模式对于宽表尤其有用。

fieldsep 'arg'

仅当输出格式设置为 unaligned 时有效，指定字段分隔符，默认分隔符为 |（竖线）。

例如，要将 Tab 指定为字段分隔符：

\pset fieldsep '\t'

footer

在是否显示默认表尾之间切换： （int 行）

null 'string'

指定此项可将列 null 值表示为 string。默认情况下，Vertica 将 null 值呈现为空字段，这可能会被误认为是空字符串。

例如：

\pset null '(null)'

pager [always]

在针对查询和 vsql 帮助输出是否使用寻呼机之间切换。如果已设置环境变量 PAGER，则输出会传送到指定的程序。否则会使用由平台决定的默认设置（例如 more）。

如果寻呼机已关闭，则不会使用寻呼机。如果寻呼机已打开，则只会在适当时使用寻呼机；也就是说，输出将传送到终端，并且不会显示在屏幕上。（vsql 无法准确评估何时应使用寻呼机。）

如果始终使用该实参进行限定，则始终使用寻呼机。

recordsep 'char'

仅当输出格式设置为 unaligned 时有效，指定用于分隔表记录（元组）的字符，默认分隔符为换行符。

tableattr html‑attribute[...]

指定要放在 HTML table 标记中的属性，例如 cellpadding 或 bgcolor。

title ['title‑str']

将位于查询结果输出之前的标题设置为 title‑str。HTML 输出呈现如下：

<caption>title-str</caption>

要移除标题，请重新发出命令，省略 title‑str 实参。

trailingrecordsep

开关要在未对齐输出模式中使用的尾随记录分隔符。

t[uples_only]

在仅显示元组和完整显示之间切换。完整显示可能会显示额外信息，例如，列标题、表标题和各个表尾。在仅显示元组模式下，只会显示实际表数据。

快捷方式

以下 \pset 命令有快捷方式：

\pset expanded

\x

\pset fieldsep 'arg'

\f

\pset format aligned

\a

\pset format html

\H

\pset tableattr html‑attribute[...]

\T html‑attribute[...]

\pset title title-str

\C ['title-str']

\pset tuples_only

\t

示例

请参阅输出格式设置示例。