Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

default_* 会话设置

View as MarkdownEdit this pageReport an issueSet up docs MCP

这些设置可在 system.settings 中查看，并由 源文件 自动生成。

default_format

版本历史
版本默认值注释
26.8新增设置：当查询不含 FORMAT 子句时使用的默认格式。

指定查询不含 FORMAT 子句且未应用其他格式覆盖时的查询结果格式。

default_materialized_view_sql_security

类型
SQLSecurityType
默认值
DEFINER
版本历史
版本默认值注释
24.2DEFINER允许在创建 materialized view 时为 SQL SECURITY 选项设置默认值

允许在创建 materialized view 时为 SQL SECURITY 选项设置默认值。更多有关 SQL SECURITY 的信息。

默认值为 DEFINER。

default_max_bytes_in_join

类型
UInt64
默认值
1000000000

当需要此限制但未设置 max_bytes_in_join 时，右侧表的最大大小。

default_normal_view_sql_security

类型
SQLSecurityType
默认值
INVOKER
版本历史
版本默认值注释
24.2INVOKER允许在创建普通视图时设置默认的 `SQL SECURITY` 选项

允许在创建普通视图时设置默认的 SQL SECURITY 选项。了解更多 SQL security。

默认值为 INVOKER。

default_table_engine

类型
DefaultTableEngine
默认值
MergeTree
版本历史
版本默认值注释
24.3MergeTree为提升易用性，将默认表引擎设为 MergeTree

在 CREATE 语句中未设置 ENGINE 时使用的默认表引擎。

可能的值：

  • 表示任意有效表引擎名称的字符串

Cloud 默认值：SharedMergeTree。

示例

查询：

SET default_table_engine = 'Log';

SELECT name, value, changed FROM system.settings WHERE name = 'default_table_engine';

结果：

┌─name─────────────────┬─value─┬─changed─┐
│ default_table_engine │ Log   │       1 │
└──────────────────────┴───────┴─────────┘

在本示例中，任何未指定 Engine 的新表都会使用 Log 表引擎：

查询：

CREATE TABLE my_table (
    x UInt32,
    y UInt32
);

SHOW CREATE TABLE my_table;

结果：

┌─statement────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.my_table
(
    `x` UInt32,
    `y` UInt32
)
ENGINE = Log
└──────────────────────────────────────────────────────────────────────────┘

default_temporary_table_engine

类型
DefaultTableEngine
默认值
Memory

与 default_table_engine 相同，只是适用于临时表。

在此示例中，任何未指定 Engine 的新临时表都将使用 Log 表引擎：

查询：

SET default_temporary_table_engine = 'Log';

CREATE TEMPORARY TABLE my_table (
    x UInt32,
    y UInt32
);

SHOW CREATE TEMPORARY TABLE my_table;

结果：

┌─statement────────────────────────────────────────────────────────────────┐
│ CREATE TEMPORARY TABLE default.my_table
(
    `x` UInt32,
    `y` UInt32
)
ENGINE = Log
└──────────────────────────────────────────────────────────────────────────┘

default_view_definer

类型
String
默认值
CURRENT_USER
版本历史
版本默认值注释
24.2CURRENT_USER可在创建视图时设置默认的 `DEFINER` 选项

可在创建视图时设置默认的 DEFINER 选项。关于 SQL security 的更多信息。

默认值为 CURRENT_USER。

Navigation