ClickHouse/docs/ja/sql-reference/table-functions/redis.md

slug	sidebar_position	sidebar_label
/ja/sql-reference/table-functions/redis	170	redis

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

参照

• Redisテーブルエンジン
• Dictionaryソースとしてredisを使用する