Passer au contenu principal
Cette fonction de table permet d’intégrer ClickHouse à Redis.

Syntaxe

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

Arguments

ArgumentDescription
host:portAdresse du serveur Redis ; si vous omettez le port, le port Redis par défaut 6379 sera utilisé.
keyN’importe quel nom de colonne figurant dans la liste des colonnes.
structureLe schéma de la table ClickHouse renvoyée par cette fonction.
db_indexIndex de la base de données Redis compris entre 0 et 15 ; la valeur par défaut est 0.
passwordMot de passe de l’utilisateur ; la valeur par défaut est une chaîne vide.
pool_sizeTaille maximale du pool de connexions Redis ; la valeur par défaut est 16.
primaryDoit être spécifié ; une seule colonne dans la clé primaire est prise en charge. La clé primaire sera sérialisée en binaire en tant que clé Redis.
  • les colonnes autres que la clé primaire seront sérialisées en binaire en tant que valeur Redis, dans l’ordre correspondant.
  • les requêtes avec un filtrage sur la clé via equals ou in seront optimisées en recherches multiclés dans Redis. Si les requêtes ne comportent pas de filtrage sur la clé, un balayage complet de la table sera effectué, ce qui constitue une opération coûteuse.
Les collections nommées ne sont actuellement pas prises en charge pour la fonction de table redis.

Valeur renvoyée

Un objet de type table, où la clé correspond à la clé Redis et les autres colonnes sont regroupées dans la valeur Redis.

Exemple d’utilisation

Lire à partir de Redis :
SELECT * FROM redis(
    'redis1:6379',
    'key',
    'key String, v1 String, v2 UInt32'
)
Insertion dans Redis :
INSERT INTO TABLE FUNCTION redis(
    'redis1:6379',
    'key',
    'key String, v1 String, v2 UInt32') values ('1', '1', 1);
Dernière modification le 25 juin 2026