LookupCache 정책

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

런타임 시 캐시된 값을 검색하는 방법을 구성합니다.

이 정책은 범용 단기 캐싱에 사용됩니다. 이는 PopulateCache 정책(항목 작성용) 및 InvalidateCache 정책(항목 무효화용)과 함께 사용됩니다.

이 정책은 확장 가능한 정책이며, 이 정책을 사용하면 Apigee 라이선스에 따라 비용 또는 사용률이 영향을 받을 수 있습니다. 정책 유형 및 사용 영향에 대한 자세한 내용은 정책 유형을 참조하세요.

백엔드 리소스의 응답을 캐싱하려면 ResponseCache 정책을 참조하세요.

요소 참조

다음은 이 정책에서 구성할 수 있는 요소입니다.

<LookupCache async="false" continueOnError="false" enabled="true" name="Lookup-Cache-1">
    <DisplayName>Lookup Cache 1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref=""/>
    </CacheKey>
    <!-- Omit this element if you're using the included shared cache. -->
    <CacheResource/>
    <CacheLookupTimeoutInSeconds/>
    <Scope>Exclusive</Scope>
    <AssignTo>flowVar</AssignTo>
</LookupCache>

공유 캐시는 기본적으로 포함됩니다. 공유 캐시를 사용하려면 이 정책 구성에서 <CacheResource> 요소를 생략합니다.

기본 데이터 저장소에 대한 자세한 내용은 캐시 내부를 참조하세요. 캐시 구성에 대한 자세한 내용은 범용 캐싱을 참조하세요.

<LookupCache> 속성

다음 표는 모든 정책 상위 요소의 공통 속성에 대해 설명합니다.

<DisplayName> 요소

name 속성 외에도 이 요소를 사용하여 관리 UI 프록시 편집기의 정책에 다른 자연어 이름으로 라벨을 지정합니다.

<DisplayName>Policy Display Name</DisplayName>

<AssignTo> 요소

캐시 항목이 캐시에서 검색된 후에 할당되는 변수를 지정합니다. 변수는 쓰기 가능해야 합니다. 캐시 조회에서 값을 검색하지 않으면 변수가 설정되지 않습니다.

<AssignTo>variable_to_receive_cached_value</AssignTo>

<CacheKey> 요소

캐시에 저장된 데이터 조각을 가리키는 고유한 포인터를 구성합니다.

<CacheKey>
    <Prefix>string</Prefix>
    <KeyFragment ref="variable_name" />
    <KeyFragment>literal_string</KeyFragment>
</CacheKey>

<CacheKey>는 캐시에 저장된 각 데이터 조각의 이름을 구성합니다.

런타임 시 <KeyFragment> 값 앞에 <Scope> 요소 값 또는 <Prefix> 값이 추가됩니다. 예를 들어 다음을 실행하면 캐시 키가 UserToken__apiAccessToken__<value_of_client_id>가 됩니다.

<CacheKey>
    <Prefix>UserToken</Prefix>
    <KeyFragment>apiAccessToken</KeyFragment>
    <KeyFragment ref="request.queryparam.client_id" />
</CacheKey>

<CacheKey> 요소를 <Prefix> 및 <Scope>와 함께 사용합니다. 자세한 내용은 캐시 키 작업을 참조하세요.

<CacheLookupTimeoutInSeconds> 요소

캐시 조회가 캐시 부적중으로 간주되는 시간(초)을 지정합니다. 이 경우 흐름이 캐시 부적중 경로를 따라 재개됩니다.

<CacheLookupTimeoutInSeconds>12</CacheLookupTimeoutInSeconds>

<CacheResource> 요소

메시지를 저장할 캐시를 지정합니다.

이 정책 및 해당 PopulateCache 및 InvalidateCache 정책이 포함된 공유 캐시를 사용하는 경우 이 요소를 완전히 생략하세요.

<CacheResource>cache_to_use</CacheResource>

캐시 구성에 대한 자세한 내용은 범용 캐싱을 참조하세요.

<CacheKey>/<KeyFragment> 요소

캐시 키에 포함되어야 하는 값을 지정합니다. ref 속성이나 고정 값을 사용하여 참조 해제할 변수를 지정합니다.

