Condividi tramite

Aggiungere le memorizzazione nella cache per migliorare le prestazioni in Gestione API di Azure

  • Articolo

SI APPLICA A: Sviluppatore | Basic | Basic v2 | Standard | Standard v2 | Premium | Premium v2

Le API e le operazioni in Gestione API possono essere configurate con la memorizzazione nella cache delle risposte. La memorizzazione nella cache delle risposte può ridurre significativamente la latenza per i chiamanti di API e il carico back-end per i provider di API.

Importante

La cache predefinita è volatile e viene condivisa da tutte le unità nella stessa area nello stesso servizio Gestione API. Indipendentemente dal tipo di cache usato (interno o esterno), se le operazioni correlate alla cache non riescono a connettersi alla cache a causa della volatilità della cache o per qualsiasi altro motivo, la chiamata API che usa l'operazione correlata alla cache non genera un errore e l'operazione della cache viene completata correttamente. Nel caso di un'operazione di lettura, viene restituito un valore Null all'espressione del criterio chiamante. Il codice dei criteri deve essere progettato per garantire che sia presente un meccanismo di "fallback" per recuperare i dati non trovati nella cache. Per informazioni più dettagliate sulla memorizzazione nella cache, vedere Criteri di memorizzazione nella cache in Gestione API e Memorizzazione nella cache personalizzata in Gestione API di Azure.

Criteri della cache

Contenuto dell'esercitazione:

  • Aggiungere la memorizzazione delle risposte nella cache per l'API
  • Verificare il funzionamento della memorizzazione nella cache

Nota

La cache interna non è disponibile nel livello A consumo di Gestione API di Azure. È possibile usare una cache di Azure per Redis esterna. È anche possibile configurare una cache esterna in altri livelli di servizio Gestione API.

Prerequisiti

Per completare questa esercitazione:

Aggiungere i criteri di memorizzazione nella cache

Con i criteri di memorizzazione nella cache illustrati in questo esempio, la prima richiesta a un'operazione di test restituisce una risposta dal servizio back-end. Questa risposta viene memorizzata nella cache, associata a una chiave in base alle intestazioni e ai parametri delle stringhe di query specifici. Le chiamate successive all'operazione, con i parametri corrispondenti, riceveranno la risposta memorizzata nella cache finché non scade l'intervallo di durata della cache.

  1. Accedere al portale di Azure.

  2. Passare all'istanza di Gestione API.

  3. Selezionare API API> dal menu a sinistra.

  4. Selezionare un'API per cui si vuole configurare la memorizzazione nella cache.

  5. Nella parte superiore della schermata selezionare la scheda Progettazione.

  6. Nella sezione Elaborazione in ingresso selezionare l'icona </>. Screenshot dell'editor dei criteri Gestione API nel portale.

  7. Nell'elemento inbound aggiungere i criteri seguenti:

    <cache-lookup vary-by-developer="false" vary-by-developer-groups="false">
    <vary-by-header>Accept</vary-by-header>
    <vary-by-header>Accept-Charset</vary-by-header>
    <vary-by-header>Authorization</vary-by-header>
</cache-lookup>

  8. Nell'elemento outbound aggiungere i criteri seguenti:

    <cache-store duration="20" />

    In questo criterio, duration specifica l'intervallo di scadenza delle risposte memorizzate nella cache. In questo esempio l'intervallo è di 20 secondi.

Suggerimento

Se si usa una cache esterna, come descritto in Usare una cache Redis esterna in Gestione API di Azure, è possibile specificare l'attributo caching-type dei criteri di memorizzazione nella cache. Vedere Criteri di memorizzazione nella cache in Gestione API per altri dettagli.

Chiamare un'operazione e testare la memorizzazione nella cache

Per visualizzare la memorizzazione nella cache in azione, chiamare un'operazione dal portale.

  1. Nella portale di Azure passare all'istanza di Gestione API.
  2. Selezionare API API> dal menu a sinistra.
  3. Selezionare l'API a cui sono stati aggiunti i criteri di memorizzazione nella cache.
  4. Selezionare un'operazione da testare.
  5. Selezionare la scheda Test nel menu in alto a destra.
  6. Selezionare Traccia due o tre volte in successione rapida.
  7. In Risposta HTTP selezionare la scheda Traccia .
  8. Passare alla sezione In ingresso e scorrere fino al cache-lookup criterio. Verrà visualizzato un messaggio simile a quello nello screenshot seguente, che indica un riscontro nella cache: Screenshot della ricerca nella cache durante il test di un'API nel portale.

Contenuto correlato