Skip to main content
Edit this page

redis

このテーブル関数は、ClickHouseをRedisと統合するためのものです。

構文

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

引数

  • host:port — Redisサーバーのアドレス。ポートを指定しない場合はデフォルトでRedisのポート6379が使用されます。

  • key — カラムリスト内の任意のカラム名。

  • structure — この関数により返されるClickHouseテーブルのスキーマ。

  • db_index — Redisのデータベースインデックスで、範囲は0から15です。デフォルトは0です。

  • password — ユーザーのパスワード。デフォルトは空文字列です。

  • pool_size — Redisの最大接続プールサイズ。デフォルトは16です。

  • primaryは指定する必要があり、主キーには1つのカラムのみをサポートします。主キーはRedisキーとしてバイナリシリアライズされます。

  • 主キー以外のカラムは、対応する順序でRedisの値としてバイナリシリアライズされます。

  • キーが等しいかフィルタリングされているクエリは、Redisからのマルチキー検索に最適化されます。フィルタリングキーなしのクエリは、全テーブルスキャンが行われるため、重い操作になります。

現在、redisテーブル関数には名前付きコレクションはサポートされていません。

返される値

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

参照