本文將協助你選擇並使用最適合 Azure Managed Redis 的用戶端函式庫。 你會學會該用哪些函式庫來搭配你的程式語言，如何處理叢集政策，並避免常見的連線問題。
Azure Managed Redis 是以熱門的記憶體內部資料存放區 Redis 為基礎。 於許多程式設計語言的 Redis 用戶端都可以存取 Azure Managed Redis。 每個用戶端程式庫都有自己的 API，可使用 Redis 命令呼叫 Redis 伺服器，但用戶端程式庫的建置目的是與任何 Redis 伺服器進行通訊。
每個用戶端程式庫都維護自己的參考文件。 這些程式庫還提供相關連結，可讓使用者取得來自用戶端程式庫開發人員社群的支援。 Azure Managed Redis 團隊不負責任何用戶端程式庫的開發或支援。
為了支援和回答您的問題，我們以熱門程度以及是否有活躍的線上社群為基礎，提供以下建議。 僅建議您使用最新可用的版本，並在新版本可供使用時定期升級。 這些程式庫在作用中開發中，而且通常會發行具備可靠性和效能改善的新發行版本。
| 用戶端程式庫 | 語言 | GitHub存放庫 | 文件 |
|---|---|---|---|
| StackExchange.Redis | C#/.NET | StackExchange.Redis GitHub | StackExchange.Redis 文件 |
| 生菜 | JAVA | Lettuce GitHub | Lettuce 文件 |
| Jedis | JAVA | Jedis GitHub | Jedis 文件 |
| node_redis | Node.js | node_redis GitHub | node_redis 文件 |
| ioredis | Node.js | ioredis GitHub | ioredis API 參考文件 |
備註
你的應用程式可以使用任何相容於開源 Redis 的客戶端函式庫來連接你的 Azure Managed Redis 實例。
根據您的叢集原則選擇正確的用戶端程式庫
Azure Managed Redis 支援企業叢集原則和 OSS 叢集原則。 請在此處查看更多資訊 (新增叢集原則資訊的連結)。
所有用戶端程式庫都可以透過企業叢集原則與您的 Redis 執行個體搭配使用。 不過，如果你使用 OSS 叢集政策，請確保所選客戶端函式庫支援連接叢集 Redis 實例。
封鎖的命令
Microsoft 管理 Azure Managed Redis 執行個體的組態和管理，依預設停用以下命令。 如需封鎖命令的詳細資訊，請參閱叢集管理命令相容性
多鍵命令
由於 AMR 執行個體使用叢集設定，您可能會在執行多鍵操作的命令時看到 CROSSSLOT 例外狀況。 具體行為會隨著使用的叢集原則而不同。 如果您使用 OSS 叢集原則，多鍵命令會要求所有索引鍵都對應至相同的雜湊位置。
您也可能看到企業叢集原則出現 CROSSSLOT 錯誤。 企業叢集的位置間僅允許使用下列多鍵命令：DEL、MSET、MGET、EXISTS、UNLINK 和 TOUCH。
在主動-主動資料庫中，只能對位於相同位置的索引鍵執行多鍵寫入命令 (DEL、MSET、UNLINK)。 不過，在主動-主動資料庫中的位置間允許使用下列多鍵命令：MGET、EXISTS 和 TOUCH。 如需詳細資訊，請參閱資料庫叢集。
企業叢集原則封鎖的命令
- CLUSTER INFO
- CLUSTER HELP
- CLUSTER KEYSLOT
- 叢集節點
- CLUSTER SLOTS
作用中異地複寫封鎖的命令
- FLUSHALL
- FLUSHDB
用戶端程式庫特定的指引
選擇你的程式語言以獲得詳細的最佳實務與連線指引：
- StackExchange.Redis （.NET） 最佳實務
- Lettuce（Java）最佳實踐
- Jedi（Java）最佳實務
- Node.js 最佳實務
- PHP 最佳實務
- HiRedisCluster 最佳實務
用戶端程式庫的使用方式
除了參考文件之外，您還可以找到介紹如何使用不同語言和快取用戶端開始使用 Azure Managed Redis 的教學課程。
如需在教學課程詳細了解如何使用其中部分用戶端程式庫，請參閱以下文章：
- 撰寫 .NET Framework 應用程式的程式碼
- 撰寫 .NET Core 應用程式的程式碼
- 撰寫 ASP.NET Web 應用程式的程式碼
- 撰寫 ASP.NET Core Web 應用程式的程式碼
- 撰寫 Java 應用程式的程式碼
- 撰寫 Node.js 應用程式的程式碼
- 撰寫 Python 應用程式的程式碼