Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Como verificar o uso do cache de consultas no ClickHouse

View as MarkdownEdit this pageReport an issueSet up docs MCP

Como posso verificar se o cache de consultas está sendo usado na minha consulta?

Veja o exemplo a seguir usando clickhouse client e o serviço ClickHouse Cloud.

crie uma tabela query_cache_test

Como usar o clickhouse client

clickhouse-cloud :) CREATE TABLE query_cache_test (name String, age UInt8) ENGINE =MergeTree ORDER BY name

CREATE TABLE query_cache_test
(
    `name` String,
    `age` UInt8
)
ENGINE = MergeTree
ORDER BY name

Query id: 81c54f09-7de4-48ec-916f-c7c304a46931

Ok.

0 rows in set. Elapsed: 0.343 sec.

preencha a tabela com alguns dados:

clickhouse-cloud :) INSERT INTO query_cache_test SELECT * FROM generateRandom('name String, age UInt8',1,1) LIMIT 100000;

INSERT INTO query_cache_test SELECT *
FROM generateRandom('name String, age UInt8', 1, 1)
LIMIT 100000

Query id: 90369105-bd67-494c-bdaf-d90dbfb6def9

Ok.

0 rows in set. Elapsed: 0.173 sec. Processed 327.05 thousand rows, 3.43 MB (1.89 million rows/s., 19.86 MB/s.)

habilite os logs de nível trace:

clickhouse-cloud :) SET send_logs_level = 'trace'

SET send_logs_level = 'trace'

Query id: d65490b0-7960-4a85-a343-787e70e5e293

Ok.

0 rows in set. Elapsed: 0.134 sec.

execute uma consulta para usar o cache de consultas (acrescentando SETTINGS use_query_cache=true à consulta):

clickhouse-cloud :) SELECT name FROM query_cache_test WHERE age > 1000 FORMAT Null SETTINGS use_query_cache=true;

SELECT name
FROM query_cache_test
WHERE age > 1000
FORMAT `Null`
SETTINGS use_query_cache = 1

Query id: 3754a7fd-b786-47c1-a258-dfbc75e35a04

[c-red-qc-36-server-0] 2023.05.29 12:06:10.542408 [ 454 ] {3754a7fd-b786-47c1-a258-dfbc75e35a04} \

execute novamente a mesma consulta:

clickhouse-cloud :) SELECT name FROM query_cache_test WHERE age > 1000 FORMAT Null SETTINGS use_query_cache=true;

SELECT name
FROM query_cache_test
WHERE age > 1000
FORMAT `Null`
SETTINGS use_query_cache = 1

Query id: a047527c-9d55-4e6b-9747-0ccad8787515

[c-red-qc-36-server-0] 2023.05.29 12:06:17.931007 [ 454 ] {a047527c-9d55-4e6b-9747-0ccad8787515} \

Agora observe as diferenças nos logs TRACE relacionados ao QueryCache entre:

1ª execução:

[c-red-qc-36-server-0] 2023.05.29 12:06:10.543559 [ 454 ] {3754a7fd-b786-47c1-a258-dfbc75e35a04} \<Trace\> QueryCache: No entry found for query SELECT name FROM query_cache_test  WHERE age > 1000 FORMAT `Null` SETTINGS
[c-red-qc-36-server-0] 2023.05.29 12:06:10.547760 [ 454 ] {3754a7fd-b786-47c1-a258-dfbc75e35a04} \<Trace\> QueryCache: Stored result of query SELECT name FROM query_cache_test  WHERE age > 1000 FORMAT `Null` SETTINGS

na 2ª execução:

[c-red-qc-36-server-0] 2023.05.29 12:06:17.932043 [ 454 ] {a047527c-9d55-4e6b-9747-0ccad8787515} \<Trace\> QueryCache: Entry found for query SELECT name FROM query_cache_test  WHERE age > 1000 FORMAT `Null` SETTINGS

Na 1ª execução, claramente nenhuma entrada foi encontrada (No entry found for query SELECT...), então o ClickHouse de fato armazenou (Stored result of query SELECT...) a entrada para nós.

Na 2ª execução, a consulta usou o cache de consultas, pois encontrou a entrada já armazenada (Entry found for query SELECT...).

Usando apenas SQL

Apenas emitindo comandos SQL, sem inspecionar os logs no nível trace do clickhouse client,

também é possível validar se o cache de consultas está sendo usado verificando as tabelas system relevantes:

clickhouse-cloud :) SELECT 1 SETTINGS use_query_cache=true;

SELECT 1
SETTINGS use_query_cache = 1

Query id: a5a078c7-61e5-4036-a6f0-4d602d5b72d2

┌

Nos últimos resultados, vemos 1 QueryCacheMisses, referente à primeira vez em que a consulta SELECT 1 SETTINGS use_query_cache=true; foi executada, e um evento QueryCacheHits relacionado à segunda execução da consulta.

Lembre-se também de que o tamanho máximo padrão de uma entrada do cache é de 1048576 bytes (= 1 MiB) e que, por padrão, os resultados são armazenados no cache por apenas 60 segundos (por exemplo, você pode usar query_cache_ttl=300 em SETTINGS para armazenar o resultado de uma consulta no cache por 5 minutos).

Você pode encontrar informações mais detalhadas sobre o cache de consultas do ClickHouse aqui

Navigation