Redis: Redis Pipelining

パイプラインを使用すると、コマンドをバッチ送信でき、ネットワークラウンドトリップを削減してパフォーマンスを大幅に向上できます。

1. パイプラインとは

(1) 従来のアプローチ

各コマンドには1回のネットワークラウンドトリップが必要です：

BASH

クライアント                   Redisサーバー
  |                         |
  |----- SET key1 -------->|
  |<----- OK --------------|
  |                         |
  |----- SET key2 -------->|
  |<----- OK --------------|
  |                         |
  |----- SET key3 -------->|
  |<----- OK --------------|

3コマンド = 6回のネットワーク転送（3リクエスト + 3レスポンス）

(2) パイプラインアプローチ

複数のコマンドを一度に送信：

BASH

クライアント                   Redisサーバー
  |                         |
  |----- SET key1 -------->|
  |----- SET key2 -------->|
  |----- SET key3 -------->|
  |                         |
  |<----- OK --------------|
  |<----- OK --------------|
  |<----- OK --------------|

3コマンド = 2回のネットワーク転送（1バッチリクエスト + 1バッチレスポンス）

💡 パフォーマンス向上： パイプラインはネットワークラウンドトリップを削減し、特にネットワークレイテンシが高い場合にパフォーマンスを大幅に向上させます。

2. パイプラインの仕組み

(1) ネットワークレイテンシの影響

1msのネットワークラウンドトリップを想定：

BASH

従来のアプローチ：
- 100コマンド = 100ラウンドトリップ = 100msのネットワークレイテンシ
- 加えてRedis処理時間（0.1ms/コマンドと仮定）= 10ms
- 合計時間 = 100ms + 10ms = 110ms

パイプライン：
- 100コマンド = 1ラウンドトリップ = 1msのネットワークレイテンシ
- 加えてRedis処理時間 = 10ms
- 合計時間 = 1ms + 10ms = 11ms

パフォーマンス向上：110ms → 11ms、10倍の改善！

(2) パイプラインの特性

バッチ送信：複数のコマンドを一度に送信
順次実行：Redisはコマンドを順番に実行
バッチレスポンス：すべての結果が一度に返される
非アトミック：トランザクションではない。他のクライアントに中断される可能性がある

⚠️ 補足： パイプラインはトランザクションではなく、アトミック性を保証しません。アトミック性が必要な場合はMULTI/EXECを使用してください。

3. パイプラインの使用

(1) redis-cliのパイプラインモード

BASH

# redis-cliのパイプラインモードを使用
echo -e "SET key1 value1\nSET key2 value2\nSET key3 value3" | redis-cli

# またはファイルから読み取り
cat commands.txt | redis-cli

(2) Pythonでのパイプライン

PYTHON

import redis

r = redis.Redis(host='localhost', port=6379)

# パイプラインを作成
pipe = r.pipeline()

# パイプラインにコマンドを追加
pipe.set('key1', 'value1')
pipe.set('key2', 'value2')
pipe.set('key3', 'value3')

# パイプラインを実行
results = pipe.execute()
print(results)  # [True, True, True]

(3) Javaでのパイプライン（Jedis）

JAVA

Jedis jedis = new Jedis("localhost", 6379);

Pipeline pipeline = jedis.pipelined();

pipeline.set("key1", "value1");
pipeline.set("key2", "value2");
pipeline.set("key3", "value3");

List<Object> results = pipeline.syncAndReturnAll();

(4) Node.jsでのパイプライン（ioredis）

JAVASCRIPT

const Redis = require('ioredis');
const redis = new Redis();

const pipeline = redis.pipeline();

pipeline.set('key1', 'value1');
pipeline.set('key2', 'value2');
pipeline.set('key3', 'value3');

const results = await pipeline.exec();

4. パイプラインとトランザクションの比較

(1) パイプライン + トランザクション

パイプラインはトランザクションと組み合わせることができます：

PYTHON

import redis

r = redis.Redis()

# トランザクションを有効にしたパイプラインを作成
pipe = r.pipeline(transaction=True)

pipe.set('key1', 'value1')
pipe.set('key2', 'value2')
pipe.incr('counter')

