VENDITE: 1-800-867-1389

Impostazioni di configurazione del client di Cache nel ruolo (Web.config)

Aggiornamento: settembre 2014

noteNota
Per indicazioni sulla scelta dell'offerta di Cache di Azure più adatta alla propria applicazione, vedere Qual è l'offerta di Cache di Azure più adatta alle mie esigenze?.

Questo argomento descrive i requisiti per il supporto di Cache di Microsoft Azure in un file di configurazione web.config o app.config di .NET Framework. Illustra inoltre le opzioni di configurazione disponibili per i client della cache. Le impostazioni descritte in questo argomento sono necessarie solo per i client della cache e non per i ruoli che ospitano memorizzazione nella cache.

TipSuggerimento
Se per memorizzazione nella cache viene usato il pacchetto NuGet, quest'ultimo modifica automaticamente il file di configurazione. Le informazioni riportate in questo argomento sono comunque utili per configurare i client di memorizzazione nella cache senza l'uso di NutGet. È inoltre possibile fare riferimento a queste informazioni per personalizzare ulteriormente le impostazioni del client della cache inserite automaticamente da NuGet.

Questo argomento descrive le seguenti sezioni.

Il seguente esempio illustra le sezioni di un file web.config o app.config rilevanti per memorizzazione nella cache. In questo esempio il client della cache default accede alle cache ospitate dal ruolo CacheWorkerRole1 e la cache locale è abilitata.

<?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" />
    <section name="cacheDiagnostics" type="Microsoft.ApplicationServer.Caching.AzureCommon.DiagnosticsConfigurationSection, Microsoft.ApplicationServer.Caching.AzureCommon" allowLocation="true" allowDefinition="Everywhere" />
  </configSections>
  <dataCacheClients>
    <dataCacheClient name="default">
      <autoDiscover isEnabled="true" identifier="CacheWorkerRole1" />
      <localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />
    </dataCacheClient>
  </dataCacheClients>
  <cacheDiagnostics>
    <crashDump dumpLevel="Off" dumpStorageQuotaInMB="100" />
  </cacheDiagnostics>
</configuration>

È necessario aggiungere i due seguenti elementi section denominati all'elenco delle sezioni nell'elemento configSections.

 

Nome Descrizione

dataCacheClients

Definisce l'elemento dataCacheClients del file di configurazione. Questa sezione specifica le impostazioni per tutte le configurazioni del client della cache.

cacheDiagnostics

Definisce l'elemento cacheDiagnostics del file di configurazione. Questa sezione configura la diagnostica specifica di memorizzazione nella cache.

Il seguente esempio illustra come definire queste sezioni.

    <section name="dataCacheClients" type="Microsoft.ApplicationServer.Caching.DataCacheClientsSection, Microsoft.ApplicationServer.Caching.Core" allowLocation="true" allowDefinition="Everywhere" />
    <section name="cacheDiagnostics" type="Microsoft.ApplicationServer.Caching.AzureCommon.DiagnosticsConfigurationSection, Microsoft.ApplicationServer.Caching.AzureCommon" allowLocation="true" allowDefinition="Everywhere" />

Ogni elemento dataCacheClients contiene uno o più elementi dataCacheClient denominati. Per l'elemento dataCacheClients non sono definiti attributi, La presenza di più sezioni di configurazione del client della cache consente alle applicazioni di usare diverse impostazioni con tipi diversi di dati memorizzati nella cache.

Ogni elemento dataCacheClients contiene uno o più elementi dataCacheClient denominati. Il codice dell'applicazione carica le impostazioni per un client della cache facendo riferimento al nome della sezione dataCacheClient associata.

Per l'elemento dataCacheClients non sono definiti attributi, mentre per gli elementi dataCacheClient figlio sono disponibili vari attributi, descritti nella seguente tabella.

 

Attributo Descrizione

Name

Nome della configurazione del client della cache.

isCompressionEnabled

