PythonでRedis接続を完全攻略！redis-pyライブラリの基本と使い方

PythonでRedisに接続する方法（redis-pyの基本）

先生と生徒の会話形式で理解しよう

生徒

「Pythonを使ってRedisというデータベースに繋いでみたいのですが、どうすればいいですか？」

先生

「Pythonにはredis-pyという便利な道具があります。これを使えば、驚くほど簡単にデータの保存や取得ができるようになりますよ。」

生徒

「普通のデータベースと何が違うんでしょうか？」

先生

「Redisはメモリの上で動くので、爆速で動作するのが特徴です。まずは接続の基本から順番に見ていきましょう！」

1. Redisとredis-pyの基礎知識

Redis（レディス）とは、世界中で使われている非常に高速なデータベースの一種です。一般的なデータベースが「書類を本棚（ハードディスク）に片付ける」イメージなのに対し、Redisは「机の上（メモリ）に書類を広げておく」ような仕組みになっています。そのため、情報の出し入れがとにかく速いのが最大のメリットです。

そして、Pythonというプログラミング言語からRedisを操作するために必要な「仲介役」が、redis-py（レディス・パイ）というライブラリです。ライブラリとは、特定の機能を手軽に使うために誰かが作ってくれた「道具セット」のことです。これを使うことで、難しい通信の仕組みを知らなくても、簡単な命令だけでRedisを操ることができます。プログラミング未経験の方でも、リモコンでテレビを操作するように直感的に扱えるのが魅力です。

2. redis-pyをインストールして準備する

パソコンを触ったことがない方にとって「インストール」は難しく感じるかもしれませんが、スマホのアプリを入れるのと同じくらい簡単です。Pythonには「pip（ピップ）」という、新しい道具をダウンロードしてくるための命令があります。

コマンドプロンプトやターミナルという、黒い画面を開いて以下の命令を入力するだけで準備は完了です。これにより、あなたのパソコンの中でRedisと通信するための専用のプログラムが利用可能になります。これが、PythonでRedisの世界へ飛び込むための第一歩です。


# 以下の命令をターミナルで実行してライブラリを入れます
# pip install redis

3. Redisサーバーに接続する最初のステップ

準備ができたら、いよいよPythonからRedisに接続してみましょう。接続とは、例えるなら「電話をかける」ような作業です。相手の住所（ホスト名）と、入り口の番号（ポート番号）を指定して繋ぎます。

通常、自分のパソコンでRedisを動かしている場合は「localhost（ローカルホスト）」という住所を使います。ポート番号は、Redisの標準的な番号である「6379」を使います。以下のプログラムを実行して、エラーが出なければ無事に電話が繋がったことになります。もし繋がらない場合は、Redisのソフト自体が動いているか確認しましょう。


import redis

# Redisに接続するための情報を設定します
# hostはサーバーの場所、portは入り口の番号です
r = redis.Redis(host='localhost', port=6379, db=0)

# 試しに接続が生きているか確認します（ping命令）
if r.ping():
    print("Redisとの接続に成功しました！")


Redisとの接続に成功しました！

4. 文字列データを保存して読み出す基本操作

接続ができたら、実際にデータを保存してみましょう。Redisの最も得意な使い方は「キーと値（バリュー）」の組み合わせで保存することです。これは、靴箱の名札（キー）と中身の靴（バリュー）の関係に似ています。名札を指定すれば、すぐに中身が取り出せます。

データの保存には set（セット）命令を使い、取り出しには get（ゲット）命令を使います。Pythonでこれを行うと、まるで変数を扱うようにスムーズにデータのやり取りが可能です。ただし、Redisから取り出したデータは「バイト列」という特殊な形式になっていることがあるので、文字として読むために decode（デコード）という作業が必要になることを覚えておきましょう。


import redis

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

# 「user_name」という名前（キー）で「たろう」という値（バリュー）を保存
r.set('user_name', 'たろう')

# 保存したデータを取り出します
name = r.get('user_name')

# 取り出したデータはそのままでは読みづらいので、文字に変換します
print(name.decode('utf-8'))


たろう

5. リスト形式で複数のデータを扱う方法

Redisは、一つのキーに対して複数のデータを順番に並べて保存することもできます。これを「リスト」と呼びます。例えば、買い物リストや最新のメッセージ履歴などを保存するのに便利です。リストの右側（最後）にデータを追加するときは rpush（アールプッシュ）を使います。

