Questa pagina è stata tradotta dall'API Cloud Translation.

Criterio LookupCache

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Il criterio LookupCache configura la modalità di recupero dei valori memorizzati nella cache in fase di runtime.

Queste norme sono destinate all'utilizzo nella memorizzazione nella cache a breve termine per uso generico. Viene utilizzato in combinazione con il criterio PopolateCache (per la scrittura delle voci) e il criterio InvalidateCache (per l'invalidazione delle voci).

Queste norme sono estensibili e il loro utilizzo potrebbe avere implicazioni in termini di costi o di utilizzo, a seconda della licenza Apigee. Per informazioni sui tipi di policy e sulle implicazioni di utilizzo, consulta Tipi di policy.

Per la memorizzazione nella cache delle risposte delle risorse di backend, consulta le norme ResponseCache.

Riferimento elemento

Di seguito sono elencati gli elementi che puoi configurare in questo criterio.

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

Per impostazione predefinita, è inclusa una cache condivisa. Per utilizzare la cache condivisa, ometti l'elemento <CacheResource> in questa configurazione dei criteri.

Per saperne di più sul datastore sottostante, consulta Elementi interni della cache. Per saperne di più sulla configurazione delle cache, consulta la sezione Memorizzazione nella cache per uso generico.

Attributi <LookupCache>

The following table describes attributes that are common to all policy parent elements:

Attribute	Description	Default	Presence
`name`	The internal name of the policy. The value of the `name` attribute can contain letters, numbers, spaces, hyphens, underscores, and periods. This value cannot exceed 255 characters. Optionally, use the `<DisplayName>` element to label the policy in the management UI proxy editor with a different, natural-language name.	N/A	Required
`continueOnError`	Set to `false` to return an error when a policy fails. This is expected behavior for most policies. Set to `true` to have flow execution continue even after a policy fails. See also: Fault rules are triggered ONLY in an error state (about continueOnError) Handling faults within the current flow	false	Optional
`enabled`	Set to `true` to enforce the policy. Set to `false` to turn off the policy. The policy will not be enforced even if it remains attached to a flow.	true	Optional
`async`	This attribute is deprecated.	false	Deprecated

<DisplayName> element

Use in addition to the name attribute to label the policy in the management UI proxy editor with a different, natural-language name.

<DisplayName>Policy Display Name</DisplayName>

Default

Default	N/A If you omit this element, the value of the policy's `name` attribute is used.
Presence	Optional
Type	String

N/A

If you omit this element, the value of the policy's name attribute is used.

Presence Optional

Type String

Elemento <AssignTo>

Specifica la variabile a cui viene assegnata la voce della cache dopo essere stata recuperata dalla cache. La variabile deve essere scrivibile. Se la ricerca nella cache non recupera un valore, la variabile non verrà impostata.

<AssignTo>variable_to_receive_cached_value</AssignTo>

Valore predefinito:	N/D
Presenza:	Obbligatorio
Tipo:	Stringa

Elemento <CacheKey>

Configura un puntatore univoco a un insieme di dati memorizzati nella cache.

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

Valore predefinito:	N/D
Presenza:	Obbligatorio
Tipo:	N/D

<CacheKey> crea il nome di ogni dato memorizzato nella cache.

In fase di runtime, i valori di <KeyFragment> vengono anteposti al valore dell'elemento <Scope> o al valore di <Prefix>. Ad esempio, i seguenti generano una chiave della cache UserToken__apiAccessToken__<value_of_client_id>:

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

Utilizzi l'elemento <CacheKey> in combinazione con <Prefix> e <Scope>. Per saperne di più, consulta Utilizzo delle chiavi della cache.

Elemento <CacheLookupTimeoutInSeconds>

Specifica il numero di secondi dopo i quali una ricerca nella cache senza esito positivo verrà considerata un fallimento della cache. In questo caso, il flusso riprende lungo il percorso di mancato riscontro nella cache.

<CacheLookupTimeoutInSeconds>12</CacheLookupTimeoutInSeconds>

Valore predefinito:	12
Presenza:	Facoltativo
Tipo:	Numero intero

Elemento <CacheResource>

Specifica la cache in cui devono essere archiviati i messaggi.

Ometti completamente questo elemento se questa policy (e le policy PopulateCache e InvalidateCache corrispondenti) utilizza la cache condivisa inclusa.

<CacheResource>cache_to_use</CacheResource>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Per saperne di più sulla configurazione delle cache, consulta la sezione Memorizzazione nella cache per scopi generali.

Elemento <CacheKey>/<KeyFragment>

Specifica un valore da includere nella chiave cache. Specifica una variabile a cui fare dereferenziazione con l'attributo ref o un valore fisso.

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

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	N/D

In fase di runtime, Apigee crea la chiave della cache anteponendo il valore ottenuto dall'elemento <Scope> o dall'elemento <Prefix> a una concatenazione dei valori risolti di ciascuno degli elementi <KeyFragment>. Per saperne di più, consulta Utilizzo delle chiavi della cache.

Attributi

Attributo	Tipo	Predefinito	Obbligatorio	Descrizione
ref	string		No	La variabile da cui ottenere il valore. Non deve essere utilizzato se questo elemento contiene un valore letterale.

Elemento <CacheKey>/<Prefix>

Specifica un valore da utilizzare come prefisso della chiave cache.

<Prefix>prefix_string</Prefix>

Valore predefinito:	N/D
Presenza:	Facoltativo
Tipo:	Stringa

