Modelo de configuración de Caché en rol de Azure

Importante

Microsoft recomienda todos los nuevos desarrollos que usen Azure Redis Cache. Para obtener documentación actual e instrucciones sobre cómo elegir una oferta de Azure Cache, consulte ¿Qué oferta de Azure Cache es adecuada para mí?

En este tema se trata el uso de archivos de configuración en Microsoft Azure Caché. Existen dos tipos de opciones de configuración.

1. Configuración del rol

2. Configuración del cliente

Configuración del rol

In-Role Cache admite la capacidad de hospedar el almacenamiento en caché dentro de un rol de Azure. Este tipo de almacenamiento en caché se configura como parte de un servicio en la nube. Normalmente, esto se hace en Visual Studio.

Nota

Las opciones de configuración descritas en esta sección solo se aplican a la caché de In-Role basada en roles. Shared Caching solo admite el acceso a la default memoria caché. Shared Caching no admite la modificación de las propiedades de la default memoria caché.

Para comprender las opciones de configuración, resulta útil correlacionar esa configuración con las opciones de la interfaz de usuario en Visual Studio. En la captura de pantalla siguiente se muestra una parte de la pestaña Almacenamiento en caché del cuadro de diálogo de propiedades del rol.

Además de habilitar In-Role caché, también puede crear una o varias cachés con nombre. Cada caché especifica sus propias propiedades. En la captura de pantalla siguiente se muestra esta parte de la pestaña de propiedades Almacenamiento en caché.

Estas selecciones de interfaz de usuario se almacenan en archivos de configuración. En primer lugar, el módulo almacenamiento en caché se carga en la sección Importaciones del archivo ServiceDefinition.csdef. En el fragmento XML siguiente se muestra esta línea.

<Import moduleName="Caching" />

Todas las demás configuraciones de caché de In-Role se almacenan en el archivo ServiceConfiguration.cscfg. Por ejemplo, a continuación se muestra la configuración del archivo ServiceConfiguration.cscfg para las selecciones de la pestaña Almacenamiento en caché que se muestran anteriormente.

  <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>

En esta configuración de rol, la mayoría de los valores de caché de In-Role tienen una correlación sencilla con las opciones de la pestaña Almacenamiento en caché . Sin embargo, la Microsoft.WindowsAzure.Plugins.Caching.NamedCaches configuración es más difícil de leer. Usa la sintaxis JSON para describir las propiedades de cada caché con nombre y todas las comillas dobles se reemplazan por ". Para obtener referencia sobre las opciones de configuración de roles, consulte Configuración de roles en caché en rol Configuración (ServiceConfiguration.cscfg).

Configuración del cliente

Un cliente de caché es cualquier código de aplicación que acceda a una caché de Azure. En el código, cada cliente de caché está asociado a un objeto DataCacheFactory . El generador devuelve un objeto DataCache que se usa para acceder a la memoria caché. La configuración real del cliente de caché se puede cargar desde un archivo de configuración de la aplicación o un archivo web.config.

En el ejemplo siguiente se muestran las secciones pertinentes para configurar una sección dataCacheClient denominada default en un archivo de configuración. Esto es específico de la caché de In-Role basada en roles.

<?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>

Para obtener referencia a estas opciones de configuración de cliente, consulte Configuración de cliente en caché en rol Configuración (Web.config). Para ver un tutorial que muestra cómo configurar clientes de In-Role Cache basados en roles, consulte How To: Use Azure SDK In-Role Cache( Uso de Azure SDK In-Role Cache).

Consulte también

Conceptos

Características de Caché en rol en Caché de Azure
Opciones de configuración de roles de Caché en rol (ServiceConfiguration.cscfg)
Opciones de configuración del cliente de Caché en rol (Web.config)