Saltar al contenido principal
Esta función de tabla permite integrar ClickHouse con Redis.

Sintaxis

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

Argumentos

ArgumentoDescripción
host:portDirección del servidor Redis; puede omitir el puerto y se usará el puerto predeterminado de Redis, 6379.
keycualquier nombre de columna de la lista de columnas.
structureEl esquema de la tabla de ClickHouse que devuelve esta función.
db_indexÍndice de la base de datos de Redis, de 0 a 15; el valor predeterminado es 0.
passwordContraseña del usuario; el valor predeterminado es una cadena vacía.
pool_sizeTamaño máximo del pool de conexiones de Redis; el valor predeterminado es 16.
primarydebe especificarse; solo admite una columna en la clave primaria. La clave primaria se serializará en binario como clave de Redis.
  • las columnas distintas de la clave primaria se serializarán en binario como valor de Redis en el orden correspondiente.
  • las consultas con filtros por igualdad de clave o IN se optimizarán como búsquedas de varias claves en Redis. Si las consultas no tienen filtro por clave, se realizará un escaneo completo de la tabla, que es una operación costosa.
Las colecciones con nombre no son compatibles con la función de tabla redis por el momento.

Valor devuelto

Un objeto de tabla en el que la clave actúa como clave de Redis y las demás columnas se agrupan como valor de Redis.

Ejemplo de uso

Lectura desde Redis:
SELECT * FROM redis(
    'redis1:6379',
    'key',
    'key String, v1 String, v2 UInt32'
)
Insertar en Redis:
INSERT INTO TABLE FUNCTION redis(
    'redis1:6379',
    'key',
    'key String, v1 String, v2 UInt32') values ('1', '1', 1);
Última modificación el 10 de junio de 2026