初识 Redis 连接：一步步带你入门 – wiki词典

作者： /

初识 Redis 连接：一步步带你入门

Redis（Remote Dictionary Server）是一个开源的、内存中的数据结构存储，可用作数据库、缓存和消息代理。它以其闪电般的速度、灵活的数据结构以及对各种编程语言的广泛支持而闻名。要充分利用 Redis，第一步就是学会如何连接到它。

本文将带领您逐步了解如何连接到 Redis 服务器，从命令行工具到常见的编程语言客户端。

前提条件

在开始之前，请确保您已经安装并运行了 Redis 服务器。如果您还没有，可以访问 Redis 官方网站 (redis.io) 获取安装指南。

验证 Redis 服务器是否正在运行的最简单方法是打开终端或命令提示符，然后输入：

bash
redis-cli ping

如果服务器正常运行，您应该会看到响应 PONG。

第一步：使用 Redis 命令行界面 (CLI) 连接

redis-cli 是 Redis 官方提供的一个命令行工具，它是连接和操作 Redis 最直接的方式。

默认连接

如果您在本地机器上运行 Redis 服务器，并且使用默认端口（6379），那么直接运行 redis-cli 就可以连接：

bash
redis-cli

连接成功后，提示符会变为 127.0.0.1:6379>，表示您已连接到本地 Redis 实例。

指定主机和端口

如果您的 Redis 服务器不在本地，或者使用了非默认端口，您需要使用 -h 和 -p 参数：

bash
redis-cli -h your_redis_host -p your_redis_port

例如，如果您的 Redis 服务器在 IP 地址 192.168.1.100 上，端口是 6380：

bash
redis-cli -h 192.168.1.100 -p 6380

使用密码验证

如果您的 Redis 服务器设置了密码（推荐生产环境使用），则需要通过 -a 参数提供密码：

bash
redis-cli -h your_redis_host -p your_redis_port -a your_password

或者，在连接后使用 AUTH 命令：

bash
redis-cli
AUTH your_password

测试连接

连接后，您可以尝试一些简单的 Redis 命令：

127.0.0.1:6379> SET mykey "Hello, Redis!"
OK
127.0.0.1:6379> GET mykey
"Hello, Redis!"
127.0.0.1:6379> QUIT

第二步：从编程语言中连接 Redis

在实际应用中，我们通常会使用编程语言的客户端库来连接 Redis。这里我们以 Python 和 Go 语言为例。

Python 示例

Python 是连接 Redis 的常用语言，其 redis-py 库功能强大且易于使用。

1. 安装 redis-py：

bash
pip install redis

2. 编写 Python 代码连接 Redis：

“`python
import redis

def connect_to_redis(host=’localhost’, port=6379, db=0, password=None):
“””
连接到 Redis 服务器并执行一些基本操作。
“””
try:
# 创建 Redis 连接池
# decode_responses=True 会自动将 Redis 的响应从字节解码为字符串
pool = redis.ConnectionPool(
host=host,
port=port,
db=db,
password=password,
decode_responses=True
)
r = redis.Redis(connection_pool=pool)

    # 测试连接
    r.ping()
    print(f"成功连接到 Redis: {host}:{port}/{db}")

    # 执行 SET 和 GET 操作
    r.set('python_key', 'Hello from Python!')
    value = r.get('python_key')
    print(f"获取 'python_key' 的值: {value}")

    # 删除键
    r.delete('python_key')
    print("已删除 'python_key'")

except redis.exceptions.ConnectionError as e:
    print(f"无法连接到 Redis 服务器: {e}")
except Exception as e:
    print(f"发生错误: {e}")

if name == “main“:
# 默认连接到本地 Redis
connect_to_redis()

# 如果有密码或不同配置，可以这样连接：
# connect_to_redis(host='192.168.1.100', port=6380, password='your_secret_password')

“`

代码解释：

  • redis.ConnectionPool: 推荐使用连接池来管理 Redis 连接，这在并发环境下能提高性能并避免频繁创建/关闭连接。
  • redis.Redis: 通过连接池创建 Redis 客户端实例。
  • decode_responses=True: 这是一个非常方便的参数，它告诉 redis-py 自动将从 Redis 读取的所有响应（通常是字节类型）解码成 UTF-8 字符串，省去了手动 decode('utf-8') 的麻烦。

Go 示例

对于 Go 语言，go-redis/redis/v8 (或 go-redis/redis/v9) 是一个非常流行且功能强大的客户端库。

