영업: 1-800-867-1380

역할 내 캐시 클라이언트 구성 설정(Web.config)

업데이트 날짜: 2010년 7월

note참고
응용 프로그램에 대한 올바른 Azure 캐시 제품 선택에 대한 자세한 지침은 내게 적합한 Azure 캐시 기능를 참조하세요.

이 항목에서는 .NET Framework web.config 또는 app.config 구성 파일에서 Microsoft Azure 캐시를 지원하기 위한 요구 사항에 대해 설명합니다. 또한 캐시 클라이언트에 대한 사용 가능한 구성 옵션도 설명합니다. 이 항목에 설명된 설정은 캐시 클라이언트에만 필요하며, 캐싱을 호스팅하는 역할에는 필요하지 않습니다.

Tip
캐싱에 NuGet 패키지를 사용하면 패키지에서 구성 파일을 자동으로 수정하지만, 이 항목을 사용하여 NutGet 없이 캐싱 클라이언트를 구성할 수 있습니다. 또한 이 정보를 사용하여 NuGet에서 삽입하는 캐시 클라이언트 설정을 추가로 사용자 지정할 수 있습니다.

이 항목에서 다루는 섹션은 다음과 같습니다.

다음 예제에서는 web.config 또는 app.config 파일의 캐싱 관련 섹션을 보여 줍니다. 이 예제에서는 default 캐시 클라이언트가 CacheWorkerRole1 역할에서 호스팅하는 캐시에 액세스하며, 로컬 캐시가 사용됩니다.

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

다음 두 명명된 section 요소를 configSections 요소의 섹션 목록에 추가해야 합니다.

 

Name 설명

dataCacheClients

구성 파일의 dataCacheClients 요소를 정의합니다. 이 섹션에서는 모든 캐시 클라이언트 구성에 대한 설정을 지정합니다.

cacheDiagnostics

구성 파일의 cacheDiagnostics 요소를 정의합니다. 이 섹션에서는 캐싱에 특정한 진단을 구성합니다.

다음 예제에서는 이러한 섹션을 정의하는 방법을 보여 줍니다.

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

dataCacheClients 요소는 하나 이상의 명명된 dataCacheClient 요소를 포함합니다. dataCacheClients 요소에는 특성이 없습니다. 여러 캐시 클라이언트 구성 섹션을 지정할 수 있으므로 응용 프로그램에서 여러 종류의 캐시된 데이터와 함께 다양한 설정을 사용할 수 있습니다.

dataCacheClients 요소는 하나 이상의 명명된 dataCacheClient 요소를 포함합니다. 응용 프로그램 코드는 연관된 dataCacheClient 섹션의 이름을 참조하여 캐시 클라이언트에 대한 설정을 로드합니다.

dataCacheClients 요소에는 특성이 없습니다. 그러나 자식 dataCacheClient 요소에는 몇 가지 사용 가능한 특성이 있습니다. 다음 표에서는 이러한 특성에 대해 설명합니다.

 

특성 설명

Name

캐시 클라이언트 구성의 이름입니다.

isCompressionEnabled

압축을 사용하거나 사용하지 않도록 설정합니다. 가능한 값은 true 또는 false입니다. 기본값은 false(사용 안 함)입니다.

useConnectionPool

연결 풀을 사용하거나 사용하지 않도록 설정합니다. 가능한 값은 true 또는 false입니다. 기본값은 true(사용)입니다.

maxConnectionsToServer

useConnectionPooltrue로 설정된 경우 이 특성은 이 캐시 클라이언트 구성에 대한 연결 풀의 연결 수를 지정합니다. useConnectionPoolfalse로 설정된 경우 이 특성은 코드의 각 DataCacheFactory 개체에 사용할 연결 수를 지정합니다.

다음 섹션에서는 각 dataCacheClient 요소 내의 사용 가능한 자식 요소를 설명합니다.

autoDiscover 요소는 대상 캐시 클라이언트에 대한 자동 연결을 통해 캐시 클라이언트를 지원합니다. 이 캐시 클러스터는 같은 클라우드 서비스 배포 내의 역할에 의해 호스팅되어야 합니다. 이 특성은 공유 캐싱에서 지원되지 않습니다.

다음 표에서는 autoDiscover 요소의 사용 가능한 특성을 설명합니다.

 

특성 설명

isEnabled

true 또는 false로 설정하여 캐싱를 호스팅하는 역할에 대한 로컬 자동 연결을 사용하거나 사용하지 않도록 설정할 수 있습니다.

identifier

동일한 클라우드 서비스 배포에서 캐싱를 호스팅하는 역할의 이름입니다.

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

localCache 요소는 로컬 캐시 사용을 제어합니다. 기본적으로 로컬 캐시는 사용되지 않습니다. 사용하도록 설정하면 캐시 클라이언트에서 검색된 항목이 클라이언트 컴퓨터의 메모리에 로컬로 저장됩니다. 이 경우 이후의 get 요청 성능이 향상되지만 로컬로 캐시된 버전과 캐시 클라이언트에 있는 실제 항목 간에 데이터 불일치가 발생할 수 있습니다. 자세한 내용은 로컬 캐시(Azure 캐시의 역할 내 캐시)를 참조하십시오.

