Utilizzo di memcache

Questa pagina descrive come configurare e monitorare il servizio memcache per la tua applicazione utilizzando la Google Cloud console. Descrive anche come utilizzare l'API Go di memcache di App Engine per impostare e recuperare i valori memorizzati nella cache. Per scoprire di più su memcache, consulta la Panoramica di memcache.

Configurare memcache

  1. Vai alla pagina Memcache nella Google Cloud console.
    Vai alla pagina Memcache
  2. Seleziona il livello di servizio memcache che vuoi utilizzare:
    • Condiviso (impostazione predefinita): è senza costi e fornisce capacità della cache al meglio delle possibilità.
    • Dedicato : la fatturazione avviene in base alle GB-ore di dimensione della cache e fornisce una capacità della cache fissa assegnata esclusivamente alla tua applicazione.

Scopri di più sulle classi di servizi disponibili nella Panoramica di memcache.

Importare l'API Go

Per importare il pacchetto memcache:

import "google.golang.org/appengine/v2/memcache"

Per ulteriori requisiti di configurazione, consulta Installare l'SDK dei servizi App Engine per Go.

Memorizzare nella cache e recuperare i valori

Memorizzare un valore nella cache

Utilizza Add() per scrivere un valore per una chiave se e solo se non esiste già un valore per la chiave:

item := &memcache.Item{
        Key:   "[KEY]",
        Value: []byte("[VALUE]"),
}
memcache.Add(c, item)

dove c è un appengine.Context.

Scopri di più su Add e altre funzioni per impostare i valori nel Riferimento API di Memcache.

Cercare i valori memorizzati nella cache

Utilizza Get() per ottenere l'elemento per una determinata chiave:

memcache.Get(ctx, "[KEY]")

Scopri di più su Get e altre funzioni per cercare i valori nel Riferimento API di Memcache.

Esempio

Il seguente esempio mostra come aggiungere, impostare e ottenere i valori di Memcache utilizzando l'API Go.

Supponiamo che ctx sia un appengine.Context.

// Create an Item
item := &memcache.Item{
	Key:   "lyric",
	Value: []byte("Oh, give me a home"),
}
// Add the item to the memcache, if the key does not already exist
if err := memcache.Add(ctx, item); err == memcache.ErrNotStored {
	log.Infof(ctx, "item with key %q already exists", item.Key)
} else if err != nil {
	log.Errorf(ctx, "error adding item: %v", err)
}

// Change the Value of the item
item.Value = []byte("Where the buffalo roam")
// Set the item, unconditionally
if err := memcache.Set(ctx, item); err != nil {
	log.Errorf(ctx, "error setting item: %v", err)
}

// Get the item from the memcache
if item, err := memcache.Get(ctx, "lyric"); err == memcache.ErrCacheMiss {
	log.Infof(ctx, "item not in the cache")
} else if err != nil {
	log.Errorf(ctx, "error getting item: %v", err)
} else {
	log.Infof(ctx, "the lyric is %q", item.Value)
}

Monitorare memcache nella Google Cloud console

  1. Vai alla pagina Memcache nella Google Cloud console.
    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 il proprietario del progetto, puoi passare da uno all'altro. Scopri di più sui livelli di servizio.
    • Percentuale di hit: mostra la percentuale di richieste di dati gestite da la cache, nonché il numero di richieste di dati gestite dalla cache.
    • Elementi nella cache.
    • Età elemento più vecchio: l'età dell'elemento memorizzato nella cache meno recente. Tieni presente che l'età di un elemento viene reimpostata ogni volta che viene utilizzato, in lettura o in scrittura.
    • 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 dedicato) Esamina l'elenco delle chiavi attive.

    • Le "chiavi attive" sono chiavi che ricevono più di 100 query al secondo (QPS) in memcache.
    • Questo elenco include fino a 100 chiavi attive, ordinate in base al QPS più alto.

Passaggi successivi