1. 初始化 Go 模块并安装 go-redis：

bash
go mod init your_module_name # 如果还没有 go.mod
go get github.com/go-redis/redis/v8

2. 编写 Go 代码连接 Redis：

“`go
package main

import (
“context”
“fmt”
“time”

"github.com/go-redis/redis/v8" // 根据版本选择 v8 或 v9

)

var ctx = context.Background()

func connectToRedis(host string, port string, password string, db int) {
rdb := redis.NewClient(&redis.Options{
Addr: fmt.Sprintf(“%s:%s”, host, port),
Password: password, // no password set
DB: db, // use default DB
PoolSize: 10, // 连接池大小
})

// 测试连接
_, err := rdb.Ping(ctx).Result()
if err != nil {
    fmt.Printf("无法连接到 Redis 服务器: %v\n", err)
    return
}
fmt.Printf("成功连接到 Redis: %s:%s/%d\n", host, port, db)

// 执行 SET 操作
err = rdb.Set(ctx, "go_key", "Hello from Go!", 0).Err() // 0 表示永不过期
if err != nil {
    fmt.Printf("设置 go_key 失败: %v\n", err)
    return
}
fmt.Println("已设置 'go_key'")

// 执行 GET 操作
value, err := rdb.Get(ctx, "go_key").Result()
if err != nil {
    fmt.Printf("获取 'go_key' 失败: %v\n", err)
    return
}
fmt.Printf("获取 'go_key' 的值: %s\n", value)

// 设置带过期时间的键
err = rdb.Set(ctx, "temp_key", "Will expire in 10 seconds", 10*time.Second).Err()
if err != nil {
    fmt.Printf("设置 temp_key 失败: %v\n", err)
    return
}
fmt.Println("已设置 'temp_key' (10秒后过期)")

// 删除键
_, err = rdb.Del(ctx, "go_key").Result()
if err != nil {
    fmt.Printf("删除 go_key 失败: %v\n", err)
    return
}
fmt.Println("已删除 'go_key'")

}

func main() {
// 默认连接到本地 Redis
connectToRedis(“localhost”, “6379”, “”, 0) // 空字符串表示无密码

// 如果有密码或不同配置，可以这样连接：
// connectToRedis("192.168.1.100", "6380", "your_secret_password", 1)

}

“`

代码解释：

  • context.Background(): 在 Go 语言中，通常使用 context 来管理请求的生命周期和取消信号。这里使用 Background 作为顶级上下文。
  • redis.NewClient: 创建 Redis 客户端实例。
  • redis.Options: 结构体用于配置连接参数，如地址 (Addr)、密码 (Password)、数据库索引 (DB) 和连接池大小 (PoolSize)。
  • .Result(): 许多 go-redis 命令都会返回一个 (value, error) 对，使用 .Result() 可以方便地解构它们。

第三步：理解连接参数

无论是使用 redis-cli 还是编程语言客户端，您都会遇到一些关键的连接参数：

  • Host (主机/地址)：Redis 服务器运行的 IP 地址或域名（例如 localhost, 127.0.0.1, my.redis.server.com）。
  • Port (端口)：Redis 服务器监听的端口。默认是 6379。
  • Password (密码)：如果 Redis 服务器配置了密码验证（requirepass），则需要提供正确的密码。
  • DB (数据库索引)：Redis 支持 16 个逻辑数据库（从 0 到 15）。默认连接到数据库 0。不同的数据库之间数据是隔离的。

常见的连接错误

  • Connection refused：最常见的错误，表示客户端无法连接到指定的主机和端口。可能原因：
    • Redis 服务器未运行。
    • 防火墙阻止了连接。
    • 指定的主机或端口不正确。
    • Redis 服务器被配置为只监听特定 IP 地址（例如 bind 127.0.0.1），而客户端试图从其他 IP 连接。
  • AUTH failed：密码不正确或未提供密码，但服务器要求密码。
  • Timeout：连接超时，可能是网络延迟高，或者服务器负载过重。

总结

连接 Redis 是使用它的基础。通过 redis-cli，您可以快速进行测试和管理；通过编程语言客户端，您可以将 Redis 无缝集成到您的应用程序中。理解连接参数和常见的错误，将帮助您更顺利地开始 Redis 之旅。

现在您已经掌握了连接 Redis 的基本方法，是时候深入探索 Redis 丰富的数据结构和强大功能了！

滚动至顶部