API Memcache per servizi legacy in bundle

Questa pagina fornisce una panoramica del servizio memcache di App Engine. Le applicazioni web scalabili ad alte prestazioni spesso utilizzano una cache di dati in memoria distribuita davanti o al posto di un'archiviazione persistente solida per alcune attività. Per app Engine include un servizio di cache di memoria per questo scopo. Per scoprire come per configurare, monitorare e utilizzare il servizio memcache. Vedi Utilizzo di Memcache.

Nota: la cache è globale e viene condivisa tra il frontend, il backend e tutti i servizi e le versioni dell'applicazione.

Questa API è supportata per runtime di prima generazione e può essere utilizzata quando eseguire l'upgrade ai runtime di seconda generazione corrispondenti. Se esegui l'aggiornamento ad App Engine 8/7 PHP runtime, consulta guida alla migrazione per saperne di più sulle opzioni di migrazione per i servizi in bundle legacy.

Quando utilizzare una cache in memoria

Un utilizzo di una cache di memoria è quello di velocizzare le query più comuni sul datastore. Se molti effettuano la stessa query con gli stessi parametri e apportano modifiche non devono apparire subito sul sito web, l'applicazione può memorizzare nella cache i risultati in memcache. Le richieste successive possono controllare memcache, ed eseguire la query sul datastore solo se i risultati sono assenti o scaduti. Dati di sessione, preferenze utente e altri dati restituiti dalle query per le pagine web sono buoni candidati per la memorizzazione nella cache.

Memcache può essere utile per altri valori temporanei. Tuttavia, se consideriamo se memorizzare un valore esclusivamente in memcache e non è supportato da altri di archiviazione permanente, devi assicurarti che l'applicazione si comporti in modo accettabile quando è improvvisamente disponibile. I valori possono scadere dalla cache in qualsiasi momento e può essere scaduta prima della scadenza impostata per il valore. Per Ad esempio, se l'assenza improvvisa di dati della sessione di un utente causa la potrebbero non funzionare correttamente, è probabile che i dati vengano archiviati nel datastore in aggiunta nella memoria cache.

Livelli di servizio

App Engine supporta due livelli del servizio memcache:

• Memcache condivisa è l'impostazione predefinita gratuita per le applicazioni App Engine. it fornisce capacità di cache secondo il criterio del "best effort" ed è soggetta alle modifiche generali la domanda di tutte le applicazioni App Engine che usano il servizio memcache condiviso.

• Memcache dedicata fornisce una capacità della cache fissa assegnata in modo esclusivo alla tua applicazione. La fatturazione avviene in base alle dimensioni della cache in GB/h e richiede l'attivazione della fatturazione. Avere il controllo sulle dimensioni della cache consente all'app di funziona in modo più prevedibile e con meno letture da più costosi durevoli archiviazione.

Entrambi i livelli di servizio memcache utilizzano la stessa API. Per configurare il servizio memcache per la tua applicazione, consulta Utilizzo di Memcache.

Nota: sia condivisa che dedicata, memcache non è uno spazio di archiviazione durevole. Le chiavi possono essere rimossa quando la cache si riempie, in base al criterio LRU della cache. Modifiche della configurazione della cache o eventi di manutenzione del data center, o tutta la cache.

La tabella seguente riassume le differenze tra le due classi del servizio memcache:

Funzionalità	Memcache dedicata	Memcache condivisa
Prezzo	0,06 $ per GB all'ora	Gratis
Capacità	us-central Da 1 a 100 GB asia-northeast1, europe-west, europe-west3 e us-east1: Da 1 a 20 GB altre regioni: Da 1 a 2 GB	Capacità non garantita
Prestazioni	Fino a 10.000 letture o 5.000 scritture (esclusive) al secondo per GB (elementi < 1 kB). Per ulteriori dettagli, consulta Statistiche della cache.	Non garantito
Negozio durevole	No	No
SLA	Nessuno	Nessuno

La fatturazione con memcache dedicata viene addebitata per incrementi di 15 minuti. Se la valuta utilizzata per il pagamento è diversa da USD, si applicano i prezzi elencati nella tua valuta negli SKU di Cloud Platform.

Se l'app ha bisogno di maggiore capacità memcache, contatta il nostro team di vendita.

Limiti

Per l'utilizzo del servizio memcache si applicano i seguenti limiti:

• La dimensione massima di un valore dei dati memorizzati nella cache è 1 MiB (2^20 byte) meno la dimensione della chiave meno una l'overhead dipendente dall'implementazione, che è di circa 73 byte.
• Una chiave non può essere più grande più di 250 byte. Nel runtime di PHP, se provi a impostare memcache con un token chiave, la chiamata genererà un'eccezione. (Altri runtime si comportano differently.)
• Il "multi" le operazioni batch possono avere un numero qualsiasi di elementi. La dimensione totale della chiamata e la dimensione totale dei dati recuperati non deve superare i 32 megabyte.
• Una chiave memcache non può contenere un byte nullo.

