configurações do servidor storage_* - ClickHouse Documentation

Estas configurações definem o servidor ClickHouse e são geradas automaticamente a partir do código-fonte do ClickHouse.

storage_configuration

Permite configurar o armazenamento em múltiplos discos. A configuração de armazenamento segue a estrutura:

<storage_configuration>
    <disks>
        <!-- configuration -->
    </disks>
    <policies>
        <!-- configuration -->
    </policies>
</storage_configuration>

Configuração de disks

A configuração de disks segue a estrutura abaixo:

<storage_configuration>
    <disks>
        <disk_name_1>
            <path>/mnt/fast_ssd/clickhouse/</path>
        </disk_name_1>
        <disk_name_2>
            <path>/mnt/hdd1/clickhouse/</path>
            <keep_free_space_bytes>10485760</keep_free_space_bytes>
        </disk_name_2>
        <disk_name_3>
            <path>/mnt/hdd2/clickhouse/</path>
            <keep_free_space_bytes>10485760</keep_free_space_bytes>
        </disk_name_3>
        ...
    </disks>
</storage_configuration>

As subtags acima definem as seguintes configurações para disks:

Configuração	Descrição
`<disk_name_N>`	O nome do disco, que deve ser único.
`path`	O caminho onde os dados do servidor serão armazenados (catálogos `data` e `shadow`). Deve terminar com `/`
`keep_free_space_bytes`	Tamanho do espaço livre reservado no disco.

A ordem dos disks não importa.

Configuração de políticas

As subtags acima definem as seguintes configurações para policies:

Setting	Description
`policy_name_N`	Nome da política. Os nomes das políticas devem ser únicos.
`volume_name_N`	O nome do volume. Os nomes dos volumes devem ser únicos.
`disk`	O disco localizado dentro do volume.
`max_data_part_size_bytes`	O tamanho máximo de um fragmento de dados que pode ficar em qualquer um dos disks neste volume. Se a mesclagem resultar em um fragmento com tamanho previsto maior que `max_data_part_size_bytes`, o fragmento será gravado no próximo volume. Basicamente, esse recurso permite armazenar fragmentos novos/pequenos em um volume rápido (SSD) e movê-los para um volume lento (HDD) quando atingirem um tamanho maior. Não use esta opção se a política tiver apenas um volume.
`move_factor`	A proporção de espaço livre disponível no volume. Se o espaço ficar abaixo disso, os dados começarão a ser transferidos para o próximo volume, se houver. Para a transferência, os fragmentos são ordenados por tamanho, do maior para o menor (ordem decrescente), e são selecionados os fragmentos cujo tamanho total seja suficiente para atender à condição de `move_factor`; se o tamanho total de todos os fragmentos for insuficiente, todos os fragmentos serão movidos.
`perform_ttl_move_on_insert`	Desabilita a movimentação de dados com TTL expirado durante a inserção. Por padrão (se estiver habilitado), se inserirmos um dado que já expirou de acordo com a regra de movimentação por tempo de vida, ele será movido imediatamente para o volume/disco especificado na regra de movimentação. Isso pode tornar a inserção significativamente mais lenta caso o volume/disco de destino seja lento (por exemplo, S3). Se estiver desabilitado, a parte expirada dos dados será gravada no volume padrão e, em seguida, movida imediatamente para o volume especificado na regra do TTL expirado.
`load_balancing`	Política de balanceamento de disco, `round_robin` ou `least_used`.
`least_used_ttl_ms`	Define o timeout (em milissegundos) para atualizar o espaço disponível em todos os disks (`0` - sempre atualizar, `-1` - nunca atualizar, o valor padrão é `60000`). Observe que, se o disco for usado apenas pelo ClickHouse e não estiver sujeito a redimensionamento do sistema de arquivos dinamicamente, você pode usar o valor `-1`. Em todos os outros casos, isso não é recomendado, pois acabará levando a uma alocação incorreta de espaço.
`prefer_not_to_merge`	Desabilita a mesclagem de partes dos dados neste volume. Observação: isso é potencialmente prejudicial e pode causar lentidão. Quando esta configuração está habilitada (não faça isso), a mesclagem de dados neste volume é proibida (o que é ruim). Isso permite controlar como o ClickHouse interage com disks lentos. Recomendamos não usar isso de forma alguma.
`volume_priority`	Define a prioridade (ordem) em que os volumes são preenchidos. Quanto menor o valor, maior a prioridade. Os valores do parâmetro devem ser números naturais e cobrir o intervalo de 1 a N (N é o maior valor de parâmetro especificado), sem lacunas.

Para volume_priority:

Se todos os volumes tiverem esse parâmetro, eles serão priorizados na ordem especificada.
Se apenas alguns volumes o tiverem, os volumes que não o tiverem terão a menor prioridade. Aqueles que o tiverem serão priorizados de acordo com o valor da tag, e a prioridade dos demais será determinada pela ordem em que aparecem no arquivo de configuração.
Se nenhum volume receber esse parâmetro, a ordem deles será determinada pela ordem em que aparecem no arquivo de configuração.
A prioridade dos volumes não pode ser idêntica.

storage_metadata_write_full_object_key

Grava os arquivos de metadados do disco no formato VERSION_FULL_OBJECT_KEY. Esta configuração vem habilitada por padrão. A configuração está obsoleta.

storage_shared_set_join_use_inner_uuid

Quando habilitado, um UUID interno é gerado durante a criação de SharedSet e SharedJoin. Somente no ClickHouse Cloud

​storage_configuration

​Configuração de disks

​Configuração de políticas

​storage_metadata_write_full_object_key

​storage_shared_set_join_use_inner_uuid

storage_configuration

Configuração de disks

Configuração de políticas

storage_metadata_write_full_object_key

storage_shared_set_join_use_inner_uuid