Konfigurationsmodell in Azure-In-Role Cache

Wichtig

Microsoft empfiehlt, alle neuen Entwicklungen azure Redis Cache zu verwenden. Aktuelle Dokumentation und Anleitung zum Auswählen eines Azure Cache-Angebots finden Sie unter Welches Azure Cache-Angebot ist für mich geeignet?

In diesem Thema wird die Verwendung von Konfigurationsdateien im Microsoft Azure Cache behandelt. Zwei Typen von Konfigurationseinstellungen sind verfügbar.

1. Rollenkonfiguration

2. Clientkonfiguration

Rollenkonfiguration

In-Role Cache unterstützt die Möglichkeit, zwischenspeichern innerhalb einer Azure-Rolle zu hosten. Dieser Zwischenspeicherungstyp ist als Teil eines Clouddiensts konfiguriert. In der Regel erfolgt dies in Visual Studio.

Hinweis

Die in diesem Abschnitt beschriebenen Konfigurationseinstellungen gelten nur für rollenbasierte In-Role Cache. Shared Caching unterstützt nur den Zugriff auf den default Cache. Shared Caching unterstützt keine Änderung der Eigenschaften des default Caches.

Um die Konfigurationseinstellungen zu verstehen, ist es hilfreich, diese Einstellungen mit den Benutzeroberflächenoptionen in Visual Studio zu korrelieren. Der folgende Screenshot zeigt einen Teil der Registerkarte Caching des Dialogfelds für die Rolleneigenschaften.

Zusätzlich zum Aktivieren von In-Role Cache können Sie auch einen oder mehrere benannte Caches erstellen. Jeder Cache legt seine eigenen Eigenschaften fest. Der folgende Screenshot zeigt einen Teil der Eigenschaftenregisterkarte Caching.

Diese Optionen der Benutzeroberfläche werden in Konfigurationsdateien gespeichert. Zuerst wird das Cachemodul im Abschnitt "Importe " der Datei "ServiceDefinition.csdef" geladen. Der folgende XML-Codeausschnitt zeigt diese Zeile.

<Import moduleName="Caching" />

Alle anderen In-Role Cacheeinstellungen werden in der Datei ServiceConfiguration.cscfg gespeichert. Das folgende Beispiel zeigt die Einstellungen in der Datei ServiceConfiguration.cscfg für die oben genannte Auswahl auf der Registerkarte Caching.

  <Role name="WebRole1">
    <Instances count="2" />
    <ConfigurationSettings>
      <Setting name="Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString" value="UseDevelopmentStorage=true" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.NamedCaches" value="{&quot;caches&quot;:[{&quot;name&quot;:&quot;NamedCache1&quot;,&quot;policy&quot;:{&quot;eviction&quot;:{&quot;type&quot;:0},&quot;expiration&quot;:{&quot;defaultTTL&quot;:20,&quot;isExpirable&quot;:true,&quot;type&quot;:2},&quot;serverNotification&quot;:{&quot;isEnabled&quot;:true}},&quot;secondaries&quot;:1},{&quot;name&quot;:&quot;NamedCache2&quot;,&quot;policy&quot;:{&quot;eviction&quot;:{&quot;type&quot;:-1},&quot;expiration&quot;:{&quot;defaultTTL&quot;:25,&quot;isExpirable&quot;:true,&quot;type&quot;:1},&quot;serverNotification&quot;:{&quot;isEnabled&quot;:false}},&quot;secondaries&quot;:0}]}" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.Loglevel" value="" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.CacheSizePercentage" value="30" />
      <Setting name="Microsoft.WindowsAzure.Plugins.Caching.ConfigStoreConnectionString" value="UseDevelopmentStorage=true" />
    </ConfigurationSettings>
  </Role>

In dieser Rollenkonfiguration weisen die meisten In-Role Cacheeinstellungen eine einfache Korrelation mit den Optionen auf der Registerkarte " Zwischenspeichern " auf. Die Microsoft.WindowsAzure.Plugins.Caching.NamedCaches Einstellung ist jedoch schwieriger zu lesen. Sie verwendet JSON-Syntax, um die Eigenschaften jedes benannten Cache zu beschreiben. Dabei werden alle doppelten Anführungszeichen durch " ersetzt. Referenz für Rollenkonfigurationseinstellungen finden Sie unter In-Role Cache Role Configuration Einstellungen (ServiceConfiguration.cscfg).

Clientkonfiguration

Ein Cacheclient ist jeder Anwendungscode, der auf einen Azure-Cache zugreift. Im Code ist jeder Cacheclient einem DataCacheFactory-Objekt zugeordnet. Die Factory gibt ein DataCache-Objekt zurück, das verwendet wird, um auf den Cache zuzugreifen. Die tatsächlichen Einstellungen des Cacheclients können aus einer Anwendungskonfigurationsdatei oder einer Datei web.config geladen werden.

Im folgenden Beispiel werden die relevanten Abschnitte veranschaulicht, um einen dataCacheClient-Abschnitt einzurichten, der in einer Konfigurationsdatei benannt default ist. Dies ist spezifisch für rollenbasierte In-Role Cache.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <section name="dataCacheClients" type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" allowLocation="true" allowDefinition="Everywhere" />
  </configSections>
  <dataCacheClients>
    <tracing sinkType="DiagnosticSink" traceLevel="Error" />
    <dataCacheClient name="default">
      <autoDiscover isEnabled="true" identifier="WebRole1" />
    </dataCacheClient>
  </dataCacheClients>
</configuration>

Referenz zu diesen Clientkonfigurationseinstellungen finden Sie unter In-Role Cache Client Configuration Einstellungen (Web.config). Eine exemplarische Vorgehensweise, die zeigt, wie Clients rollenbasierter In-Role Cache konfiguriert werden, finden Sie unter How To: Use Azure SDK In-Role Cache.

Weitere Informationen

Konzepte

Rollencachefunktionen in Azure Cache
Konfigurationseinstellungen des Rollencaches ("ServiceConfiguration.cscfg")
Konfigurationseinstellungen für den Rollencacheclient ("Web.config")