การใช้งาน redis-cli

redis-cli — Redis client มาตรฐาน

redis-cli คือ command-line interface ที่มาพร้อมกับทุกการติดตั้ง Redis (และมีให้ใช้งานภายใน official Docker image) รองรับสองโหมด: interactive (REPL prompt แบบสด) และ inline (คำสั่งเดียวที่ส่งตรงจาก shell)

ตัวเลือกการเชื่อมต่อ

Flag ที่ใช้บ่อยที่สุด:

Flag	ค่าเริ่มต้น	วัตถุประสงค์
`-h host`	`127.0.0.1`	hostname หรือ IP ของ Redis server
`-p port`	`6379`	port ของ Redis server
`-n db-number`	`0`	เลือกหมายเลข database (0–15) เมื่อเชื่อมต่อ

# เชื่อมต่อกับ host และ port ค่าเริ่มต้น
redis-cli

# เชื่อมต่อแบบระบุชัดเจน — มีประโยชน์เมื่อต้องการ target server ระยะไกล
redis-cli -h 127.0.0.1 -p 6379

# เชื่อมต่อและสลับไปยัง database 1 ทันที
redis-cli -n 1

โหมด Inline vs โหมด Interactive

ในโหมด inline คุณส่งคำสั่งเดียวเป็น argument ให้กับ redis-cli และผลลัพธ์จะถูกพิมพ์ไปยัง stdout — เหมาะสำหรับ script:

redis-cli PING

ในโหมด interactive คุณรัน redis-cli โดยไม่มี command argument และได้รับ prompt 127.0.0.1:6379> ซึ่งคุณสามารถพิมพ์คำสั่งทีละคำสั่งได้

PING — ตรวจสอบการเชื่อมต่อ

PING คือการตรวจสอบที่เบาที่สุดว่า server สามารถเข้าถึงได้:

127.0.0.1:6379> PING
PONG

ส่ง message เพิ่มเติมและ Redis จะส่งกลับมา — มีประโยชน์สำหรับการทดสอบ round-trip latency ใน script:

127.0.0.1:6379> PING "hello world"
"hello world"

ECHO — ส่ง string กลับมา

ECHO คืน argument โดยไม่เปลี่ยนแปลง มีประโยชน์หลักในการทดสอบว่า client encode string ได้ถูกต้อง:

127.0.0.1:6379> ECHO "Hello"
"Hello"

SELECT — สลับ database

Redis มี 16 logical database ที่มีหมายเลข 0 ถึง 15 โดยแชร์ server process และ memory เดียวกัน แต่มี keyspace แยกกันอย่างสมบูรณ์ ค่าเริ่มต้นคือ database 0

127.0.0.1:6379> SELECT 1
OK
127.0.0.1:6379[1]> SET greeting "hi from db1"
OK
127.0.0.1:6379[1]> SELECT 0
OK
127.0.0.1:6379> GET greeting
(nil)

สังเกตว่า prompt เปลี่ยนเป็น 127.0.0.1:6379[1] เมื่อคุณอยู่บน database อื่นที่ไม่ใช่ 0

DBSIZE — นับจำนวน key

DBSIZE คืนจำนวน key ใน database ที่เลือกอยู่ในขณะนี้:

127.0.0.1:6379> DBSIZE
(integer) 5

FLUSHDB — ล้าง database ปัจจุบัน

FLUSHDB ลบทุก key ใน database ปัจจุบัน การกระทำนี้ไม่สามารถย้อนกลับได้ — ใช้เฉพาะใน development หรือ test environment เท่านั้น:

127.0.0.1:6379> FLUSHDB
OK
127.0.0.1:6379> DBSIZE
(integer) 0

HELP แบบ built-in

redis-cli มาพร้อมกับเอกสาร inline ใช้ HELP ตามด้วยชื่อคำสั่งหรือ category tag:

127.0.0.1:6379> HELP SET
127.0.0.1:6379> HELP @string

HELP @string แสดงรายการทุกคำสั่งในกลุ่ม string — วิธีที่รวดเร็วในการค้นพบคำสั่งโดยไม่ต้องออกจาก terminal

PING
ECHO "Hello"
SELECT 1
DBSIZE
SELECT 0

ข้อแลกเปลี่ยน

ตัวเลือก	Benefit	Cost
ใช้ `redis-cli` แบบ interactive	ทดสอบคำสั่งไว เห็นผลลัพธ์ทันที เหมาะกับ debug	ไม่มี connection pooling, retry, หรือ error handling ที่ app จริงต้องการ
ใช้ client library ในโค้ดแอป	จัดการ connection lifecycle, pipelining, retry ให้อัตโนมัติ	เขียนโค้ดเพิ่ม ต้อง import library เข้าโปรเจกต์
สลับ database ด้วย `SELECT`	สะดวกสำหรับแยกข้อมูลชั่วคราวใน dev	ไม่ใช่ multi-tenancy จริง ทุก database ยังแชร์ instance, memory, และ performance เดียวกัน

ข้อผิดพลาดที่พบบ่อย

ใช้ redis-cli เชื่อมต่อ production โดยตรงเพื่อรันคำสั่งแก้ข้อมูล — เสี่ยงพิมพ์ผิดแล้ว FLUSHDB หรือ DEL โดน key จริง ควรใช้ script ที่ผ่าน review หรือ client library แทนเมื่อทำงานกับข้อมูล production
เข้าใจผิดว่า SELECT คือการแบ่ง tenant ที่ปลอดภัย — 16 database logical ยังแชร์ CPU, memory และ FLUSHALL กระทบทุก database พร้อมกัน ไม่เหมาะใช้แทน per-tenant isolation จริง
ใช้ redis-cli เป็นทางเดียวในการต่อกับ Redis จาก application code — ecosystem ที่ดีคือใช้ redis-cli สำหรับ debug/ทดลองเท่านั้น ส่วนโค้ดจริงควรต่อผ่าน client library ที่จัดการ connection pooling และ retry ให้

💡 ตัวอย่างจากของจริง

Stack Overflow — ทีม infra ใช้ redis-cli เพื่อ PING และตรวจสอบ keyspace ของ cache layer หน้า SQL Server เวลามีปัญหา latency ก่อนจะไปดูที่ metrics dashboard

GitHub — วิศวกรใช้ redis-cli ต่อเข้า Redis instance ที่ใช้เก็บ session/cache เพื่อ debug ปัญหาเฉพาะหน้า แต่โค้ด production ทั้งหมดเชื่อมผ่าน client library ไม่ใช่ CLI