<KeyFragment ref="variable_name"/>
<KeyFragment>literal_string</KeyFragment>

런타임에서 Apigee는 <Scope> 요소 또는 <Prefix> 요소에서 가져온 값을 각 <KeyFragment> 요소의 확인된 값에 연결하여 캐시 키를 만듭니다. 자세한 내용은 캐시 키 작업을 참조하세요.

속성

<CacheKey>/<Prefix> 요소

캐시 키 프리픽스로 사용할 값을 지정합니다.

<Prefix>prefix_string</Prefix>

<Prefix> 요소는 모든 <Scope> 요소를 재정의합니다.

런타임에서 Apigee는 <Scope> 요소 또는 <Prefix> 요소에서 가져온 값을 각 <KeyFragment> 요소의 확인된 값에 연결하여 캐시 키를 만듭니다. 자세한 내용은 캐시 키 작업을 참조하세요.

<Scope> 요소

<CacheKey> 요소에서 <Prefix> 요소가 제공되지 않은 경우 캐시 키의 프리픽스를 구성하는 데 사용되는 열거형입니다.

<Scope>scope_enumeration</Scope>

<Scope> 설정은 <Scope> 값에 따라 앞에 오는 캐시 키를 결정합니다. 예를 들어 범위가 Exclusive로 설정된 경우 캐시 키는 다음 형식을 사용합니다. orgName__envName__applicationName__deployedRevisionNumber__proxy|TargetName__ [ serializedCacheKey ].

<CacheKey>에 <Prefix> 요소가 있는 경우 <Scope> 요소 값을 대체합니다. 유효한 값에는 아래의 열거값이 포함됩니다.

자세한 내용은 캐시 키 작업을 참조하세요.

사용 가능한 값

apifactory__test__weatherapi__16__default__apiAccessToken

사용 참고사항

이 정책은 범용 캐싱에 사용됩니다. 런타임 시 LookupCache 정책은 캐시에서 값을 검색하여 AssignTo 요소로 지정한 변수에 값을 할당합니다(값이 검색되지 않으면 변수가 설정되지 않음). CacheKey 및 Scope 요소를 조합하는 구성을 통해 생성된 캐시 키를 기반으로 값을 찾습니다. 즉, PopulateCache 정책으로 캐시에 추가된 특정 값을 검색하려면 LookupCache 정책에는 PopulateCache 정책과 동일한 방식으로 구성된 캐시 키 관련 요소가 있어야 합니다.

PopulateCache 정책, LookupCache 정책, InvalidateCache 정책을 통한 범용 캐싱은 구성한 캐시 또는 기본적으로 포함된 공유 캐시를 사용합니다. 대부분의 경우 기본 공유 캐시가 니즈를 충족해야 합니다. 기본 캐시를 사용하려면 <CacheResource> 요소를 생략하면 됩니다.

캐시 구성에 대한 자세한 내용은 범용 캐싱을 참조하세요. 기본 데이터 저장소에 대한 자세한 내용은 캐시 내부를 참조하세요.

흐름 변수

흐름 변수를 사용하면 HTTP 헤더, 메시지 콘텐츠 또는 흐름에서 사용 가능한 컨텍스트를 기준으로 정책 및 흐름의 동적 런타임 동작을 구성할 수 있습니다. 흐름 변수에 대한 자세한 내용은 흐름 변수 참조를 확인하세요.

LookupCache 정책에서 정의한 캐시의 동작을 맞춤설정하면 다음 사전 정의된 흐름 변수를 사용할 수 있습니다.

오류 코드

이 섹션에서는 이 정책이 오류를 트리거할 때 설정되는 오류 메시지 및 흐름 변수에 대해 설명합니다. 이 정보는 프록시에 대한 오류 규칙을 개발하는 중이라면 중요합니다. 자세한 내용은 정책 오류에 대해 알아야 할 사항 및 오류 처리를 참조하세요.

오류 코드 프리픽스

해당 없음

런타임 오류

이 정책은 런타임 오류를 발생시키지 않습니다.

배포 오류

이 오류는 이 정책이 포함된 프록시를 배포할 때 발생할 수 있습니다.

오류 변수

해당 없음

오류 응답 예시

해당 없음