Utilizzo di memcache

Questa pagina descrive come configurare e monitorare il servizio memcache per la tua applicazione utilizzando la console Google Cloud. Descrive inoltre come utilizzare l'API Python memcache di App Engine per impostare e recuperare i valori memorizzati nella cache e utilizzare la funzionalità di confronto e impostazione per gestire le richieste di scrittura simultanee alla stessa chiave memcache. Per saperne di più su memcache, consulta la Panoramica di Memcache.

Configurazione di memcache

  1. Vai alla pagina Memcache nella console Google Cloud.
    Vai alla pagina Memcache

  2. Seleziona il livello di servizio memcache che vuoi utilizzare:

    • Condivisa (impostazione predefinita): gratuita e fornisce capacità della cache secondo il criterio del "best effort".
    • Dedicata: viene fatturata in base ai GB/ora di dimensione della cache e offre una capacità della cache fissa assegnata esclusivamente alla tua applicazione.

    Scopri di più sulle classi di servizio disponibili nella Panoramica di Memcache.

Memorizzazione nella cache e recupero dei valori

Memorizzazione nella cache di un valore

Utilizza add() per aggiungere il valore di una chiave se e solo se non esiste già, con un valore facoltativo della data di scadenza:

memcache.add(key="[KEY]", value="[VALUE]", time=[EXPIRATION_TIME])

Ad esempio, per aggiungere il valore raining alla chiave weather_USA_98105 con un tempo di scadenza di un'ora dal momento in cui viene scritto il valore:

memcache.add(key="weather_USA_98105", value="raining", time=3600)

Scopri di più su add() e su altri metodi per impostare i valori nella documentazione dell'API Python di memcache.

Consulta altri esempi di memorizzazione nella cache dei valori in Esempi di memcache.

Ricerca dei valori memorizzati nella cache

Utilizza get() per cercare il valore di una singola chiave:

memcache.get(key="[KEY]")

Ad esempio, per ottenere il valore della chiave weather_USA_98105:

memcache.get(key="weather_USA_98105")

Scopri di più su get() e su altri metodi per cercare i valori nella documentazione dell'API Python memcache.

Monitoraggio di Memcache nella console Google Cloud

  1. Vai alla pagina Memcache nella console Google Cloud.
    Vai alla pagina Memcache
  2. Esamina i seguenti report:
    • Livello di servizio memcache: indica se la tua applicazione utilizza il livello di servizio condiviso o dedicato. Se sei un proprietario del progetto, puoi passare da una modalità all'altra. Scopri di più sui livelli di servizio.
    • Rapporto hit: mostra la percentuale di richieste di dati che sono state soddisfatte dalla cache, nonché il numero non elaborato di richieste di dati che sono state soddisfatte dalla cache.
    • Elementi nella cache.
    • Età elemento più vecchio: l'età dell'elemento meno recente memorizzato nella cache. Tieni presente che l'età di un elemento viene reimpostata ogni volta che viene utilizzato, letto o scritto.
    • Dimensione cache totale.

  3. Puoi eseguire una delle seguenti azioni:

    • Nuova chiave: aggiungi una nuova chiave alla cache.
    • Trova una chiave: recupera una chiave esistente.
    • Svuota cache: rimuovi tutte le coppie chiave-valore dalla cache.

  4. (Solo memcache dedicata) Consulta l'elenco delle Chiavi calde.

    • Le "Chiavi calde" sono chiavi che ricevono più di 100 query al secondo (QPS) nel memcache.
    • Questo elenco include fino a 100 tasti di scelta rapida, ordinati in base alla QPS più alta.

Gestione delle scritture simultanee

Per utilizzare la funzionalità di confronto e impostazione per gestire le scritture da più richieste alla stessa chiave memcache:

  1. Crea un oggetto memcache Client.
  2. Utilizza un ciclo di ripetizione (preferibilmente con un limite al numero di ripetizioni e utilizzando il backoff esponenziale)
    1. All'interno del loop di ripetizione, recupera la chiave utilizzando gets() o get_multi() con il parametro for_cas impostato su True.
    2. All'interno del loop di ripetizione, aggiorna il valore della chiave utilizzando cas() o cas_multi().

Il seguente snippet mostra un modo per utilizzare la funzionalità Confronta e imposta:

def bump_counter(key):
   client = memcache.Client()
   while True: # Retry loop
     counter = client.gets(key)
     if counter is None: raise KeyError('Uninitialized counter')
     if client.cas(key, counter+1):
        break

Il ciclo di ripetizione è necessario perché senza il ciclo questo codice non evita effettivamente le condizioni di gara, ma le rileva. Il servizio memcache garantisce che, se utilizzato nel pattern mostrato qui (ovvero utilizzando gets() e cas()), se due (o più) istanze client diverse sono coinvolte in una condizione di gara, solo la prima che esegue l'operazione cas() ha esito positivo (restituisce True), mentre la seconda (e quelle successive) non va a buon fine (restituisce False).

Un altro perfezionamento da aggiungere a questo codice campione è impostare un limite sul numero di tentativi, per evitare un ciclo infinito negli scenari peggiori in cui esistono molte contese per lo stesso contatore. Un esempio di quando potrebbe verificarsi una situazione di contesa è se ci sono più richieste che tentano di aggiornare il contatore di quante il servizio memcache può elaborare in tempo reale.

Scopri di più su confronta e imposta nella Panoramica di Memcache.

Passaggi successivi