redis

redis

ClickHouse와 Redis를 통합할 수 있게 해주는 테이블 함수예요. Redis 키-값 저장소의 데이터를 읽고 쓸 수 있어요.

출처: 문서

본문

이 테이블 함수는 ClickHouse와 Redis를 통합할 수 있게 해줘요.

문법 (Syntax)

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

인자 (Arguments)

인자 설명
host:port Redis 서버 주소예요. 포트를 생략할 수 있으며 기본 Redis 포트 6379가 사용돼요.
key 컬럼 목록에 있는 아무 컬럼 이름이에요.
structure 이 함수가 반환하는 ClickHouse 테이블의 스키마예요.
db_index 0부터 15까지의 Redis db 인덱스예요. 기본은 0이에요.
password 사용자 비밀번호예요. 기본은 빈 문자열이에요.
pool_size Redis 최대 연결 풀 크기예요. 기본은 16이에요.
primary 반드시 지정해야 하며, 기본 키에 컬럼 하나만 지원해요. 기본 키는 이진으로 직렬화되어 Redis 키가 돼요.

기본 키 이외의 컬럼들은 해당 순서대로 이진으로 직렬화되어 Redis 값이 돼요.

키가 같거나 in 필터링이 있는 쿼리는 Redis의 다중 키 조회로 최적화돼요. 키 필터가 없는 쿼리는 전체 테이블 스캔이 일어나며 이는 무거운 연산이에요.

현재 redis 테이블 함수에서는 네임드 컬렉션이 지원되지 않아요.

반환값 (Returned value)

기본 키가 Redis 키이고, 다른 컬럼들이 함께 Redis 값으로 묶인 테이블 객체예요.

사용 예시 (Usage Example)

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);

더 알아보기 (Learn more)