# トランザクションを実行
results = pipe.execute()

(2) パイプラインとトランザクションの比較

項目	パイプライン	トランザクション
アトミック性	❌ なし	✅ あり
分離性	❌ なし	✅ あり
パフォーマンス向上	✅ 大幅	✅ 大幅
バッチ送信	✅ あり	✅ あり
使用例	バッチ操作、パフォーマンス	アトミック性が必要なバッチ操作

💡 選択： アトミック性が不要な場合はパイプラインを使用します。アトミック性が必要な場合はトランザクションまたはパイプライン+トランザクションを使用します。

5. パイプラインのユースケース

(1) ユースケース1：バッチ設定

PYTHON

import redis

r = redis.Redis()
pipe = r.pipeline()

# 1000個のキーをバッチ設定
for i in range(1000):
    pipe.set(f'key:{i}', f'value:{i}')

results = pipe.execute()
print(f'Set {len(results)} keys')

(2) ユースケース2：バッチ取得

PYTHON

import redis

r = redis.Redis()
pipe = r.pipeline()

# 1000個のキーをバッチ取得
keys = [f'key:{i}' for i in range(1000)]
for key in keys:
    pipe.get(key)

values = pipe.execute()
print(f'Got {len(values)} values')

(3) ユースケース3：バッチ削除

PYTHON

import redis

r = redis.Redis()
pipe = r.pipeline()

# バッチ削除
keys = ['key1', 'key2', 'key3', 'key4', 'key5']
for key in keys:
    pipe.delete(key)

results = pipe.execute()
print(f'Deleted {sum(results)} keys')

(4) ユースケース4：データインポート

PYTHON

import redis
import json

r = redis.Redis()
pipe = r.pipeline()

# JSONファイルからデータをインポート
with open('data.json', 'r') as f:
    data = json.load(f)
    
    for item in data:
        key = f"user:{item['id']}"
        value = json.dumps(item)
        pipe.set(key, value)

pipe.execute()
print('Import complete')

(5) ユースケース5：バッチカウンター更新

PYTHON

import redis

r = redis.Redis()
pipe = r.pipeline()

# バッチでカウンターを更新
counters = {
    'article:1:views': 10,
    'article:2:views': 20,
    'article:3:views': 30,
}

for key, increment in counters.items():
    pipe.incrby(key, increment)

pipe.execute()
print('Counters updated')

6. パイプラインのパフォーマンス比較

(1) テストコード

PYTHON

import redis
import time

r = redis.Redis()

# テストデータ
n = 10000

# 方法1：通常のアプローチ
start = time.time()
for i in range(n):
    r.set(f'key:{i}', f'value:{i}')
end = time.time()
print(f'Regular: {end - start:.2f} seconds')

# 方法2：パイプライン
start = time.time()
pipe = r.pipeline()
for i in range(n):
    pipe.set(f'key:{i}', f'value:{i}')
pipe.execute()
end = time.time()
print(f'Pipeline: {end - start:.2f} seconds')

▶ サンプル結果

BASH

Regular: 5.23 seconds
Pipeline: 0.51 seconds

Performance improvement: about 10x

7. パイプラインのベストプラクティス

(1) 適切なバッチサイズを設定

PYTHON

# ❌ 一度に送信するコマンドが多すぎる
pipe = r.pipeline()
for i in range(100000):
    pipe.set(f'key:{i}', f'value:{i}')
pipe.execute()  # 大量のメモリを使用する可能性がある

# ✅ バッチで実行
batch_size = 1000
for batch in range(0, 100000, batch_size):
    pipe = r.pipeline()
    for i in range(batch, batch + batch_size):
        pipe.set(f'key:{i}', f'value:{i}')
    pipe.execute()

(2) エラーハンドリング

PYTHON

import redis

r = redis.Redis()
pipe = r.pipeline()

pipe.set('key1', 'value1')
pipe.incr('key1')  # これは失敗する（key1は数値ではない）
pipe.set('key2', 'value2')

try:
    results = pipe.execute()
    for i, result in enumerate(results):
        if isinstance(result, Exception):
            print(f'Command {i} failed: {result}')
except Exception as e:
    print(f'Pipeline execution failed: {e}')