Consigli e best practice

Quando utilizzi Memcache, ti consigliamo di progettare le tue applicazioni in modo che:

• Gestisci il caso in cui un valore memorizzato nella cache non sia sempre disponibile.

  • Memcache non è uno spazio di archiviazione durevole. In base alle criterio di rimozione, le chiavi vengono rimosse quando si riempie di cache. Anche le modifiche alla configurazione della cache o agli eventi di manutenzione del datacenter possono svuotare la cache in parte o del tutto.
  • Memcache potrebbe essere temporaneamente indisponibilità. Operazioni memcache potrebbero non riuscire per vari motivi, tra cui modifiche alla configurazione della cache degli eventi di manutenzione dei data center. Le applicazioni devono essere progettate per rilevare le operazioni non riuscite senza esporre questi errori agli utenti finali. Questo queste indicazioni si applicano in particolare alle operazioni di impostazione.

• Se possibile, utilizza la funzionalità di raggruppamento in batch dell'API.

  • In questo modo, aumenterai le prestazioni e l'efficienza della tua app, soprattutto per gli elementi di piccole dimensioni.

• Distribuisci il carico nello spazio chiavi di memcache.

  • Avere un singolo o un piccolo insieme di elementi memcache rappresenta un Una quantità sproporzionata di traffico ostacolerà la scalabilità della tua app. Queste linee guida si applicano sia alle operazioni al secondo sia alla larghezza di banda. Puoi spesso possono mitigare questo problema eseguendo lo sharding esplicito dei dati.

    Ad esempio, puoi suddividere un contatore aggiornato di frequente tra più i tasti, rileggendoli e poi sommando solo quando serve un totale. Allo stesso modo, puoi suddividere un dato di 500.000 che deve essere letto ogni richiesta HTTP su più chiavi e rileggerele utilizzando un'unica chiamata API batch. Ancora meglio sarebbe memorizzare nella cache il valore dell'istanza memory.) Per memcache dedicata, la frequenza di accesso di picco su una singola chiave Deve essere di 1-2 ordini di grandezza inferiori alla classificazione per GB.

• Conserva le tue chiavi per recuperare valori dalla cache.

  • Memcache non fornisce un metodo per elencare le chiavi. A causa della natura cache, non è possibile elencare le chiavi senza interrompere la cache. Inoltre, alcuni linguaggi come Python, chiavi hash lunghe e sono note solo all'applicazione.

Implementazione di memcache PHP