Abilita o disabilita la compressione. I valori possibili includono true o false. Il valore predefinito è false (disabilitato).

useConnectionPool

Abilita o disabilita il pool di connessioni. I possibili valori includono true o false. Il valore predefinito è true (abilitato).

maxConnectionsToServer

Se useConnectionPool è impostato su true, l'attributo specifica il numero di connessioni nel pool di connessioni per la configurazione del client della cache corrente. Se useConnectionPool è impostato su false, l'attributo specifica il numero di connessioni da usare per ciascun oggetto DataCacheFactory nel codice.

Le seguenti sezioni descrivono gli elementi figlio disponibili in ciascun elemento dataCacheClient.

L'elemento autoDiscover è utile ai client della cache per la connessione automatica a un cluster di cache di destinazione. È necessario che questo cluster di cache sia ospitato da un ruolo che fa parte della stessa distribuzione del servizio cloud. Questo attributo non è supportato in Shared Caching.

La seguente tabella descrive gli attributi disponibili per l'elemento autoDiscover.

 

Attributo Descrizione

isEnabled

Impostare su true o false per abilitare o disabilitare la connessione automatica locale al ruolo che ospita memorizzazione nella cache.

identifier

Nome del ruolo che si trova nella stessa distribuzione del servizio cloud che ospita memorizzazione nella cache.

<autoDiscover isEnabled="true" identifier="CacheWorkerRole1" />

L'elemento localCache controlla l'uso della cache locale. Per impostazione predefinita, la cache locale non è abilitata. Se è abilitata, gli elementi recuperati dal cluster di cache vengono archiviati localmente nella memoria del computer client. Questo consente di migliorare le prestazioni delle successive richieste get, ma è possibile che si verifichi un'incoerenza tra i dati della versione memorizzata nella cache locale e quelli dell'elemento effettivo nel cluster di cache. Per altre informazioni, vedere Cache locale (Cache nel ruolo per Cache di Azure).

La seguente tabella descrive gli attributi disponibili per l'elemento localCache.

 

Attributo Descrizione

isEnabled

Impostare l'attributo su true o false per abilitare o disabilitare la cache locale.

sync

Determina la modalità di invalidamento della cache locale. I valori possibili sono TimeoutBased e NotificationBased.

objectCount

Numero massimo di oggetti che si possono archiviare nella cache locale. Il valore predefinito è 10000.

ttlValue

Numero di secondi di permanenza degli oggetti nella cache locale. Il valore predefinito è 300 secondi.

noteNota
Le notifiche sono una funzionalità di Cache nel ruolo supportata solo nelle cache ospitate nei ruoli di . Per abilitare le notifiche, è necessario configurare queste cache. Le notifiche non sono supportate in Shared Caching di Microsoft Azure.

<localCache isEnabled="true" sync="TimeoutBased" objectCount="100000" ttlValue="300" />

La seguente tabella descrive gli attributi disponibili per l'elemento clientNotification. Questo elemento è responsabile del controllo del comportamento delle notifiche per il client della cache. Questo attributo non è supportato in Shared Caching.

 

Attributo Descrizione

pollInterval

Numero di secondi tra i tentativi di polling. Il polling viene usato per la verifica delle notifiche nel cluster di cache. Il valore predefinito è 300 secondi.

maxQueueLength

Numero massimo di notifiche in coda per questo client della cache tra i tentativi di polling. Il valore predefinito è 10000 notifiche.

<clientNotification pollInterval="60" maxQueueLength="10000"/>

La seguente tabella descrive gli attributi disponibili per l'elemento serializationProperties. Questo elemento consente di scegliere tra una serializzazione predefinita o personalizzata per gli elementi memorizzati nella cache. Per altre informazioni, vedere Serializzazione (Cache nel ruolo per Cache di Azure).

 

Attributo Descrizione

serializer

Determina il tipo di serializzazione per gli elementi memorizzati nella cache. I valori possibili sono NetDataContractSerializer, BinaryFormatter e CustomSerializer. Il valore predefinito è NetDataContractSerializer.

