Uygulama Yapılandırma Ayarları (Windows Server AppFabric Önbelleğe Alma)

Windows Server AppFabric'in önbelleğe alma özellikleriyle, uygulama yapılandırma dosyası veya uygulamanızın farklı yerlerinde her iki yaklaşımı kullanarak uygulamanızın önbellek istemcisi ayarlarını program aracılığıyla yapılandırabilirsiniz. Bu yapılandırma yöntemleri ve bu yöntemlerin nasıl seçileceği hakkında daha fazla bilgi için bkz. İstemci Yapılandırma Seçenekleri (Windows Server AppFabric Önbelleğe Alma).

Seçtiğiniz yaklaşıma bakmaksınız, aynı önbellek istemcisi ayarını yapılandıracaksınız. Bu konuda bulunan tablolar, önbellek istemcisi tarafından kullanılabilen ayarları sunar ve bu ayarların XML tabalı uygulama yapılandırma dosyasında ve kod kullanarak program aracılığıyla nasıl yapılandırıldığını gösterir.

Bu ayarları uygulamanızda nasıl kullanacağınız hakkında daha fazla bilgi için XML Tabanlı İstemci Yapılandırması (Windows Server AppFabric Önbelleğe Alma) bölümünde ele alınan örneklere bakın.

Önbellek İstemcisi Ayarı

Ayar	XML Yapılandırma Konumu	Kod Yapılandırma Konumu
İstemci zaman aşımı (milisaniye)	dataCacheClient öğesinde bulunan requestTimeout özniteliği. 10000'nin (10 saniye) altında bir değer belirtmenizi önermeyiz. Varsayılan değer 15000'dir.	DataCacheFactoryConfiguration sınıfının RequestTimeout özelliği.
Açık kanal zaman aşımı (milisaniye)	dataCacheClient öğesinde bulunan channelOpenTimeout özniteliği. Bu değer, ağ sorunlarıyla hemen ilgilenilmesini sağlamak için 0 olarak ayarlanabilir. Daha fazla bilgi için bkz. Önbellek İstemcisi Zaman Aşımlarını Yapılandırma (Windows Server AppFabric Önbelleğe Alma). Varsayılan, 3000 değeridir.	DataCacheFactoryConfiguration sınıfının ChannelOpenTimeout özelliği.
Sunucuya yapılan bağlantı sayısının üst sınırı	dataCacheClient öğesinde bulunan maxConnectionsToServer özniteliği. Varsayılan, 1 değeridir.	DataCacheFactoryConfiguration sınıfının MaxConnectionsToServer özelliği.

Önbellek Konağı Ayarları

Her önbellek istemcisi için kümede bir veya birden fazla önbellek konağı belirtmelisiniz. Temel konaklar olarak belirlenen önbellek konakları kümeyi yönetirden yardımcı olduğundan temel konaklar belirleyin. Başlangıçta, temel konaklar kümeye yüklenen ilk önbellek konaklarıdır. Temel konaklar hakkında daha fazla bilgi için bkz. Windows Server AppFabric Önbelleğe Alma Fiziksel Mimarisi Diyagramı.

Uygulama yapılandırma dosyasında, her önbellek konağının ayarları hosts öğesinin bir alt öğesi olan konak öğesinde belirlenir. Program aracılığıyla her konak DataCacheServerEndpoint sınıfının sınıf oluşturucusunda tanımlanır. Oluşturulduktan sonra, bu DataCacheServerEndPoint nesneleri DataCacheServerEndpoint sınıfının Servers özelliğine geçirilir.

Ayar	XML Yapılandırma Konumu	Kod Yapılandırma Konumu
Önbellek sunucusu adı	host öğesinin name özniteliği.	DataCacheServerEndpoint sınıfının HostName özelliği.
Önbellek bağlantı noktası numarası	host öğesinin cachePort özniteliği.	DataCacheServerEndpoint sınıfının CachePort özelliği.

Yerel Önbellek Ayarları

Yerel önbellek ayarları yerel belleğin etkinleştirilip etkinleştirilmeyeceğini, yerel olarak önbelleğe alınan nesnelerin nasıl geçersiz kılınacağını, nesne zaman aşımını ve yerel olarak önbelleğe alınan nesneleri geçersiz kılmak için önbellek bildirimlerinin kullanılıp kullanılmayacağını belirler.

Uygulama yapılandırma dosyasında, yerel önbellek ayarları dataCacheClient öğesinin alt öğesi olan localCache öğesinde tanımlanır. Yerel önbellek program aracılığıyla, DataCacheFactory sınıf oluşturucusunun oluşturucusuna geçirilen bir DataCacheFactoryConfiguration sınıfı örneğiyle yapılandırılır. Yerel önbellek hakkında daha fazla bilgi için bkz. Önbellek İstemcileri ve Yerel Önbellek (Windows Server AppFabric Önbelleğe Alma).