(3) アトミック性のためにトランザクションを使用

PYTHON

import redis

r = redis.Redis()

# アトミック性が必要な場合はトランザクションを使用
pipe = r.pipeline(transaction=True)

pipe.set('account:a', '100')
pipe.set('account:b', '50')

try:
    results = pipe.execute()
    print('Transaction executed successfully')
except Exception as e:
    print(f'Transaction failed: {e}')

(4) パイプラインのパフォーマンスを監視

PYTHON

import redis
import time

r = redis.Redis()

start = time.time()
pipe = r.pipeline()

for i in range(10000):
    pipe.set(f'key:{i}', f'value:{i}')

results = pipe.execute()
end = time.time()

print(f'Execution time: {end - start:.2f} seconds')
print(f'QPS: {10000 / (end - start):.0f}')

8. パイプラインの制限

(1) メモリ使用量

PYTHON

# パイプラインはすべてのコマンドと結果をキャッシュする
# バッチが大きすぎると大量のメモリを使用する

# 解決策：バッチで実行

(2) 非アトミック

PYTHON

# パイプライン内のコマンドは他のクライアントに中断される可能性がある
# アトミック性が必要な場合はトランザクションを使用

(3) 中間結果を使用できない

PYTHON

# パイプライン内で前のコマンドの結果を使用できない

# ❌ 誤った例
pipe = r.pipeline()
pipe.incr('counter')
# 後続のコマンドでincrの結果を取得できない
pipe.set('result', ???)  # incrの結果を使用できない
pipe.execute()

# ✅ 解決策：Luaスクリプトを使用

▶ サンプル

パイプラインのバッチ操作：

BASH

# 通常方式: コマンドごとに1回のネットワークラウンドトリップ
127.0.0.1:6379> SET key1 value1
OK
127.0.0.1:6379> SET key2 value2
OK

# パイプライン方式: 複数コマンドを一度に送信
echo -e "SET key1 value1\nSET key2 value2\nGET key1" | redis-cli --pipe
# 1回のラウンドトリップで完了

❓ よくある質問

Q パイプラインとトランザクションの違いは何ですか？

A パイプラインはネットワークラウンドトリップを削減しますが、アトミック性を保証しません。トランザクションはアトミック性を保証し、ネットワークラウンドトリップも削減します。

Q パイプラインによりどの程度のパフォーマンス向上が見込めますか？

A ネットワークレイテンシに依存します。レイテンシが高いほど改善効果が大きくなります。通常は5〜10倍です。

Q どのバッチサイズを使用すべきですか？

A バッチあたり100〜1000コマンドを推奨します。大きすぎるとメモリを多く使用し、小さすぎると改善効果が小さくなります。

Q パイプライン内のコマンドが失敗するとどうなりますか？

A 単一のコマンドの失敗は他のコマンドに影響しません。返された結果でエラーを確認してください。

Q いつパイプラインを使用すべきですか？

A バッチ操作、データのインポート/エクスポート、パフォーマンス向上が必要なあらゆるシナリオで使用します。

📖 まとめ

パイプラインはコマンドをバッチ送信し、ネットワークラウンドトリップを削減
特にネットワークレイテンシが高い場合に大幅なパフォーマンス向上
パイプラインはアトミック性を保証しない。必要な場合はトランザクションを使用
使用例：バッチ設定、バッチ取得、データインポート
ベストプラクティス：適切なバッチサイズ、エラーハンドリング、バッチ実行
パイプラインの制限：メモリ使用量、非アトミック、中間結果を使用不可

📝 練習問題

基本パイプライン： パイプラインを使用して100個のキーをバッチ設定し、通常のアプローチとパフォーマンスを比較しましょう
バッチ操作： パイプラインでバッチ取得とバッチ削除を実装しましょう
パフォーマンス比較： 異なるバッチサイズ（10、100、1000）でパフォーマンスをテストしましょう
パイプライン + トランザクション： トランザクション付きパイプラインを使用してアトミックなバッチ操作を実装しましょう

9. 次のレッスン

次のレッスンでは、PythonとRedisについて学びます。PythonでのRedis操作を解説します。

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

私たちについて