快速入門：在 Node.js 中使用 Azure Cache for Redis

發行項
04/07/2024

在本快速入門中，您會將 Azure Cache for Redis 納入Node.js應用程式中，以存取可從 Azure 內任何應用程式存取的安全專用快取。

必要條件

Azure 訂用帳戶 - 建立免費帳戶
node_redis，您可以使用命令 npm install redis進行安裝。

如需使用其他Node.js用戶端的範例，請參閱 Node.js Redis 用戶端所列 Node.js客戶端的個別檔。

建立快取

若要建立快取，請登入 Azure 入口網站，然後選取 [建立資源]。
在 [新增] 頁面上選取 [資料庫]，然後選取 [Azure Cache for Redis]。

在 [新的 Redis 快取] 頁面上，設定新快取的設定。

設定	選擇值	描述
訂用帳戶	下拉並選取您的訂用帳戶。	這個新的 Azure Cache for Redis 執行個體建立所在的訂用帳戶。
資源群組	下拉並選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
DNS 名稱	輸入唯一名稱。	快取名稱必須為介於 1 到 63 個字元之間的字串，而且只能包含數字、字母或連字號。名稱的開頭和結尾必須是數字或字母，且不可包含連續的連字號。快取執行個體的「主機名稱」為「<DNS 名稱>.redis.cache.windows.net」。
地點	下拉並選取位置。	選取其他要使用快取之服務附近的區域。
快取類型	使用下拉式選單並選取階層。	階層會決定快取可用的大小、效能和功能。如需詳細資訊，請參閱 Azure Cache for Redis 概觀。

選取 [網路] 索引標籤，或選取頁面底部的 [網路] 按鈕。
在 [網路功能] 索引標籤中，選取您的連線方法。
選取 [下一步: 進階] 索引標籤，或選取頁面底部的 [下一步: 進階] 按鈕以查看 [進階] 索引標籤。
- 針對基本或標準快取，切換適用於非 TLS 連接埠的選取項目。如果您想要啟用 Microsoft Entra 驗證，也可以選取。
- 針對進階快取，設定適用於非 TLS 連接埠、叢集、受控識別和資料持續性的設定。如果您想要啟用 Microsoft Entra 驗證，也可以選取。
選取 [下一步: 標記] 索引標籤，或選取頁面底部的 [下一步: 標記] 按鈕。
在 [標記] 索引標籤中，如果您想要分類資源，可以選擇性地輸入名稱和值。
選取 [檢閱 + 建立]。您會移至 [檢閱 + 建立] 索引標籤，Azure 會在其中驗證您的設定。
出現綠色的「通過驗證」訊息之後，請選取 [建立]。

建立快取需要一些時間。您可以在 Azure Cache for Redis 的 [概觀] 頁面上監視進度。當 [狀態] 顯示為 [執行中] 時，表示快取已可供使用。

從 Azure 入口網站擷取主機名、埠和存取密鑰

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

若要取得存取金鑰，請從快取左側導覽中 選取 [存取密鑰]。
若要取得主機名和埠，請從快取左側導覽中選取 [ 屬性]。主機名的格式為 DNS name.redis.cache.windows.net>。<

新增主機名和主要存取金鑰的環境變數。從程式代碼使用這些變數，而不是直接在程式碼中包含敏感性資訊。

set AZURE_CACHE_FOR_REDIS_HOST_NAME=contosoCache
set AZURE_CACHE_FOR_REDIS_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

連線到快取

最新組建的 node_redis提供數個連線選項的支援。請勿為程式代碼中的每個作業建立新的連線。相反地，請盡可能重複使用連線。

建立新的Node.js應用程式

建立名為 redistest.js 的新腳本檔案。
使用命令來安裝 redis 套件。
```
`npm install redis`
```

將下列範例 JavaScript 新增至檔案。

const redis = require("redis");

// Environment variables for cache
const cacheHostName = process.env.AZURE_CACHE_FOR_REDIS_HOST_NAME;
const cachePassword = process.env.AZURE_CACHE_FOR_REDIS_ACCESS_KEY;

if(!cacheHostName) throw Error("AZURE_CACHE_FOR_REDIS_HOST_NAME is empty")
if(!cachePassword) throw Error("AZURE_CACHE_FOR_REDIS_ACCESS_KEY is empty")

async function testCache() {

    // Connection configuration
    const cacheConnection = redis.createClient({
        // rediss for TLS
        url: `rediss://${cacheHostName}:6380`,
        password: cachePassword
    });

    // Connect to Redis
    await cacheConnection.connect();

    // PING command
    console.log("\nCache command: PING");
    console.log("Cache response : " + await cacheConnection.ping());

    // GET
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.get("Message"));

    // SET
    console.log("\nCache command: SET Message");
    console.log("Cache response : " + await cacheConnection.set("Message",
        "Hello! The cache is working from Node.js!"));

    // GET again
    console.log("\nCache command: GET Message");
    console.log("Cache response : " + await cacheConnection.get("Message"));

    // Client list, useful to see if connection list is growing...
    console.log("\nCache command: CLIENT LIST");
    console.log("Cache response : " + await cacheConnection.sendCommand(["CLIENT", "LIST"]));

    // Disconnect
    cacheConnection.disconnect()

    return "Done"
}

testCache().then((result) => console.log(result)).catch(ex => console.log(ex));

此程式代碼會示範如何使用快取主機名和密鑰環境變數連線到 Azure Cache for Redis 實例。程序代碼也會在快取中儲存和擷取字串值。 PING也會執行和 CLIENT LIST 命令。如需搭配 node_redis 用戶端使用 Redis 的更多範例，請參閱 https://redis.js.org/。

使用 Node.js 執行腳本。
```
node redistest.js
```

範例輸出。

Cache command: PING
Cache response : PONG

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: SET Message
Cache response : OK

Cache command: GET Message
Cache response : Hello! The cache is working from Node.js!

Cache command: CLIENT LIST
Cache response : id=10017364 addr=76.22.73.183:59380 fd=221 name= age=1 idle=0 flags=N db=0 sub=0 psub=0 multi=-1 qbuf=26 qbuf-free=32742 argv-mem=10 obl=0 oll=0 omem=0 tot-mem=61466 ow=0 owmem=0 events=r cmd=client user=default numops=6

Done

清除資源

如果您繼續進行下一個教學課程，可以保留在本快速入門中建立的資源，並重複使用它們。否則，如果您已完成快速入門範例應用程式，您可以刪除本快速入門中建立的 Azure 資源，以避免產生費用。

重要

刪除資源群組是無法復原的，而且資源群組及其中的所有資源都會永久刪除。請確定您不會不小心刪除錯誤的資源群組或資源。如果您已建立資源，以將這個範例裝載於包含您想要保留之資源的現有資源群組內，您可以個別刪除每個資源，而不是刪除資源群組。

登入 Azure 入口網站，然後選取 [資源群組]。
在 [ 依名稱篩選] 文本框中，輸入資源群組的名稱。本文的指示使用了名為 TestResources 的資源群組。在結果清單中的資源群組上，選取 [...]，然後刪除資源群組。
確認刪除資源群組。輸入您資源群組的名稱以進行確認，然後選取 [刪除]。
幾分鐘后，資源群組及其所有自主資源都會被刪除。