Entwickeln für Azure Managed Cache Service

Wichtig

Microsoft empfiehlt, alle neuen Entwicklungen azure Redis Cache zu verwenden. Für aktuelle Dokumentation und Anleitungen zur Auswahl eines Azure Cache-Angebots finden Sie unter Welches Azure Cache-Angebot ist für mich richtig?

Managed Cache Service bietet eine Reihe von APIs zum Hinzufügen, Aktualisieren und Entfernen von Elementen aus einem Cache. Die Verwendung der Klassen und Methoden im Microsoft.ApplicationServer.Cache-Namespace ist eine direkte Möglichkeit, mit einem Cache zu interagieren. Im Gegensatz dazu stellt die Verwendung eines der ASP.NET-Anbieter ein indirektes Verfahren dar, einen Cache zu verwenden. Die Themen in diesem Abschnitt umfassen direkte programmgesteuerte Verwendung von Managed Cache Service. Weitere Informationen zu den ASP.NET Anbietern für Managed Cache Service finden Sie unter ASP.NET 4 Cacheanbieter für Azure Managed Cache Service.

Programmiermodell

Das Managed Cache Service Programmiermodell ist für das Zwischenspeicherprogrammierungsmuster konzipiert. Die Daten müssen erneut aus der ursprünglichen Datenquelle in den Cache geladen werden, wenn die Daten nicht im Cache, in der Anwendung oder im verteilten Cache vorhanden sind.

Erwägungen zur cachefremden Programmierung

Entwerfen Sie Anwendungscode so, dass er unabhängig vom Cache funktioniert, damit die Anwendung auch weiterhin ausgeführt werden kann, wenn die zwischengespeicherten Daten nicht verfügbar sind. Da die Persistenz der Daten im Cache nicht dauerhaft ist, besteht die Möglichkeit, dass die Daten im Cache nicht verfügbar sind. Wenn ein Cache z. B. auf ein anderes Cacheangebot skaliert wird, gehen die im Arbeitsspeicher zwischengespeicherten Elemente verloren. Das Anfordern eines Elements, das nicht im Cache vorhanden ist, wird als Cachefehler bezeichnet.

Wenn Sie das feature Managed Cache Service hohe Verfügbarkeit verwenden, können Sicherungskopien von zwischengespeicherten Elementen helfen, computer- und prozessfehler auf einem Cache zu schützen. Selbst wenn Hochverfügbarkeit aktiviert ist, besteht eine geringe Chance, dass alle Cachedaten aufgrund eines schwerwiegenden Zwischenfalls verloren gehen. Elemente, für die Persistenz erforderlich ist, müssen eine Datenbank oder andere Techniken für persistente Speicherung verwenden. Weitere Informationen finden Sie unter "Hohe Verfügbarkeit für Azure Managed Cache Service".

Es gibt viele andere Gründe, aus denen Ihr Code möglicherweise einen Cachefehler auftritt. Beispielsweise ist das Cacheelement möglicherweise abgelaufen oder basierend auf normalen Ablauf- und Entfernungsrichtlinien entfernt worden. Unabhängig von der Ursache muss der Anwendungscode in der Lage sein, auf die ursprüngliche Datenquelle zuzugreifen, um das Element im Cache erneut mit Daten aufzufüllen. Weitere Informationen finden Sie unter Ablauf und Eviction für Azure Managed Cache Service.

Entwicklungsprozess

Es sind einige grundlegende Schritte erforderlich, um mit der Verwendung von Caching in Ihrer Anwendung zu beginnen.

  1. Erstellen eines Caches.

  2. Konfigurieren Sie die Clients für die Verwendung des Cache.

  3. Verwenden Sie die Managed Cache Service-API, um den Cache zu verwenden.

Erstellen eines Caches

Caches in Managed Cache Service werden mithilfe von Powershell-Cmdlets erstellt und dann im Azure Management Portal verwaltet. Anleitungen zum Erstellen eines Caches finden Sie unter How to: Create a Cache for Azure Managed Cache Service.

