Esta função de tabela permite a integração do ClickHouse com o Redis.
redis(host:port, key, structure[, db_index[, password[, pool_size]]])
| Argumento | Descrição |
|---|
host:port | Endereço do servidor Redis; você pode omitir a porta, e a porta padrão do Redis, 6379, será usada. |
key | qualquer nome de coluna na lista de colunas. |
structure | O esquema da tabela do ClickHouse retornada por esta função. |
db_index | Índice do banco de dados Redis, de 0 a 15; o padrão é 0. |
password | Senha do usuário; o padrão é uma string vazia. |
pool_size | Tamanho máximo do pool de conexões do Redis; o padrão é 16. |
primary | deve ser especificado; aceita apenas uma coluna na chave primária. A chave primária será serializada em binário como uma chave do Redis. |
- colunas diferentes da chave primária serão serializadas em binário como valor do Redis, na ordem correspondente.
- consultas com filtro em que a chave é igual a um valor ou usa
in serão otimizadas para busca de múltiplas chaves no Redis. Se as consultas forem executadas sem filtro pela chave, ocorrerá uma varredura completa da tabela, o que é uma operação pesada.
Coleções nomeadas não são compatíveis com a função de tabela redis no momento.
Um objeto de tabela, em que a chave é a chave do Redis e as demais colunas são agrupadas como valor do Redis.
Leitura do Redis:
SELECT * FROM redis(
'redis1:6379',
'key',
'key String, v1 String, v2 UInt32'
)
Inserir no Redis:
INSERT INTO TABLE FUNCTION redis(
'redis1:6379',
'key',
'key String, v1 String, v2 UInt32') values ('1', '1', 1);
Última modificação em 10 de junho de 2026