Un elemento <Prefix> sostituisce qualsiasi elemento <Scope>.

Elemento <Scope>

Enumerazione utilizzata per creare un prefisso per una chiave della cache quando un elemento <Prefix> non viene fornito nell'elemento <CacheKey>.

<Scope>scope_enumeration</Scope>

Valore predefinito:	"Esclusivo"
Presenza:	Facoltativo
Tipo:	Stringa

L'impostazione <Scope> determina una chiave della cache anteposta in base al valore di <Scope>. Ad esempio, una chiave della cache assume il seguente formato quando l'ambito è impostato su Exclusive: orgName__envName__applicationName__proxy|TargetName__ [ serializedCacheKey ].

Se in <CacheKey> è presente un elemento <Prefix>, questo ha la precedenza su un valore dell'elemento <Scope>. I valori validi includono le enumerazioni di seguito.

Per saperne di più, consulta Utilizzo delle chiavi della cache.

Valori accettabili

`Global`	La chiave della cache è condivisa tra tutti i proxy API di cui è stato eseguito il deployment nell'ambiente. La chiave della cache viene anteposta nel formato orgName __ envName __. Se definisci una voce `<CacheKey>` con `<KeyFragment>` apiAccessToken e un ambito `<Global>`, ogni voce viene memorizzata come `orgName__envName__apiAccessToken`, seguito dal valore serializzato del token di accesso. Per un proxy API di cui è stato eseguito il deployment in un ambiente denominato "test" in un'organizzazione denominata "apifactory", i token di accesso verranno archiviati nella seguente chiave della cache: `apifactory__test__apiAccessToken`.
`Application`	Il nome del proxy API viene utilizzato come prefisso. La chiave della cache viene anteposta nel formato orgName__envName__applicationName.
`Proxy`	La configurazione ProxyEndpoint viene utilizzata come prefisso. La chiave della cache viene anteposta nel formato orgName__envName__applicationName__proxyEndpointName .
`Target`	La configurazione TargetEndpoint viene utilizzata come prefisso. Chiave della cache anteposta nel formato orgName__envName__applicationName__targetEndpointName .
`Exclusive`	Predefinito. Si tratta dell'opzione più specifica e quindi presenta un rischio minimo di collisioni di spazi dei nomi all'interno di una determinata cache. Il prefisso può avere due forme: Se il criterio è collegato al flusso `ProxyEndpoint`, il prefisso ha la forma ApiProxyName_ProxyEndpointName. Se il criterio è collegato a `TargetEndpoint`, il prefisso ha il formato ApiProxyName_TargetName. Chiave della cache anteposta nel modulo orgName__envName__applicationName__proxyNameITargetName Ad esempio, la stringa completa potrebbe avere il seguente aspetto: apifactory__test__weatherapi__default__apiAccessToken .

Note sull'utilizzo

Utilizza questo criterio per la memorizzazione nella cache per uso generico. In fase di runtime, la norma LookupCache recupera un valore dalla cache, assegnandolo alla variabile specificata con l'elemento AssignTo (se non viene recuperato alcun valore, la variabile non verrà impostata). Cerca il valore in base a una chiave della cache creata tramite la configurazione che combina gli elementi CacheKey e Scope. In altre parole, per recuperare un determinato valore aggiunto alla cache da una policy PopulateCache, la policy LookupCache deve avere elementi correlati alla chiave della cache configurati nello stesso modo della policy PopulateCache.

La memorizzazione nella cache per uso generico con i criteri PopulateCache, LookupCache e InvalidateCache utilizza una cache che configuri o una cache condivisa inclusa per impostazione predefinita. Nella maggior parte dei casi, la cache condivisa sottostante dovrebbe soddisfare le tue esigenze. Per utilizzare la cache predefinita, ometti l'elemento <CacheResource>.

Per saperne di più sulla configurazione delle cache, consulta la sezione Memorizzazione nella cache per scopi generali. Per saperne di più sul datastore sottostante, consulta Elementi interni della cache.

Variabili di flusso

Le variabili di flusso possono essere utilizzate per configurare il comportamento di runtime dinamico per criteri e flussi, in base alle intestazioni HTTP o al contenuto dei messaggi oppure al contesto disponibile nel flusso. Per ulteriori informazioni sulle variabili di flusso, consulta Riferimento alle variabili di flusso.

Le seguenti variabili di flusso predefinite sono disponibili dopo aver personalizzato il comportamento della cache definita in un criterio LookupCache.

Variabili	Tipo	Autorizzazione	Descrizione
lookupcache.{policy-name}.cachename	Stringa	Sola lettura	Restituisce il nome della cache utilizzato nel criterio.
lookupcache.{policy-name}.cachekey	Stringa	Sola lettura	Restituisce la chiave utilizzata.
lookupcache.{policy-name}.cachehit	Booleano	Sola lettura	Vero se il criterio ha trovato un valore per la chiave della cache specificata.
lookupcache.{policy-name}.assignto	Stringa	Sola lettura	Restituisce la variabile a cui è assegnata la cache.

Codici di errore

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.

Error name	Cause	Fix
`InvalidCacheResourceReference`	This error occurs if the `<CacheResource>` element is set to a name which does not exist in the environment where the API proxy is being deployed.
`InvalidTimeout`	If the `<CacheLookupTimeoutInSeconds>` element is set to a negative number, then the deployment of the API proxy fails.
`CacheNotFound`	This error occurs if the specific cache mentioned in the error message has not been created on a specific Message Processor component.

Fault variables

N/A

Example error response

N/A