共用方式為

搭配 Azure 受控 Redis 使用 Redis 命令行工具 （預覽）

  • 發行項

使用 redis-cli 命令行工具，以用戶端身分與 Azure 受控 Redis 互動（預覽版）。 使用此工具直接與 Azure 受控 Redis 實例互動，並進行偵錯和疑難解答。

安裝 redis-cli

redis-cli 工具會自動與「Redis 套件」一起安裝，該套件適用於多個作業系統。 如需有關您慣用作業系統的最詳細文件，請參閱開放原始碼安裝 Redis 指南。

Linux

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

sudo apt-get update
sudo apt-get install redis

Windows

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

一旦安裝了 WSL，您就可以使用您為 WSL 選擇的 Linux 發行版本中提供的任何套件管理，來安裝 redis-cli。

收集快取存取資訊

您可以使用這些方法，收集存取快取所需的資訊：

在本節中，您將從 Azure 入口網站來擷取金鑰。

從 Azure 入口網站擷取主機名稱、連接埠和存取金鑰

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

  • 若要取得存取金鑰，請從 [資源] 功能表中選取 [驗證]。 然後，選取 [存取金鑰] 索引標籤。

    顯示 Azure Cache for Redis 存取金鑰的螢幕快照。

  • 若要取得快取的主機名稱和連接埠，請從 [資源] 功能表選取 [概觀]。 主機名稱的格式為 <DNS 名稱>.redis.cache.windows.net。

    顯示 Azure Cache for Redis 屬性的螢幕快照。

使用 redis-cli 連線

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

  1. 是否需要 TLS 存取 - 根據預設，Azure 受控 Redis 實例會使用 TLS 加密進行連線。 每當在伺服器端上使用 TLS 時，必須使用 --tls 選項啟用 redis-cli 上的 TLS。
  2. 使用的連接埠 ─ 所有 Azure 受控 Redis 實體都會使用連接埠 10000。 請注意，這與 Redis 社群版本的預設值不同，也就是 6379。
  3. 快取實例是否使用 OSS 叢集原則 - 如果您使用 OSS 叢集原則，請新增 -c選項以確保可以存取所有分區。

範例

  1. 使用企業叢集原則搭配 TLS 連線到 Azure 受控 Redis 實例：

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls

  2. 使用 OSS 叢集原則和 TLS 連線到 Azure 受控 Redis 實例：

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c

測試連線

建立連線之後，您就可以對 Azure 受控 Redis 實例發出命令。 測試連線的簡單方式是使用 PING 命令。 此命令會在主控台中傳回 PONG。

yourcachename.region.redis.azure.net:10000> PING
PONG

您也可以執行 SET 和 GET 等命令：

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

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

redis-cli 替代方案

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

  • RedisInsight 是一種豐富的開放原始碼圖形化工具，用於發出 Redis 命令和檢視 Redis 執行個體的內容。 它可與 Azure 受控 Redis 搭配運作，且支援 Linux、Windows 和 macOS。

相關內容

開始建立 新的 Azure 受控 Redis 實例 。