Konfigurieren der Clients

Sie müssen Ihre Anwendung, die auch als Cacheclient bezeichnet wird, für die Verwendung des Caches konfigurieren. Dies umfasst zwei Schritte:

  1. Verweisen Sie auf die Managed Cache Service Assemblys in Ihrem Visual Studio Projekt.

  2. Verwenden Sie Konfigurationsdateieinstellungen oder Code, um den Zugriff auf den Cache zu konfigurieren.

Managed Cache Service bietet ein Zwischenspeicherungspaket NuGet Paket, das die Assemblybezüge hinzufügt und die erforderliche Konfiguration in die web.config oder app.config Datei Ihres Projekts einfügt. Nachdem Sie das NuGet-Paket Cache installiert haben, bearbeiten Sie die neu hinzugefügte Konfiguration und geben den Cacheendpunkt sowie den Zugriffsschlüssel an. Schrittweise Anleitungen finden Sie in der Vorgehensweise: Konfigurieren eines Cacheclients für Azure Managed Cache Service.

Verwenden der Cache Service-API

Der letzte Schritt besteht im Verwenden des Caches in Ihrem Anwendungscode. Dies kann auf zwei Arten erfolgen:

Um direkt auf den Cache im Code zuzugreifen, verwenden Sie die DataCacheFactoyConfiguration-, DataCacheFactory- und DataCache-Klassen in der Managed Cache Service-API. Im folgenden Beispiel wird veranschaulicht, wie Sie eine Zeichenfolge im Cache mithilfe der Einstellungen aus default dem defaultdataCacheClient Abschnitt der Anwendungskonfigurationsdatei hinzufügen und abrufen.

// Cache client configured by settings in application configuration file.
DataCacheFactoryConfiguration config = new DataCacheFactoryConfiguration("default");
DataCacheFactory cacheFactory = new DataCacheFactory(config);
DataCache defaultCache = cacheFactory.GetDefaultCache();    

// Put and retrieve a test object from the default cache.
defaultCache.Put("testkey", "testobject");
string strObject = (string)defaultCache.Get("testkey");
' Cache client configured by settings in application configuration file.
Dim config As New DataCacheFactoryConfiguration("default")
Dim cacheFactory As New DataCacheFactory(config)
Dim defaultCache As DataCache = cacheFactory.GetDefaultCache()

' Put and retrieve a test object from the default cache.
defaultCache.Put("testkey", "testobject")
Dim strObject As String = defaultCache.Get("testkey")

Sie können auch über Überladungen des DataCache-Konstruktors auf den benannten Cache und den Konfigurationsdateiabschnitt zugreifen. Das folgende Codebeispiel ist hinsichtlich der Funktion mit dem vorherigen Beispiel identisch.

// Cache client configured by settings in application configuration file.
DataCache defaultCache = new DataCache("default", "default");

// Put and retrieve a test object from the default cache.
defaultCache.Put("testkey", "testobject");
string strObject = (string)defaultCache.Get("testkey");
' Cache client configured by settings in application configuration file.
Dim defaultCache As New DataCache("default", "default")

' Put and retrieve a test object from the default cache.
defaultCache.Put("testkey", "testobject")
Dim strObject As String = defaultCache.Get("testkey")

Hinweis

Das oben aufgeführte Beispiel funktioniert nicht in den Überladungen der Methode RoleEntryPoint. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen eines DataCache-Objekts in RoleEntryPoint-Methoden für Azure Managed Cache Service.

Zusätzlich zur Verwendung der Managed Cache Service-API zum Zugriff auf einen Cache wird im Abschnitt "Verwenden von Azure Managed Cache Service" bereitgestellt.

Vollständige Beispiele, die Managed Cache Service veranschaulichen, finden Sie unter Azure Managed Cache Service Beispiele.

In diesem Abschnitt

Weitere Informationen

Konzepte

Vorgehensweise: Erstellen eines Caches für Azure Managed Cache Service

Weitere Ressourcen

Azure Managed Cache Service