LookupCache politikası

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

Önbelleğe alınan değerlerin çalışma zamanında nasıl alınacağını yapılandırır.

Bu politika, genel amaçlı kısa süreli önbelleğe alma işlemlerinde kullanılmak üzere tasarlanmıştır. Önbelleği doldurma politikası (giriş yazmak için) ve Önbelleği geçersiz kılma politikası (girişleri geçersiz kılmak için) ile birlikte kullanılır.

Arka uç kaynaklarının yanıtlarını önbelleğe almak için Yanıt Önbelleği Politikası'na bakın.

Öğe referansı

Aşağıda, bu politikada yapılandırabileceğiniz öğeler listelenmiştir.

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

Paylaşılan önbellek varsayılan olarak eklenir. Paylaşılan önbelleği kullanmak için bu politika yapılandırmasında <CacheResource> öğesini çıkarın.

Temel veri deposu hakkında daha fazla bilgi için Önbelleğin iç işleyiş mekanizması başlıklı makaleyi inceleyin. Önbellekleri yapılandırma hakkında daha fazla bilgi için Ortam önbelleği oluşturma ve düzenleme başlıklı makaleyi inceleyin.

<LookupCache> özellikleri

Aşağıdaki tabloda tüm politika üst öğelerinde ortak olan özellikler açıklanmaktadır:

&lt;DisplayName&gt; öğe

Politikayı name özelliğine ek olarak farklı bir doğal dil adına sahip yönetim arayüzü proxy düzenleyicisi.

<DisplayName>Policy Display Name</DisplayName>

<AssignTo> öğesi

Önbellekten alındıktan sonra önbellek girişinin atandığı değişkeni belirtir. Değişken yazılabilir olmalıdır. Önbelleğe göz atma işlemi bir değer döndürmezse değişken ayarlanmaz.

<AssignTo>variable_to_receive_cached_value</AssignTo>

<CacheKey> öğesi

Önbellekte depolanan bir veri parçasına benzersiz bir işaretçi yapılandırır.

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

<CacheKey>, önbellekte saklanan her veri parçasının adını oluşturur.

Çalışma zamanında <KeyFragment> değerlerine <Scope> öğesi değeri veya <Prefix> değeri eklenir. Örneğin, aşağıdaki kod UserToken__apiAccessToken__<value_of_client_id> önbelleğe alınmış anahtarıyla sonuçlanır:

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

<CacheKey> öğesini <Prefix> ve <Scope> ile birlikte kullanırsınız. Daha fazla bilgi için Önbellek anahtarlarıyla çalışma başlıklı makaleyi inceleyin.

<CacheLookupTimeoutInSeconds> öğesi

Başarısız bir önbellek aramasının kaç saniye sonra önbellek kaçırması olarak değerlendirileceğini belirtir. Bu durumda akış, önbellek kaçırma yolunda devam eder.

<CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>

<CacheResource> öğesi

Mesajların saklanacağı önbelleği belirtir.

Bu politika (ve ilgili PopulateCache ve InvalidateCache politikalarınız) dahili paylaşılan önbelleği kullanıyorsa bu öğeyi tamamen çıkarın.

<CacheResource>cache_to_use</CacheResource>

Önbellekleri yapılandırma hakkında daha fazla bilgi için Ortam önbelleği oluşturma ve düzenleme başlıklı makaleyi inceleyin.

<CacheKey>/<KeyFragment> öğesi

Önbelleğe anahtarına dahil edilmesi gereken bir değeri belirtir. Bu değer, isteklerin önbelleğe alınmış yanıtlarla eşleştirilmesi için bir ad alanı oluşturur.

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

Bu, bir anahtar (sağladığınız statik bir ad) veya değer (bir değişkene referans vererek ayarlanan dinamik giriş) olabilir. Önek de dahil olmak üzere belirtilen tüm parçalar birleştirilerek önbelleğe alma anahtarı oluşturulur.

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

<KeyFragment> öğesini <Prefix> ve <Scope> ile birlikte kullanırsınız. Daha fazla bilgi için Önbellek anahtarlarıyla çalışma başlıklı makaleyi inceleyin.

