使用 Redis 命令列工具搭配 Azure Cache for Redis

使用 redis-cli 命令行工具，以用戶端身分與 Azure Cache for Redis 互動。使用此工具直接與 Azure Cache for Redis 實例互動，以及進行偵錯和疑難解答。

安裝 redis-cli

redis-cli 工具會自動與 Redis 套件一起安裝，可供多個操作系統使用。如需慣用操作系統上最詳細的檔，請參閱開放原始碼安裝 Redis 指南。

redis-cli 以原生方式在 Linux 上執行，而且大部分的發行版都包含包含 redis-cli 工具的 Redis 套件。 例如，在 Ubuntu 上 ，您會使用下列命令安裝 Redis 套件 ：

sudo apt-get update
sudo apt-get install redis

在 Windows 電腦上使用 redis-cli 的最佳方式是安裝 Windows 子系統 Linux 版（WSL）。 Linux 子系統可讓您直接在 Windows 上執行 Linux 工具。若要安裝 WSL，請遵循 WSL 安裝指示。

安裝 WSL 之後，您可以使用您為 WSL 選擇的 Linux 發行版中可用的套件管理來安裝 redis-cli 。

您可以使用下列方法來收集存取快取所需的資訊：

在本節中，您會從 Azure 入口網站擷取密鑰。

若要連線 Azure Cache for Redis 伺服器，快取用戶端需要快取的主機名、埠和密鑰。有些用戶端可能會以稍微不同的名稱來參考這些專案。您可以從 Azure 入口網站取得主機名、埠和金鑰。

若要取得存取金鑰，請從 [資源] 功能選取 [ 驗證 ]。然後，選取 [ 存取金鑰] 索引標籤 。
若要取得快取的主機名和埠，請從 [資源] 功能表中選取 [概觀 ]。主機名的格式為 DNS name.redis.cache.windows.net>。<

在已安裝 Redis 套件的電腦上開啟殼層或終端機。如果使用 WSL，您可以使用 Windows 終端機來開啟 Linux 命令行。使用 redis-cli 連線之前，請先檢查：

是否需要 TLS 存取 - 根據預設，Azure Cache for Redis 實例會針對連線使用 TLS 加密。每當伺服器端使用 TLS 時，必須使用選項來 --tls 啟用 redis-cli 上的 TLS。
使用的連接埠 ─ 所有企業與企業快閃層快取都會使用連接埠 10000。不過，基本、標準和進階版層快取會針對非 TLS 連線使用埠6379或 TLS 連線的埠6380。
快取實例是否使用叢集 - 如果您使用使用叢集的進階版層快取，或是使用 OSS 叢集原則的企業/企業快取，請新增 -c選項以確保可以存取所有分區。

使用下列命令，使用 TLS 連線到基本、標準或進階版層 Azure Cache for Redis 實例：
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
```
連線至不使用 TLS 的基本、標準或進階版層 Azure Cache for Redis 實例：
```
redis-cli.exe -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
```
使用 TLS 和叢集，連線至基本、標準或進階版層 Azure Cache for Redis 實例：
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
```

使用企業叢集原則搭配 TLS，將連線至 Enterprise 或 Enterprise Flash 層快取實例：

redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls

使用不含 TLS 的 OSS 叢集原則，連線企業或企業快取實例：

redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c

建立連線之後，您可以向 Azure Cache for Redis 實例發出命令。測試連線的其中一個簡單方式是使用 PING 命令。此命令會在 PONG 控制台中傳回。

yourcachename.redis.cache.windows.net:6380> PING
PONG

您也可以執行與GET等SET指令：

yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"

您現在已使用 redis-cli 連線到 Azure Cache for Redis 實例。

雖然 redis-cli 是實用的工具，但您可以透過其他方法來連線到快取，以進行疑難解答或測試：

Azure Cache for Redis 提供內建於 Azure 入口網站中的 Redis 控制台，您可以在其中發出命令，而不需要安裝命令行工具。 Redis 主控台功能目前僅適用於基本、標準和進階版層。
RedisInsight 是一個豐富的開放原始碼圖形化工具，可用來發出 Redis 命令及檢視 Redis 實例的內容。它適用於 Azure Cache for Redis，且支援 Linux、Windows 和 macOS。