「r」はRight（右）を意味します。逆に左側に追加する lpush もあります。これを使えば、データの行列を自由に操ることができます。取得するときは lrange（エルレンジ）を使い、どこからどこまでを取り出すかを指定します。最初から最後まで全部見たいときは「0から-1まで」と書くのがRedisのルールです。


import redis

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

# リストの最後にデータを追加していきます
r.rpush('my_list', 'りんご')
r.rpush('my_list', 'ばなな')
r.rpush('my_list', 'みかん')

# リストの全データを取得して表示します
items = r.lrange('my_list', 0, -1)

for item in items:
    print(item.decode('utf-8'))


りんご
ばなな
みかん

6. ハッシュを使って複雑なデータをまとめる

「名前」「年齢」「性別」といった複数の項目を一つのグループとして保存したい場合は、ハッシュ（Hash）という機能を使います。これは、一つの大きな箱（キー）の中に、さらに小さな仕切り（フィールド）があるようなイメージです。名簿のようなデータを作るのに最適です。

保存には hset（エイチセット）を使い、取り出しには hget（エイチゲット）を使います。バラバラに保存するよりも管理がしやすく、後から特定の項目だけを書き換えるのも非常に簡単です。プログラミングを始めたばかりの人でも、整理整頓が得意なRedisの良さを一番実感できる機能かもしれません。


import redis

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

# 「user:1」という箱の中に、名前と年齢を保存します
r.hset('user:1', mapping={
    'name': '花子',
    'age': '25'
})

# 特定の項目（名前）だけを取り出します
user_name = r.hget('user:1', 'name')
print("ユーザー名:", user_name.decode('utf-8'))

# 全ての項目を一度に取り出すことも可能です
all_data = r.hgetall('user:1')
print("全てのデータ:", all_data)

7. データの有効期限を設定して自動削除

Redisのとても便利な機能に「賞味期限」の設定があります。これを有効期限（TTL）と呼びます。例えば、5分間だけ有効なパスワードや、今日一日の間だけ表示したいニュースなど、時間が経つと勝手に消えてほしいデータに使います。

expire（エクスパイア）という命令を使うことで、秒単位で期限を決められます。これを使えば、古いデータが溜まり続けてメモリがいっぱいになるのを防ぐことができます。自分で消すプログラムを書かなくても、Redisが勝手にお掃除をしてくれる、とても賢い機能です。パソコンの空き容量を気にする必要がなくなるので、安心してデータを扱えますね。

8. 接続プールを使って効率アップ

プログラムの中で何度も接続したり切断したりするのは、実はパソコンにとって負担がかかる作業です。そこで使われるのが接続プール（コネクションプール）という仕組みです。あらかじめ複数の「接続の通り道」を用意しておき、それを使い回すことで、無駄な待ち時間をなくします。

大人数が同時に使うようなアプリを作る場合は、この設定が非常に重要になります。redis-pyでは、このプール機能も簡単に導入できます。最初は少し難しく感じるかもしれませんが、「みんなで一つの回線を仲良く、効率よく使うための工夫」だと考えておけば十分です。これを設定するだけで、プロのような安定したプログラムに一歩近づきます。

9. パスワードやSSLでセキュリティを強化

インターネット越しにRedisを使う場合は、誰かにデータを盗まれないように「鍵」をかける必要があります。これにはパスワード設定やSSLという通信の暗号化を使います。自分だけの合言葉を設定することで、許可された人だけがデータを読み書きできるようにします。

接続する際の命令に password='あなたのパスワード' と付け加えるだけで、強固な守りが手に入ります。大切なユーザー情報や秘密のデータを扱うときは、必ずこのセキュリティ設定を意識するようにしましょう。初心者のうちから安全性を意識することは、立派なエンジニアになるための大切な姿勢です。

10. トラブルシューティングと接続確認のコツ

最後に、もしうまく繋がらなかったときの解決法を紹介します。一番多いのは「Redisが起動していない」というケースです。まずはパソコンの中でRedisのソフトが元気に動いているか確認しましょう。また、住所（ホスト名）のスペルミスがないかもチェックが必要です。

困ったときは ping() 命令を使って、「もしもし、聞こえますか？」と問いかけてみるのが基本です。また、エラーメッセージをよく読むと、「パスワードが違います」や「場所が見つかりません」といったヒントが英語で書かれています。これらを一つずつ解決していくことが、プログラミング上達の近道になります。RedisとPythonの組み合わせは無限の可能性を秘めています。ぜひ色々なデータを保存して遊んでみてください！

公的機関での指導実績【Python実務設計実践セミナー】