> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# format_* 格式设置

> format_* 生成组中的 ClickHouse 格式设置。

这些设置是根据[源文件](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/FormatFactorySettings.h)自动生成的。

## format\_display\_secrets\_in\_show\_and\_select

类型

Bool

默认值

0

启用或禁用在针对表、数据库、表函数和字典的 `SHOW` 与 `SELECT` 查询中显示敏感信息。

它还控制是否在 `system.settings`、`system.processes`、`system.settings_profile_elements` 以及 `SHOW CREATE USER` / `SHOW CREATE SETTINGS PROFILE` 中显示嵌入在设置值中的敏感信息 (例如 `format_avro_schema_registry_url` 中的密码) 。

希望查看敏感信息的用户，还必须启用
[`display_secrets_in_show_and_select` 服务器设置](https://clickhouse.com/docs/zh/reference/settings/server-settings/settings/other#display_secrets_in_show_and_select)
并拥有
[`displaySecretsInShowAndSelect`](https://clickhouse.com/docs/zh/reference/statements/grant#displaysecretsinshowandselect) 权限。

可能的值：

* 0 — 已禁用。
* 1 — 已启用。

## format\_geojson\_validate\_geometry

类型

Bool

默认值

1

控制 `GeoJSON` 格式是否在读写两个方向上强制执行 RFC 7946 的几何有效性规则。

启用时 (默认) ，不符合 GeoJSON 形态规则的几何对象会被拒绝：少于两个点的 `LineString` (或 `MultiLineString` 中的一条 line) ；少于四个点或首尾点不同 (即 ring 未闭合) 的 `Polygon` 或 `MultiPolygon` ring；以及空的 `MultiLineString`、`Polygon` 或 `MultiPolygon`。这同时适用于读取和写入：读取时，此类文档会被拒绝；写入时，此类 ClickHouse 值也会被拒绝，而不是生成一个会被输入格式拒绝的文档。

禁用时，则不会强制执行这些形态规则：此类 geometries 会按原样读取和写入，因此退化 geometries 可以 round-trip，但写出的文档可能不是有效的 GeoJSON。

这种校验仅限于结构层面：它只检查点数和 ring 是否闭合，不会检查形态在几何上的正确性——不会强制要求 ring 方向 (右手法则 / winding order) ，并且会接受结构上有效但几何上退化的 geometries，例如面积为零的 polygon、自相交的 ring，或 hole 位于外 ring 之外的 polygon。无论此设置是否启用，非有限坐标 (`NaN`、`Inf`) 始终都会被拒绝，因为它们无法表示为 JSON 数值。

## format\_hive\_text\_rows\_delimiter

类型

Char

默认值

Hive Text 输出格式中每行末尾的分隔符

## format\_json\_object\_each\_row\_column\_for\_object\_name

用于在 [JSONObjectEachRow](https://clickhouse.com/docs/zh/reference/formats/JSON/JSONObjectEachRow.md) 格式中存储/写入对象名称的列名。
列类型应为 String。若值为空，则会使用默认名称 `row_{i}` 作为对象名称。

## format\_protobuf\_use\_autogenerated\_schema

类型

Bool

默认值

1

在未设置 format\_schema 时，使用自动生成的 Protobuf

## format\_tsv\_null\_representation

类型

String

默认值

\N

TSV 格式的自定义 NULL 表示形式
