Поделиться через

Использование внешнего кэша, совместимого с Redis, в службе управления API Azure

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

Помимо использования встроенного кэша Azure Управление API позволяет кэширование ответов во внешнем кэше, совместимом с Redis, например Кэш Azure для Redis или Управляемый Redis Azure.

Использование внешнего кэша позволяет обойти ряд ограничений встроенного кэша:

  • избежать периодического очищения кэша при обновлении службы управления API;
  • получить больший контроль над конфигурацией кэша;
  • кэшировать больше данных, чем позволяет уровень службы управления API;
  • использовать кэширование на уровне "Потребление" службы управления API.
  • включать кэширование в самостоятельно размещенных шлюзах управления API

Дополнительные сведения о кэшировании см. в статьях Политики кэширования в службе "Управление API" и Пользовательское кэширование в службе "Управление API Azure".

Примечание.

В настоящее время эта функция недоступна в рабочих областях.

Из этого руководства вы узнаете, как выполнять такие задачи:

  • Добавление внешнего кэша в службу управления API

Необходимые компоненты

Для работы с этим руководством вам потребуется следующее:

  • Создание экземпляра службы управления API Azure

  • Понимание принципа кеширования в службе управления API Azure

  • Доступны Кэш Azure для Redis, Управляемый Redis azure или другой кэш, совместимый с Redis.

    Внимание

    Azure Управление API использует строка подключения Redis для подключения к кэшу. Если вы используете Кэш Azure для Redis или Управляемый Redis Azure, включите проверку подлинности ключа доступа в кэше для использования строка подключения. В настоящее время невозможно использовать проверку подлинности Microsoft Entra для подключения Azure Управление API к Кэш Azure для Redis или Управляемому Redis Azure.

Кэш Redis для Kubernetes

Для локального шлюза Управление API кэширование требует внешнего кэша. Чтобы кэширование было эффективным, самостоятельно размещенный шлюз и используемый им кэш должны располагаться рядом друг с другом, чтобы задержки при поиске и сохранении данных были минимальными. Лучше всего развертывать кэш Redis в том же кластере Kubernetes или в отдельном кластере поблизости. Узнайте, как развернуть кэш Redis в кластере Kubernetes.

Добавление внешнего кэша

Выполните описанные ниже действия, чтобы добавить внешний кэш, совместимый с Redis, в службу управления API Azure. Кэш можно ограничить определенным шлюзом в экземпляре службы управления API.

На снимке экрана показано, как добавить внешний Кэш Azure для Redis в службу управления API Azure.

Параметр "Использовать из"

Параметр Использовать из в конфигурации задает расположение экземпляра службы управления API, который будет использовать кэш. Выберите один из следующих вариантов.

  • Регион Azure, в котором размещен экземпляр службы управления API (или одно из настроенных расположений в случае развертывания в нескольких регионах)

  • Расположение самостоятельно размещенного шлюза

  • По умолчанию, чтобы настроить кэш как значение по умолчанию для всех расположений шлюза в экземпляре службы управления API

    Кэш, используемый для default, переопределяется кэшом, используемым для определенного соответствующего региона или расположения.

    Например, рассмотрим экземпляр службы управления API, размещенный в регионах "Восток США", "Юго-Восточная Азия" и "Западная Европа". Настроено два кэша, один— для значения По умолчанию, а другой — для Юго-Восточной Азии. В этом примере Управление API в Юго-Восточной Азии использует собственный кэш, а в других двух регионах используется запись кэша по умолчанию.

Примечание.

Можно настроить один и тот же внешний кэш для нескольких экземпляров службы управления API. Экземпляры службы управления API могут находиться в одном или разных регионах. При совместном использовании кэша для нескольких экземпляров необходимо выбрать значение По умолчанию для параметра Использовать из.

Добавление экземпляра Кэш Azure для Redis или Управляемого Redis Azure из одной подписки

  1. Перейдите к экземпляру службы управления API на портале Azure.
  2. В меню слева в разделе "Развертывание и инфраструктура " выберите внешний кэш.
  3. Выберите Добавить.
  4. В раскрывающемся списке экземпляра кэша выберите кэш.
  5. В раскрывающемся списке "Использовать" выберите "По умолчанию " или укажите нужный регион. Строка подключения автоматически заполняется.
  6. Выберите Сохранить.

Добавление совместимого с Redis кэша, размещенного вне текущей подписки Azure или полностью за пределами Azure

  1. Перейдите к экземпляру службы управления API на портале Azure.
  2. В меню слева в разделе "Развертывание и инфраструктура " выберите внешний кэш.
  3. Выберите Добавить.
  4. В раскрывающемся списке экземпляра кэша выберите "Настраиваемый".
  5. В раскрывающемся списке "Использовать" выберите "По умолчанию " или укажите нужный регион.
  6. Введите Кэш Azure для Redis, управляемый Redis или строка подключения кэш, совместимый с Redis, или кэш, совместимый с Redis, в поле строки подключения.
  7. Выберите Сохранить.

Добавление кэша Redis к локальному шлюзу

  1. В меню слева в разделе "Развертывание и инфраструктура " выберите внешний кэш.
  2. Выберите Добавить.
  3. В раскрывающемся списке экземпляра кэша выберите "Настраиваемый".
  4. В раскрывающемся списке "Использовать" выберите "По умолчанию " или укажите нужный регион.
  5. Введите кэш Redis строка подключения в поле строки подключения.
  6. Выберите Сохранить.

Использование внешнего кэша

После добавления кэша, совместимого с Redis, настройте политики кэширования, чтобы включить кэширование ответов или кэширование значений по ключу во внешний кэш.

Подробный пример см. в разделе Добавление кэширования в службу управления API Azure для повышения эффективности.

Связанный контент