通過redis-cli串連並操作Redis資料庫 - ApsaraDB for Redis

redis-cli是原生Redis內建的命令列工具，您可以在ECS執行個體或本地裝置上通過redis-cli串連ApsaraDB for Redis管理Redis資料庫。本文介紹安裝redis-cli及通過redis-cli串連Redis執行個體的操作步驟以及常見的串連報錯。

快速瞭解串連Redis執行個體流程

串連Redis執行個體的流程

操作流程	說明
1. 設定Redis帳號密碼。	選擇以下任意方式：設定Redis預設帳號的密碼，具體操作，請參見修改或重設密碼。建立新的帳號密碼，具體操作，請參見建立與管理帳號。
2. 添加白名單。	根據不同裝置確定串連的網路類型，並將對應網路IP地址添加至Redis執行個體中。 ECS執行個體（推薦）：推薦使用 Virtual Private Cloud。請確保ECS執行個體與Redis執行個體屬於同一專用網路，並將ECS執行個體的私網IP地址添加至Redis執行個體的白名單中。說明如果ECS執行個體與Redis執行個體不屬於同一專用網路（例如ECS執行個體與Redis執行個體為不同地區），可將ECS執行個體的公網IP地址添加至Redis執行個體的白名單中，並通過ECS公網串連Redis執行個體的公網串連地址。本地裝置：可使用公網。將本地裝置的公網IP地址添加至Redis執行個體的白名單中。關於添加白名單的具體操作，請參見設定IP白名單。
3. 擷取Redis串連資訊。	使用專用網路串連時：在Redis控制台，擷取該執行個體的專用網路串連地址。使用公網串連時：在Redis控制台，申請並擷取該執行個體的公網串連地址。說明 Redis執行個體預設僅提供專用網路串連地址，通過公網串連時您需要手動申請公網串連地址。具體操作，請參見查看串連地址。
4. 使用redis-cli串連Redis執行個體。	在redis-cli解壓目錄下執行相關命令。串連命令：`redis-cli -h hostname -p port` 串連命令樣本：`redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379` 密碼命令：`AUTH user:password` 密碼命令樣本：`AUTH testaccount:Rp829dlwa` 具體操作，請參見本文步驟二：redis-cli串連Redis。

步驟一：安裝redis-cli

安裝redis-cli的操作步驟

在ECS執行個體或本地裝置上，安裝Redis會同步安裝redis-cli。通過redis-cli串連時，redis-cli的版本無需與ApsaraDB for Redis執行個體版本相同。

登入待安裝redis-cli的裝置，例如ECS執行個體或本地裝置。
下載、安裝redis-cli。
- Linux
  1. 執行下述命令，安裝gcc依賴環境。
```
sudo yum -y install gcc
```
  2. 執行下述命令下載Redis源碼檔案。
```
wget https://download.redis.io/releases/redis-7.0.0.tar.gz
```
    說明
    本文以redis-7.0.0版本為例示範操作流程，您也可以安裝其他版本。具體操作，請參見Redis官網。
  3. 執行下述命令解壓Redis源碼檔案。
```
tar xzf redis-7.0.0.tar.gz
```
  4. 執行下述命令進入解壓後的目錄並編譯安裝Redis源碼檔案：
```
cd redis-7.0.0&&make
```
    說明
    編譯安裝需要一段時間（通常為2分鐘~3分鐘）。
- Windows
  目前僅支援64位的Windows系統。
  1. 下載Redis-x64-3.2.100.zip檔案。
    說明
    本文以redis-3.2版本為例示範操作流程，您也可以安裝其他版本。更多資訊，請參見MicrosoftArchive-Redis。
  2. 將Redis-x64-3.2.100.zip解壓至待安裝的目錄。

步驟二：redis-cli串連Redis

進入redis-cli安裝目錄下。
- Windows：開啟命令列視窗，進入redis-cli所屬的目錄。
- Linux：進入..\redis-7.0.0\src所屬的目錄，例如cd /home/redis-7.0.0/src。

執行下述命令通過redis-cli串連Redis執行個體：

./redis-cli -h hostname -p port [-c]

說明

在Windows中使用PowerShell啟動redis-cli的命令為.\redis-cli -h hostname -p port [-c]。

表 1. 參數說明

參數	說明	擷取方式
hostname	Redis執行個體的串連地址	通過專用網路串連：需擷取Redis執行個體的專用網路串連地址。通過公網串連：需擷取Redis執行個體的公網串連地址。具體操作，請參見查看串連地址。
port	Redis執行個體的連接埠號碼	連接埠號碼預設為6379，您也可以自訂連接埠號碼。具體操作，請參見修改串連地址或連接埠。
-c	啟用叢集模式	該模式僅當Redis執行個體為叢集架構，且使用直連地址串連時可用。

串連樣本：

預設地址（適用於通過預設地址串連的情境，例如標準架構執行個體的串連地址或叢集架構執行個體的Proxy 位址）：
```
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379
```
叢集架構直連地址（適用於叢集架構通過直連地址串連的情境）：
```
./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379 -c
```

執行下述命令完成密碼驗證：

AUTH password

表 2. 參數說明

參數

說明

password

填寫帳號、密碼：

使用預設帳號（以執行個體ID命名的帳號）：直接填寫密碼即可。
使用新建立的帳號：密碼格式為user:password。例如自訂帳號為testaccount，密碼為Rp829dlwa，密碼需填寫為testaccount:Rp829dlwa。

說明

如果忘記或未設定密碼，您可以重設密碼。具體操作，請參見修改或重設密碼。
如果執行個體已開啟專用網路免密訪問，通過專用網路串連Redis執行個體時無需執行本步驟即可執行Redis命令。

樣本：

AUTH testaccount:Rp829dlwa

顯示OK表示已成功串連Redis執行個體，可執行Redis命令。

如果出現報錯，請參見常見報錯。
關於KVStore for Redis支援的命令，請參見Redis命令支援概覽。

常見報錯

說明

如果執行個體的小版本過低，報錯資訊可能與下表不一致，建議將執行個體升級至最新的小版本。具體操作，請參見升級小版本與代理版本。

報錯資訊	原因及解決方案
`(error) ERR illegal address`	未設定正確的白名單，請參見快速瞭解串連Redis執行個體流程設定正確的白名單。
`(error) ERR client ip is not in whitelist`	未設定正確的白名單，請參見快速瞭解串連Redis執行個體流程設定正確的白名單。
`(error) ERR invalid password` `(error) WRONGPASS invalid username-password pair`	密碼錯誤，請使用正確的密碼和密碼格式。根據選取帳號的不同，密碼格式有一定區別。預設帳號（以執行個體ID命名的帳號）：直接填寫密碼即可。新建立的帳號：密碼格式為`user:password`。例如自訂帳號為`testaccount`，密碼為`Rp829dlwa`，密碼需填寫為`testaccount:Rp829dlwa`。說明如果通過第三方資料庫管理工具（例如RDM等）串連Redis執行個體，請在密碼框中輸入`user:password`進行串連。如果忘記密碼，您可以重設密碼。具體操作，請參見修改或重設密碼。