Ayar	XML Yapılandırma Konumu	Kod Yapılandırma Konumu
Yerel önbellek etkin	localCache öğesinde bulunan isEnabled özniteliği. Değerler true veya false olabilir. Devre dışı olduğunu göstermek için localCache öğesi de eksik olabilir.	DataCacheLocalCacheProperties sınıfının IsEnabled özelliği. Bu daha sonra DataCacheFactoryConfiguration sınıfının LocalCacheProperties özelliğine atanır.
Yerel önbellek geçersiz kılma yöntemi	localCache öğesinde bulunan sync özniteliği. Kullanılacak olan zaman aşımı değerini belirtmek için TimeoutBased değerini kullanın. Kullanılacak olan önbellek bildirimlerini belirtmek için NotificationBased yöntemini kullanın.	DataCacheLocalCacheProperties sınıfının InvalidationPolicy özelliği. Olası değerler arasında NotificationBased ve TimeoutBased bulunmaktadır.
Yerel önbellek zaman aşımı (saniye)	localCache öğesinde bulunan ttlValue özniteliği.	DataCacheLocalCacheProperties sınıfının DefaultTimeout özelliği.
Belirli önbellek bildirimi yoklama aralığı (saniye)	(İsteğe bağlı) clientNotification öğesinin pollInterval özniteliği tarafından belirtilir. clientNotification öğesi, dataCacheClient öğesinin alt öğesidir ve localCache öğesinin alt öğesi değildir. Değer belirtilmezse, 300 saniye değeri kullanılır.	DataCacheNotificationProperties sınıfının PollInterval özelliği. Bu daha sonra DataCacheFactoryConfiguration sınıfının NotificationProperties özelliğine atanır.
En yüksek yerel olarak önbelleğe alınan nesne sayısı	(İsteğe bağlı) localCache öğesinin objectCount özniteliği tarafından belirtilir. Yerel önbellekte çıkarmanın başlayacağı zaman; son zamanlarda en az kullanılan yerel olarak önbelleğe alınmış nesnelerin yüzde 20'sini kaldırmayı denediğinde tetiklenir. Belirtilmezse, varsayılan değer olan 10.000 nesne kullanılır.	DataCacheLocalCacheProperties sınıfının ObjectCount özelliği.

Not

En iyi performansı elde etmek için yerel önbelleği yalnızca sık değişmeyen nesneler için etkinleştirin. Yerel önbellek sık değişen veriler için kullanılırsa istemcinin eski nesnelerle çalışma ihtimali artabilir. ttlValue değerini düşürüp yerel önbelleğin daha sık yenilenmesi için bir işlem gerçekleştirme imkanına sahip olsanız da küme üzerindeki artan yük yerel bir önbelleğin yararlarından daha ağır gelebilir. Sık değişen veri durumlarında, en iyi yol yerel önbelleği devre dışı bırakıp verileri doğrudan kümeden çekmektir.

Bildirim Ayarları

Uygulama yapılandırma dosyasında, bildirim özellikleri dataCacheClient öğesinin alt öğesi olan clientNotification öğesinde tanımlanır. Bildirim özellikleri program aracılığıyla, DataCacheFactory sınıf oluşturucusunun oluşturucusuna geçirilen bir DataCacheFactoryConfiguration sınıfı örneğiyle yapılandırılır. Daha fazla bilgi için bkz. Yapılandırma Yöntemleri (Windows Server AppFabric Önbelleğe Alma).

Ayar	XML Yapılandırma Konumu	Kod Yapılandırma Konumu
Belirli önbellek bildirimi yoklama aralığı (saniye)	clientNotification öğesinin pollInterval özniteliği tarafından belirtilir. Değer belirtilmezse, 300 saniye değeri kullanılır.	DataCacheNotificationProperties sınıfının PollInterval özelliği. Bu daha sonra DataCacheFactoryConfiguration sınıfının NotificationProperties özelliğine atanır.
Sıra uzunluğu üst sınırı	clientNotification öğesinin maxQueueLength özniteliği. Belirtilmezse, varsayılan değer 10000'dir.	DataCacheNotificationProperties sınıfının MaxQueueLength özelliği.

Güvenlik Ayarları

Uygulama yapılandırma dosyasında, güvenlik özellikleri dataCacheClient öğesinin alt öğesi olan securityProperties öğesinde tanımlanır. Güvenlik özellikleri program aracılığıyla, DataCacheFactory sınıf oluşturucusunun oluşturucusuna geçirilen bir DataCacheFactoryConfiguration sınıfı örneğiyle yapılandırılır. Daha fazla bilgi için bkz. Yapılandırma Yöntemleri (Windows Server AppFabric Önbelleğe Alma).

