Pular para o conteúdo principal
Esta função de tabela permite a integração do ClickHouse com o Redis.

Sintaxe

redis(host:port, key, structure[, db_index[, password[, pool_size]]])

Argumentos

ArgumentoDescrição
host:portEndereço do servidor Redis; você pode omitir a porta, e a porta padrão do Redis, 6379, será usada.
keyqualquer nome de coluna na lista de colunas.
structureO 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.
passwordSenha do usuário; o padrão é uma string vazia.
pool_sizeTamanho máximo do pool de conexões do Redis; o padrão é 16.
primarydeve 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.

Valor retornado

Um objeto de tabela, em que a chave é a chave do Redis e as demais colunas são agrupadas como valor do Redis.

Exemplo de uso

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