다음 표에서는 localCache 요소의 사용 가능한 특성을 설명합니다.

 

특성 설명

isEnabled

로컬 캐시를 사용하거나 사용하지 않도록 설정하려면 true 또는 false로 설정합니다.

sync

로컬 캐시가 무효화되는 방법을 결정합니다. 가능한 값은 TimeoutBasedNotificationBased입니다.

objectCount

로컬 캐시에 저장할 최대 개체 수입니다. 기본값은 10000입니다.

ttlValue

개체가 로컬 캐시에 저장되는 시간(초)입니다. 기본값은 300초입니다.

note참고
알림은 역할에서 호스팅되는 캐시에서만 지원되는 역할 내 캐시 기능입니다. 이러한 캐시는 알림을 사용하도록 구성해야 합니다. Microsoft Azure 공유 캐싱에서는 알림이 지원되지 않습니다.

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

다음 표에서는 clientNotification 요소의 사용 가능한 특성을 설명합니다. 이 요소는 캐시 클라이언트에 대한 알림 동작을 제어합니다. 이 특성은 공유 캐싱에서 지원되지 않습니다.

 

특성 설명

pollInterval

폴링 시도 간격(초)입니다. 폴링은 캐시 클러스터에서 알림을 확인하는 데 사용됩니다. 기본값은 300초입니다.

maxQueueLength

폴링 시도 사이에 이 캐시 클라이언트에 대한 큐에 넣을 최대 알림 수입니다. 기본값은 알림 10000개입니다.

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

다음 표에서는 serializationProperties 요소의 사용 가능한 특성을 설명합니다. 이 요소에서는 캐시된 항목에 대한 직렬화 유형을 기본 제공 또는 사용자 지정 중에서 선택할 수 있습니다. 자세한 내용은 직렬화(Azure 캐시의 역할 내 캐시)를 참조하십시오.

 

특성 설명

serializer

캐시된 항목의 직렬화 유형을 결정합니다. 가능한 값은 NetDataContractSerializer, BinaryFormatterCustomSerializer입니다. 기본값은 NetDataContractSerializer입니다.

Important중요
hostshost 요소는 공유 캐싱에서만 사용됩니다.

hosts 요소는 host 요소를 포함합니다. 공유 캐싱의 경우 host 요소 하나만 지원됩니다. 다음 표에서는 자식 host 요소의 사용 가능한 특성을 설명합니다.

 

특성 설명

name

캐시에 대한 공유 캐싱 서비스 URL의 이름입니다.

cachePort

공유 캐싱 서비스 통신 포트입니다. 일반적으로 22233입니다.

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

Important중요
securityPropertiesmessageSecurity 요소는 공유 캐싱에서만 사용됩니다.

다음 표에서는 securityProperties 요소의 사용 가능한 특성을 설명합니다.

 

특성 설명

mode

가능한 값은 None, TransportMessage입니다. Message만 공유 캐싱에서 지원됩니다. 나머지 두 설정은 Windows Server용 Microsoft AppFabric 1.1과 관련이 있습니다.

securityProperties 요소는 자식 요소 messageSecurity를 포함할 수 있습니다. 다음 표에서는 messageSecurity 요소의 사용 가능한 특성을 설명합니다.

 

특성 설명

authorizationInfo

의 인증 토큰 속성에서 가져온 ACS 키입니다.

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

이 섹션에서는 캐싱에 대한 일부 진단 설정을 구성합니다. 진단에 대한 자세한 내용은 역할 내 캐시 문제 해결 및 진단(Azure 캐시)을 참조하십시오.

다음 섹션에서는 각 cacheDiagnostics 요소 내의 사용 가능한 자식 요소를 설명합니다.

crashDump 요소는 이 응용 프로그램에 대해 수집되는 크래시 덤프 유형을 제어합니다. 캐싱 크래시 덤프는 주로 캐시 클러스터 컴퓨터와 관련된 문제를 진단하도록 설계되었습니다. 따라서 클라이언트 구성 파일에서 크래시 덤프 생성을 해제해야 합니다. 그러려면 dumpLevel 특성을 Off로 설정하면 됩니다.

크래시 덤프가 사용하도록 설정되면 캐싱 로컬 저장소와 진단 저장소를 ServiceDefinition.csdef에서 조정하여 그 크기가 CacheSettings.xml에 구성되어 있는 크래시 저장소 할당량과 로그 저장소 할당량의 합계보다 항상 커야 합니다(기본값은 1000MB).

다음 표에서는 crashDump 요소의 사용 가능한 특성을 설명합니다.

 

특성 설명

dumpLevel

가능한 값은 Off, MiniFull입니다.

dumpStorageQuotaInMB

공유 캐싱 서비스 통신 포트입니다. 일반적으로 22233입니다.

scheduledTransferPeriodInMinutes

진단 저장소로 크래시 덤프가 전송되는 간격(분)입니다.

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

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
표시:
© 2014 Microsoft