메인 콘텐츠로 건너뛰기
이 테이블 함수는 ClickHouse를 Redis와 통합할 수 있게 해줍니다.

구문

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

인수

인수설명
host:portRedis 서버 주소입니다. 포트는 생략할 수 있으며, 이 경우 기본 Redis 포트인 6379가 사용됩니다.
key컬럼 목록에 포함된 임의의 컬럼 이름입니다.
structure이 함수가 반환하는 ClickHouse 테이블의 스키마입니다.
db_indexRedis DB 인덱스이며 0부터 15까지 지정할 수 있고, 기본값은 0입니다.
password사용자 비밀번호이며, 기본값은 빈 문자열입니다.
pool_sizeRedis 연결 풀의 최대 크기이며, 기본값은 16입니다.
primary반드시 지정해야 하며, 기본 키는 하나의 컬럼만 지원합니다. 기본 키는 Redis 키로 바이너리 직렬화됩니다.
  • 기본 키를 제외한 컬럼은 해당 순서대로 Redis 값으로 바이너리 직렬화됩니다.
  • key에 대해 equals 또는 in 필터링이 있는 쿼리는 Redis의 다중 키 조회로 최적화됩니다. key 필터링이 없는 쿼리에서는 전체 테이블 스캔이 발생하며, 이는 비용이 큰 작업입니다.
이름이 지정된 컬렉션은 현재 redis 테이블 함수에서 지원되지 않습니다.

반환 값

key를 Redis 키로 하고, 나머지 컬럼을 함께 묶어 Redis 값으로 하는 테이블 객체입니다.

사용 예시

Redis에서 읽기:
SELECT * FROM redis(
    'redis1:6379',
    'key',
    'key String, v1 String, v2 UInt32'
)
Redis에 삽입:
INSERT INTO TABLE FUNCTION redis(
    'redis1:6379',
    'key',
    'key String, v1 String, v2 UInt32') values ('1', '1', 1);
마지막 수정일 2026년 6월 10일