在 Azure API 管理中使用與 Redis 相容的外部快取
適用於:所有 APIM 層
除了使用內建快取之外,Azure API 管理 還允許在外部 Redis 相容的快取中快取回應,例如 Azure Cache for Redis 或 Azure 受控 Redis。
使用外部快取可協助您克服內建快取的一些限制:
- 避免在 API 管理更新期間定期清除快取
- 更充分地掌控您的快取組態
- 快取超出您的 API 管理層所允許的資料
- 使用快取搭配 API 管理的耗用量層
- 在 API 管理自我裝載閘道中啟用快取
如需快取的詳細資訊,請參閱 API 管理快取原則和在 Azure API 管理中自訂快取。
注意
目前,此功能無法在工作區中使用。
您將學到什麼:
- 在 API 管理中新增外部快取
必要條件
若要完成本教學課程,您需要:
有 Azure Cache for Redis、Azure 受控 Redis 或其他 Redis 兼容的快取可供使用。
重要
Azure API 管理 會使用 Redis 連接字串 來連線到快取。 如果您使用 Azure Cache for Redis 或 Azure 受控 Redis,請在快取中啟用存取密鑰驗證,以使用 連接字串。 目前,您無法使用 Microsoft Entra 驗證,將 Azure API 管理 連線到 Azure Cache for Redis 或 Azure 受控 Redis。
Kubernetes 的 Redis 快取
針對 API 管理 自我裝載網關,快取需要外部快取。 為了實現更有效率的快取,自我裝載閘道與其仰賴的快取必須位於鄰近的位置,以有效降低查詢和儲存延遲。 將 Redis 快取部署至相同的 Kubernetes 叢集或附近的其他叢集是最佳的選擇。 了解如何將 Redis 快取部署至 Kubernetes 叢集。
新增外部快取
遵循下列步驟,在 Azure API 管理中新增與 Redis 相容的外部快取。 您可以將快取限制為 API 管理執行個體中的特定閘道。
使用來源設定
設定中的 [使用來源] 設定會指定將使用快取的 API 管理執行個體位置。 選取下列其中一項:
裝載 API 管理執行個體的 Azure 區域 (或如果您有多區域部署,則為其中一個設定位置)
自我裝載閘道位置
預設,將快取設定為 API 管理執行個體中所有閘道位置的預設值
用於 Default 的快取會由用於特定比對區域或位置的快取覆寫。
例如,請考慮裝載於美國東部、東南亞和西歐區域的 API 管理執行個體。 已設定兩個快取,一個用於預設,另一個用於東南亞。 在此範例中,東南亞的 API 管理 會使用自己的快取,而其他兩個區域則使用預設快取專案。
注意
您可以為多個 API 管理執行個體設定相同的外部快取。 API 管理執行個體可以位於相同或不同的區域。 共用多個執行個體的快取時,您必須在 [使用來源] 設定中選取 [預設]。
從相同的訂用帳戶新增 Azure Cache for Redis 或 Azure 受控 Redis 實例
- 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
- 在左側功能表中,於 [部署 + 基礎結構] 底下選取 [外部快取]。
- 選取 [+ 新增]。
- 在 [快 取實例] 下拉式 清單中,選取您的快取。
- 在 [ 從使用] 下拉式清單中,選取 [ 預設值 ] 或指定所需的區域。 [連接字串] 會自動填入。
- 選取儲存。
新增與 Redis 相容的快取,通常裝載於目前 Azure 訂閱或 Azure 外部
- 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
- 在左側功能表中,於 [部署 + 基礎結構] 底下選取 [外部快取]。
- 選取 [+ 新增]。
- 在 [快 取實例] 下拉式 清單中,選取 [ 自定義]。
- 在 [ 從使用] 下拉式清單中,選取 [ 預設值 ] 或指定所需的區域。
- 在 [連接字串] 字段中輸入您的 Azure Cache for Redis、Azure 受控 Redis 或 Redis 兼容快取 連接字串。
- 選取儲存。
將 Redis 快取新增至自我裝載閘道
- 在左側功能表中,於 [部署 + 基礎結構] 底下選取 [外部快取]。
- 選取 [+ 新增]。
- 在 [快 取實例] 下拉式 清單中,選取 [ 自定義]。
- 在 [ 從使用] 下拉式清單中,選取 [ 預設值 ] 或指定所需的區域。
- 在 [連接字串] 字段中輸入您的 Redis 快取 連接字串。
- 選取儲存。
使用外部快取
新增與 Redis 相容的快取之後,請在外部快取中設定快取原則,以啟用回應快取或依索引鍵快取值。
如需詳細範例,請參閱新增快取以改善 Azure API 管理的效能。
相關內容
- 如需快取原則的詳細資訊,請參閱 API 管理原則參考文件中的快取原則。
- 如需使用原則運算式依索引鍵快取項目,請參閱在 Azure API 管理中自訂快取。
- 瞭解如何 啟用 Azure OpenAI API 的語意快取。