共用方式為

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

  • 發行項

使用 redis-cli 命令列工具，以用戶端形式與 Azure Cache for Redis 進行互動。 使用此工具直接與 Azure Cache for 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 Cache for Redis 伺服器，快取用戶端需要快取的主機名稱、連接埠和存取金鑰。 某些用戶端可能會使用略有不同的名稱來參考這些項目。 您可以在 Azure 入口網站中取得主機名稱、連接埠和金鑰。

  • 若要取得快取的存取金鑰：

    1. 在 Azure 入口網站中，移至您的快取。
    2. 在服務功能表上的 [設定] 底下，選取 [驗證]。
    3. 在 [驗證] 窗格中，選取 [存取金鑰] 索引標籤。
    4. 若要複製存取金鑰的值，請選取金鑰欄位中的 [複製] 圖示。

    螢幕擷取畫面顯示如何尋找和複製 Azure Cache for Redis 執行個體的存取金鑰。

  • 若要取得快取的主機名稱和連接埠：

    1. 在 Azure 入口網站中，移至您的快取。
    2. 在服務功能表上，選取 [概觀]。
    3. 在 [基本資訊] 底下，針對 [主機名稱]，選取 [複製] 圖示以複製主機名稱值。 主機名稱值的格式為 <DNS name>.redis.cache.windows.net。
    4. 針對 [連接埠]，選取 [複製] 圖示以複製連接埠值。

    螢幕擷取畫面顯示如何尋找和複製 Azure Cache for Redis 執行個體的主機名稱和連接埠。

使用 redis-cli 連線

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

  1. 是否需要 TLS 存取 - 根據預設，Azure Cache for Redis 執行個體會使用 TLS 加密進行連線。 每當在伺服器端上使用 TLS 時，必須使用 --tls 選項啟用 redis-cli 上的 TLS。
  2. 使用的連接埠 - 所有 Enterprise 和 Enterprise Flash 層快取都會使用連接埠 10000。 不過，基本、標準和進階層快取會使用連接埠 6379 進行非 TLS 連線，或使用連接埠 6380 進行 TLS 連線。
  3. 快取執行個體是否使用叢集 - 如果您使用一個使用叢集的進階層快取，或是一個使用 OSS 叢集原則的 Enterprise/Enterprise Flash 快取，請新增 -c 選項，以確保可以存取所有分區。

範例

  1. 使用下列命令，以使用 TLS 連線至基本、標準或進階層 Azure Cache for Redis 執行個體：

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls

  2. 連線至不使用 TLS 的基本、標準或進階層 Azure Cache for Redis 執行個體：

    redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey

  3. 使用 TLS 和叢集連線至基本、標準或進階層 Azure Cache for Redis 執行個體：

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c

  4. 使用 Enterprise 叢集原則搭配 TLS 連線至 Enterprise 或 Enterprise Flash 層快取執行個體：

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

  5. 使用沒有 TLS 的 OSS 叢集原則連線至 Enterprise 或 Enterprise Flash 層快取執行個體：

    redis-cli -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

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

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 替代方案

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

  • Azure Cache for Redis 會提供內建於 Azure 入口網站的 Redis 主控台，您可以在其中發出命令，而不需要安裝命令列工具。 Redis 主控台功能目前僅適用於基本、標準和進階層。
  • RedisInsight 是一種豐富的開放原始碼圖形化工具，用於發出 Redis 命令和檢視 Redis 執行個體的內容。 其可與 Azure Cache for Redis 搭配使用，且在 Linux、Windows 和 macOS 上受到支援。

相關內容

開始建立新的 Enterprise 層快取執行個體。