> ## 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.

# database_replicated_* session settings

> ClickHouse session settings in the database_replicated_* generated group.

These settings are available in [system.settings](https://clickhouse.com/docs/reference/system-tables/settings.md) and are autogenerated from [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

## database\_replicated\_allow\_explicit\_uuid

Type

UInt64

Default

0

0 - Don't allow to explicitly specify UUIDs for tables in Replicated databases. 1 - Allow. 2 - Allow, but ignore the specified UUID and generate a random one instead.

## database\_replicated\_allow\_heavy\_create

Type

Bool

Default

0

Allow long-running DDL queries (CREATE AS SELECT and POPULATE) in Replicated database engine. Note that it can block DDL queue for a long time.

## database\_replicated\_allow\_only\_replicated\_engine

Type

Bool

Default

0

Allow creating a table in a database with the `Replicated` engine only if the table either replicates its own
data stored on disk or does not store its own data on disk.

This restriction applies only to table-owned on-disk data, including data on remote disks. It does not guarantee
the durability of in-memory data or data managed by external systems.

For example, `ReplicatedMergeTree`, in-memory engines such as `Memory` and `Buffer`, metadata-only engines
such as `Merge` and `Alias`, and external-storage or data lake engines such as `S3` and `AzureBlobStorage` are
allowed. Non-replicated engines that store table data on disk, such as `MergeTree`, `Log`, `File`, and `Set`, are
rejected, including when their writable storage policy uses remote disks. `Set` and `Join` tables created with
`SETTINGS persistent = 0` keep their data only in memory and are allowed.

`Distributed`, `Remote`, and `RemoteSecure` tables are allowed. Their optional local background `INSERT` queue
is a transient send buffer, not data of the table itself. It is not replicated, and setting
`distributed_foreground_insert = 1` avoids the queue.

Cloud default value: `1`.

## database\_replicated\_allow\_replicated\_engine\_arguments

Type

UInt64

Default

0

0 - Don't allow to explicitly specify ZooKeeper path and replica name for \*MergeTree tables in Replicated databases. 1 - Allow. 2 - Allow, but ignore the specified path and use default one instead. 3 - Allow and don't log a warning.

## database\_replicated\_always\_detach\_permanently

Type

Bool

Default

0

Execute DETACH TABLE as DETACH TABLE PERMANENTLY if database engine is Replicated

## database\_replicated\_enforce\_synchronous\_settings

Type

Bool

Default

0

Enforces synchronous waiting for some queries (see also database\_atomic\_wait\_for\_drop\_and\_detach\_synchronously, mutations\_sync, alter\_sync). Not recommended to enable these settings.

## database\_replicated\_initial\_query\_timeout\_sec

Type

UInt64

Default

300

Sets how long initial DDL query should wait for Replicated database to process previous DDL queue entries in seconds.

Possible values:

* Positive integer.
* 0 — Unlimited.
