如何通過redis-cli串連Tair - Tair

redis-cli是原生Redis內建的命令列工具，您可以在ECS執行個體或本地裝置上通過redis-cli串連雲原生記憶體資料庫Tair，進行資料管理。

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

操作流程	說明
1. 設定Tair帳號密碼。	選擇以下任意方式：設定Tair預設帳號的密碼，具體操作，請參見修改或重設密碼。建立新的帳號密碼，具體操作，請參見建立與管理帳號。
2. 添加白名單。	根據不同裝置確定串連的網路類型，並將對應網路IP地址添加至Tair執行個體中。 ECS執行個體（推薦）：推薦使用 Virtual Private Cloud。請確保ECS執行個體與Tair執行個體屬於同一專用網路，並將ECS執行個體的私網IP地址添加至Tair執行個體的白名單中。說明如果ECS執行個體與Tair執行個體不屬於同一專用網路（例如ECS執行個體與Tair執行個體為不同地區），可將ECS執行個體的公網IP地址添加至Tair執行個體的白名單中，並通過ECS公網串連Tair執行個體的公網串連地址。本地裝置：可使用公網。將本地裝置的公網IP地址添加至Tair執行個體的白名單中。關於添加白名單的具體操作，請參見設定白名單。
3. 擷取Redis串連資訊。	使用專用網路串連時：在Tair控制台，擷取該執行個體的專用網路串連地址。使用公網串連時：在Tair控制台，申請並擷取該執行個體的公網串連地址。說明 Tair執行個體預設僅提供專用網路串連地址，通過公網串連時您需要手動申請公網串連地址。具體操作，請參見查看串連地址。
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` 具體操作，請參見本文操作步驟。

操作步驟

登入ECS執行個體，下載、安裝redis-cli。
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分鐘）。
5. 執行下述命令進入src目錄，準備串連執行個體。
```
cd src
```

擷取串連資訊，並在命令列視窗執行下述命令串連Tair執行個體。

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

表 1. 參數說明

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

串連樣本：

預設地址（適用於通過預設地址串連的情境，例如標準架構執行個體的串連地址或叢集架構執行個體的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

填寫帳號、密碼：

使用預設帳號：直接填寫密碼即可。例如執行個體預設帳號為r-bp1zxszhcgatnx****，自訂密碼為Password21，密碼驗證命令為AUTH Password21。
使用新建立的帳號：密碼格式為user:password。例如自訂帳號為testaccount，密碼為Rp829dlwa，密碼驗證命令為AUTH testaccount:Rp829dlwa。

說明

如果忘記或未設定密碼，您可以重設密碼。具體操作，請參見修改或重設密碼。
如果通過第三方資料庫管理工具（例如RDM等）串連Tair執行個體，請在密碼框中輸入user:password進行串連，請不要在使用者名稱框中輸入任何資訊，否則會導致串連失敗。
如果執行個體已開啟專用網路免密訪問，通過專用網路串連Tair執行個體時無需執行本步驟即可執行Tair命令。

樣本：

AUTH testaccount:Rp829dlwa

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

常見串連報錯

說明

如果執行個體的小版本過低，報錯資訊可能不準確，建議將執行個體升級至最新的小版本。具體操作，請參見升級小版本。

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