Özellikler

<CacheKey>/<Prefix> öğesi

Önbellek anahtarı ön eki olarak kullanılacak bir değeri belirtir.

<Prefix>prefix_string</Prefix>

<Scope> - listelenen bir değer yerine kendi değerinizi belirtmek istediğinizde <Scope> yerine bu değeri kullanın. Tanımlanmışsa <Prefix>, önbelleğe yazılan girişler için önbelleğe anahtar değerini ekler. <Prefix> öğesi değeri, <Scope> öğesi değerini geçersiz kılar.

<Prefix> öğesini <CacheKey> ve <Scope> ile birlikte kullanırsınız. Daha fazla bilgi için Önbellek anahtarlarıyla çalışma başlıklı makaleyi inceleyin.

<Scope> öğesi

<CacheKey> öğesinde <Prefix> öğesi sağlanmadığında önbelleğe alma anahtarı için önek oluşturmak amacıyla kullanılan listeleme.

<Scope>scope_enumeration</Scope>

<Scope> ayarı, <Scope> değerine göre ön ek olarak eklenen bir önbellek anahtarı belirler. Örneğin, kapsam Exclusive olarak ayarlandığında bir önbellek anahtarı aşağıdaki biçimi alır: orgName__envName__applicationName__proxy|TargetName__ [ serializedCacheKey ].

<CacheKey> içinde bir <Prefix> öğesi varsa bu öğe, <Scope> öğesi değerinin yerini alır. Geçerli değerler aşağıdaki listelemelerin yanı sıra

<Scope> öğesini <CacheKey> ve <Prefix> ile birlikte kullanırsınız. Daha fazla bilgi için Önbellek anahtarlarıyla çalışma başlıklı makaleyi inceleyin.

Kabul edilebilir değerler

apifactory__test__weatherapi__16__default__apiAccessToken

Kullanım notları

Genel amaçlı önbelleğe alma için bu politikayı kullanın. LookupCache politikası, çalışma zamanında önbellekten bir değer alır ve bu değeri AssignTo öğesiyle belirttiğiniz değişkene atar (hiçbir değer alınmazsa değişken ayarlanmaz). CacheKey ve Scope öğelerini birleştiren yapılandırma aracılığıyla oluşturulan bir önbelleğe alma anahtarına göre değeri arar. Diğer bir deyişle, PopulateCache politikası tarafından önbelleğe eklenen belirli bir değeri almak için LookupCache politikanızda, önbelleğe anahtarıyla ilgili öğelerin PopulateCache politikasıyla aynı şekilde yapılandırılmış olması gerekir.

PopulateCache politikası, LookupCache politikası ve InvalidateCache politikası ile genel amaçlı önbelleğe alma, yapılandırdığınız bir önbelleği veya varsayılan olarak dahil edilen paylaşılan bir önbelleği kullanır. Çoğu durumda, temel alınan paylaşılan önbellek ihtiyaçlarınızı karşılar. Varsayılan önbelleği kullanmak için <CacheResource> öğesini çıkarmanız yeterlidir.

Önbellekleri yapılandırma hakkında daha fazla bilgi için Ortam önbelleği oluşturma ve düzenleme başlıklı makaleyi inceleyin. Temel veri deposu hakkında daha fazla bilgi için Önbelleğin iç işleyiş mekanizması başlıklı makaleyi inceleyin.

Akış değişkenleri

Akış değişkenleri, HTTP üstbilgilerine, mesaj içeriğine veya akışta mevcut olan bağlama göre politikalar ve akışlar için dinamik çalışma zamanı davranışını yapılandırmak için kullanılabilir. Akış değişkenleri hakkında daha fazla bilgi için Değişkenler referansı başlıklı makaleyi inceleyin.

Aşağıdaki önceden tanımlanmış Flow değişkenleri, bir LookupCache politikasında tanımladığınız önbelleğin davranışını özelleştirdikten sonra kullanılabilir.

Hata kodları

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Error code prefix

N/A

Runtime errors

This policy does not throw any runtime errors.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Fault variables

N/A

Example error response

N/A