Ayar	XML Yapılandırma Konumu	Kod Yapılandırma Konumu
Mod	securityProperties öğesinin mode özniteliği. Olası değerler arasında Transport ve None bulunmaktadır. Varsayılan, Transport değeridir.	DataCacheSecurity sınıfının SecurityMode özelliği. Olası değerler arasında None ve Transport bulunmaktadır. DataCacheSecurity nesnesi daha sonra DataCacheFactoryConfiguration sınıfının SecurityProperties özelliğine atanır.
Koruma düzeyi	securityProperties öğesinin protectionLevel özniteliği. Olası değerler arasında None, Sign ve EncryptAndSign bulunmaktadır. Varsayılan, EncryptAndSign değeridir.	DataCacheSecurity sınıfının ProtectionLevel özelliği. Olası değerler arasında None, Sign ve EncryptAndSign bulunmaktadır.

Aktarım Ayarları

Uygulama yapılandırma dosyasında, aktarım özellikleri dataCacheClient öğesinin alt öğesi olan transportProperties öğesinde tanımlanır. Aktarım özellikleri program aracılığıyla, DataCacheFactory sınıf oluşturucusunun oluşturucusuna geçirilen bir DataCacheFactoryConfiguration sınıfı örneğiyle yapılandırılır. Daha fazla bilgi için bkz. Yapılandırma Yöntemleri (Windows Server AppFabric Önbelleğe Alma).

Ayar	XML Yapılandırma Konumu	Kod Yapılandırma Konumu
Bağlantı arabellek boyutu (bayt)	transportProperties öğesinin connectionBufferSize özniteliği.	DataCacheTransportProperties sınıfının ConnectionBufferSize özelliği. Bu daha sonra DataCacheFactoryConfiguration sınıfının TransportProperties özelliğine atanır.
Arabellek havuzu boyutu üst sınırı (bayt)	transportProperties öğesinin maxBufferPoolSize özniteliği.	DataCacheTransportProperties sınıfının MaxBufferPoolSize özelliği.
Arabellek boyutu üst sınırı (bayt)	transportProperties öğesinin maxBufferSize özniteliği.	DataCacheTransportProperties sınıfının MaxBufferSize özelliği.
Çıkış gecikmesi üst sınırı (milisaniye)	transportProperties öğesinin maxOutputDelay özniteliği.	DataCacheTransportProperties sınıfının MaxOutputDelay özelliği.
Kanal başlatma zaman aşımı (milisaniye)	transportProperties öğesinin channelInitializationTimeout özniteliği.	DataCacheTransportProperties sınıfının ChannelInitializationTimeout özelliği.
Alma zaman aşımı (milisaniye)	transportProperties öğesinin receiveTimeout özniteliği.	DataCacheTransportProperties sınıfının ReceiveTimeout özelliği.

Örnek Uygulama Yapılandırma Dosyası

AppFabric derlemelerinin uygulama yapılandırma dosyasında bulunan XML öğelerini okuyabilmesi için configSections öğesini birinci öğe olarak configuration etiketinin altındaki dosyaya eklemelisiniz. configSections öğesinde dataCacheClient öğesi ile ilişkilendirilmiş bir section öğesi eklemelisiniz.

Aşağıdaki örnekte, bu konuda açıklanan pek çok önbellek istemcisi yapılandırma seçeneğini kullanan bir uygulama yapılandırma dosyası gösterilir. Kümeye bağlanmak için dataCacheClient içinde yalnızca hosts öğesinin gerekli olduğunu belirtmekte yarar vardır. Diğer alt öğelerin tümü varsayılan değerlerindedir.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
   <!--configSections must be the FIRST element -->
<configSections>
   <!-- required to read the <dataCacheClient> element -->
   <section name="dataCacheClient"
         type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
            Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0, 
            Culture=neutral, PublicKeyToken=31bf3856ad364e35"
          allowLocation="true"
          allowDefinition="Everywhere"/>
</configSections>

   <dataCacheClient requestTimeout="15000" channelOpenTimeout="3000" maxConnectionsToServer="1">
      <localCache isEnabled="true" sync="TimeoutBased" ttlValue="300" objectCount="10000"/>
      <clientNotification pollInterval="300" maxQueueLength="10000"/>
      <hosts>
         <host name="CacheServer1" cachePort="22233"/>
         <host name="CacheServer2" cachePort="22233"/>
      </hosts>
      <securityProperties mode="Transport" protectionLevel="EncryptAndSign" />
      <transportProperties connectionBufferSize="131072" maxBufferPoolSize="268435456" 
                           maxBufferSize="8388608" maxOutputDelay="2" channelInitializationTimeout="60000" 
                           receiveTimeout="600000"/>
   </dataCacheClient>
</configuration>

Ayrıca bkz.

Kavramlar

İstemci Yapılandırma Seçenekleri (Windows Server AppFabric Önbelleğe Alma)
Küme Yapılandırma Ayarları (Windows Server AppFabric Önbelleğe Alma)
Windows Server AppFabric Önbelleğe Alma Sorunlarını Giderme
Windows Server AppFabric Önbelleğe Alma Özelliklerini Yönetmek için Windows PowerShell Kullanma
Windows Server AppFabric Önbelleğe Alma Kavramları
Önbellek İstemcisi Geliştirme (Windows Server AppFabric Önbelleğe Alma)

  2011-12-05