Compartir a través de


Regiones y etiquetado para Azure Managed Cache Service

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

Microsoft Azure Cache admite la creación y el uso de regiones definidas por el usuario. Una región es un subgrupo de elementos en caché. Además, las regiones admiten la anotación de elementos en caché con cadenas descriptivas adicionales llamadas etiquetas. Además, ofrecen la posibilidad de realizar operaciones de búsqueda en elementos etiquetados en dicha región.

Consideraciones sobre las regiones

Las regiones son opcionales; Si quiere usarlos, créelos explícitamente en código con el método CreateRegion . Una vez creada una región, puede agregar etiquetas a los objetos que se insertan en dicha región. Hay sobrecargas en los métodos Add y Put que aceptan un nombre de región. Para buscar una región para objetos con una etiqueta determinada, use los métodos GetObjectsByTag, GetObjectsByAnyTag y GetObjectsByAllTags.

En Managed Cache Service, la memoria de la memoria caché se distribuye en diferentes áreas del servicio. Debido a los requisitos de arquitectura de la funcionalidad de búsqueda, los objetos de una región están en una única área de memoria en el servicio de caché. Si se habilita la disponibilidad alta, existe una copia de seguridad de la región en un área de memoria diferente del servicio de caché. Este comportamiento es diferente al del escenario en el que no se usan regiones. En este caso, los elementos nuevos de la memoria caché se distribuyen entre todas las áreas de memoria del servicio de caché.

Advertencia

Puesto que todos los elementos de una región deben estar en la misma área de memoria del servicio de caché, es posible que se expulsen elementos de la memoria caché incluso si parece haber suficiente memoria restante. Puede usar varias regiones más pequeñas para sacar partido de las ventajas que ofrecen las regiones y el etiquetado.

Ejemplos

El ejemplo siguiente muestra cómo crear una región denominada Test.

DataCache cache = new DataCache("default");
cache.CreateRegion("Test");

El siguiente ejemplo muestra cómo agregar tres objetos a la región Test con etiquetas.

List<DataCacheTag> tagList1 = new List<DataCacheTag>()
{ 
    new DataCacheTag("Tag1"),
    new DataCacheTag("Tag2")
};
List<DataCacheTag> tagList2 = new List<DataCacheTag>()
{
    new DataCacheTag("Tag3")
};
cache.Put("Key1", "Value1", tagList1, "Test");
cache.Put("Key2", "Value2", tagList1, "Test");
cache.Put("Key3", "Value3", tagList2, "Test");

El siguiente ejemplo muestra cómo buscar todos los objetos con la etiqueta Test en la región Tag1.

foreach (KeyValuePair<string, object> result in 
    cache.GetObjectsByTag(new DataCacheTag("Tag1"), "Test"))
{
    string keyValue = result.Key;
    string objectValue = result.Value.ToString();
}

Vea también

Otros recursos

Características del Servicio de caché administrado de Azure