App Engine include implementazioni dello standard Memcache e API Memcached, che richiamano Servizio memcache di App Engine "in background". Alcune funzioni sono richiamabili ("stubbed", ma non fanno nulla, in quanto non sono necessari nel contesto di un'app dell'app Engine. Di conseguenza, le chiamate alle seguenti funzioni vengono ignorate:

Funzioni parziali nell'API Memcache

• memcache_add_server()
• memcache_close()
• memcache_connect()
• memcache_pconnect()
• memcache_set_compress_threshold()
• addServer()
• close()
• connect()
• pconnect()
• setCompressThreshold()

Funzioni parziali nell'API Memcached

• addServer()
• addServers()
• getAllKeys()
• getServerByKey()
• getServerList()
• getStats()
• getVersion()
• isPersistent()
• isPristine()
• quit()
• resetServerList()
• setSaslAuthData()

Esempio di utilizzo dell'API Memcache PHP in App Engine:

$memcache = new Memcache;
return $memcache->get($key);

Esempio di utilizzo dell'API Memcached PHP in App Engine:

$memcache = new Memcached;
$memcache->set('who', $request->get('who'));
return $twig->render('memcache.html.twig', [
    'who' => $request->get('who'),
    'count' => $memcache->increment('count', 1, 0),
    'host' => $request->getHost(),
]);

Come vengono scaduti i dati memorizzati nella cache

Memcache contiene coppie chiave/valore. Le coppie in memoria cambiano in qualsiasi momento vengono scritti e recuperati dalla cache.

Per impostazione predefinita, i valori archiviati in memcache vengono conservati il più a lungo possibile. Valori può essere rimosso dalla cache quando un nuovo valore viene aggiunto alla cache di memoria cache insufficiente. Quando i valori vengono rimossi a causa della pressione di memoria, i valori utilizzati meno di recente vengono eliminati per primi.

L'app può fornire una scadenza quando un valore viene archiviato, come numero di secondi in relazione a quando viene aggiunto il valore o come valore Unix assoluto dell'epoca nel futuro (numero di secondi a partire dalla mezzanotte del 1° gennaio, 1970). Il valore viene rimosso non più tardi di questo momento, anche se può essere rimosso in precedenza per altri motivi. L'incremento del valore memorizzato per una chiave esistente non aggiorna la data e l'ora di scadenza.

In rari casi, i valori possono scomparire dalla cache anche prima del per motivi diversi dalla pressione della memoria. Sebbene memcache sia resiliente a errori del server, i valori memcache non vengono salvati su disco, pertanto un errore del servizio i valori potrebbero non essere più disponibili.

In generale, un'applicazione non dovrebbe aspettarsi che un valore memorizzato nella cache sia sempre disponibili.

Puoi cancellare l'intera cache di un'applicazione tramite l'API o in memcache della console Google Cloud.

Nota: la rimozione effettiva dei dati della cache scaduti viene gestita in modo lazy. Un elemento scaduto viene rimosso quando qualcuno tenta di recuperarlo senza successo. In alternativa, i dati scaduti della cache escono dalla cache in base al comportamento della cache LRU, che si applica a tutti gli articoli, sia attivi sia scaduti. Ciò significa che quando la dimensione viene riportata nelle statistiche, il numero può includere elementi attivi e scaduti.

Statistiche cache

Operazioni al secondo per dimensione articolo

Nota: queste informazioni si applicano solo a memcache dedicato.

La memcache dedicata è valutata in operazioni al secondo per GB, dove un'operazione è definita come accesso a un singolo elemento della cache, ad esempio get,set o delete. La frequenza operativa varia in base alle dimensioni dell'articolo in base alla tabella seguente. Il superamento di queste classificazioni potrebbe comportare un aumento della latenza o degli errori dell'API.

Le tabelle seguenti forniscono il numero massimo di eventi esclusivi supportati get-hit o set operazioni per GB di cache. Tieni presente che un'operazione get-hit è una chiamata get che rileva la presenza di un valore memorizzato con la chiave specificata e lo restituisce.

Dimensioni articolo (kB)	Massimo get-hit op/s	Massimo set op/s
≤1	10.000	5000
100	2000	1000
512	500	250

Teoricamente, un'app configurata per più GB di cache può ottenere un'aggregazione operativa calcolata moltiplicando il numero di GB per la tariffa per GB. Ad esempio, un'app configurata per 5 GB di cache potrebbe raggiungere 50.000 memcache operazioni/sec su elementi da 1 kB. Per raggiungere questo livello è necessaria una buona distribuzione di carico attraverso lo spazio delle chiavi memcache.

Per ogni pattern IO, i limiti elencati sopra si riferiscono alle letture o scrive. Per letture e scritture simultanee, i limiti si trovano su un foglio su larga scala. Più letture vengono eseguite, meno scrittura è possibile eseguire e viceversa. Ciascuno dei seguenti è un esempio di IOP limiti per letture e scritture simultanee di valori di 1 kB per 1 GB di cache:

Lettura IOP	Scrittura IOP
10000	0
8000	1000
5000	2500
1000	4500
0	5000

Unità di calcolo memcache (MCU)

Nota: queste informazioni si applicano solo a memcache dedicato.

La velocità effettiva di Memcache può variare a seconda delle dimensioni dell'elemento a cui si accede e l'operazione che vuoi eseguire sull'elemento. Puoi associare approssimativamente un valore sui costi delle operazioni e stimare la capacità di traffico che puoi aspettarti una memcache dedicata utilizzando un'unità denominata Memcache Compute Unit (MCU). MCU è definita tale che puoi aspettarti 10.000 MCU al secondo per GB di memcache. La console Google Cloud mostra la quantità di MCU attualmente utilizzata dalla tua app.

Tieni presente che l'MCU è una stima statistica approssimativa e non è un'unità lineare. Ogni operazione di cache che legge o scrive un valore ha una MCU corrispondente a un costo che dipende dalla dimensione del valore. L'MCU di un set dipende da dimensione del valore: il doppio del costo di un'operazione get-hit riuscita.

Nota: il modo in cui le unità di calcolo Memcache (MCU) sono soggette a modifiche.

Dimensione elemento valore (kB)	Costo di MCU per get-hit	Costo di MCU per set
≤1	1,0	2.0
2	1.3	2,6
10	1,7	3.4
100	5,0	10,0
512	20,0	40,0
1024	50,0	100,0

Le operazioni che non leggono o scrivono un valore hanno un costo di MCU fisso:

Operazione	MCU
get-miss	1,0
delete	2.0
increment	2.0
flush	100,0
stats	100,0

Tieni presente che un'operazione get-miss è un get che rileva che non è presente alcun valore con la chiave specificata.

Passaggi successivi

• Scopri come configurare, monitorare e utilizzare memcache in Utilizzo di Memcache.