ImportantImportante
Gli elementi hosts e host vengono usati solo con Shared Caching.

L'elemento hosts contiene un elemento host. Per Shared Caching è supportato un solo elemento host. La seguente tabella descrive gli attributi disponibili per l'elemento host figlio.

 

Attributo Descrizione

name

Nome dell'URL del servizio Shared Caching per la cache.

cachePort

Porta per le comunicazioni del servizio Shared Caching. Questo valore è in genere 22233.

<hosts>
    <host name="yourcachename.cache.windows.net" cachePort="22233" />
</hosts>

ImportantImportante
Gli elementi securityProperties e messageSecurity vengono usati solo con Shared Caching.

La seguente tabella descrive gli attributi disponibili per l'elemento securityProperties.

 

Attributo Descrizione

mode

I valori possibili comprendono None, Transport e Message. Solo Message è supportato in Shared Caching. Le altre due impostazioni si riferiscono a Microsoft AppFabric 1.1 per Windows Server.

Per l'elemento securityProperties è possibile definire un elemento figlio, messageSecurity. La seguente tabella descrive gli attributi disponibili per l'elemento messageSecurity.

 

Attributo Descrizione

authorizationInfo

Chiave ACS ricavata dalla proprietà Token di autenticazione nel .

<securityProperties mode="Message">
   <messageSecurity authorizationInfo="iz8zOmJ0dJBzzzzxa8JxdGJkb281bzxudGF0az9udGxzdGluZi111z8oZS5Ji28lP38jb250Pm9sLmludDMud2luZG93Pi1pb8Qubmx0L1dSQxB2MP45LiZxd25lPii0eDJJZQA5SlZQQUQ2xzIizk8iazlES1P08X8zOFIxZjdzZxp0i3lFQ2FFPSZodJRzOi8xS8JxdGJEb281bzxudGF0az9uxGxzdGluZi5jiz8oZS5pb8QzL8dpbmRxd3MQaz50Lm5ldA==">
   </messageSecurity>
</securityProperties>

Questa sezione configura alcune impostazioni di diagnostica per memorizzazione nella cache. Per altre informazioni sulla diagnostica, vedere Diagnostica e risoluzione dei problemi di Cache nel ruolo (Cache di Azure).

Le seguenti sezioni descrivono gli elementi figlio disponibili in ciascun elemento cacheDiagnostics.

L'elemento crashDump controlla i tipi di dump di arresto anomalo del sistema raccolti per questa applicazione. I dump di arresto anomalo del sistema di memorizzazione nella cache sono progettati principalmente per diagnosticare i problemi con i computer del cluster di cache. Per questo motivo, è necessario che i file di configurazione del client disabilitino la generazione di dump di arresto anomalo del sistema. È possibile effettuare questa operazione impostando l'attributo dumpLevel su Off.

Se i dump di arresto anomalo del sistema sono abilitati, l'archivio locale della memorizzazione nella cache e l'archivio della diagnostica devono essere impostati nel file ServiceDefinition.csdef in modo che la dimensione sia sempre maggiore della somma della quota di archiviazione relativa all'arresto anomalo del sistema e di quella relativa ai log. È possibile configurare questi valori nel file CacheSettings.xml (i valori predefiniti sono 1000 MB).

La seguente tabella descrive gli attributi disponibili per l'elemento crashDump.

 

Attributo Descrizione

dumpLevel

I valori possibili comprendono Off, Mini e Full.

dumpStorageQuotaInMB

Porta per le comunicazioni del servizio Shared Caching. Questo valore è in genere 22233.

scheduledTransferPeriodInMinutes

Numero di minuti tra i trasferimenti dei dump di arresto anomalo del sistema all'archivio di diagnostica.

<crashDump dumpLevel="Off" dumpStorageQuotaInMB="100" scheduledTransferPeriodInMinutes="5" />

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Mostra:
© 2014 Microsoft