Aggiunta di Individuazione automatica alla libreria del client - Amazon ElastiCache

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiunta di Individuazione automatica alla libreria del client

Le informazioni di configurazione per Individuazione automatica vengono archiviate in modo ridondante in ogni nodo del cluster di cache. Le applicazioni client possono eseguire la query di qualsiasi nodo di cache e ottenere le informazioni di configurazione per tutti i nodi nel cluster.

Il modo utilizzato dall'applicazione dipende dalla versione del motore della cache:

  • Se la versione del motore della cache è 1.4.14 o successive, utilizza il comando config.

  • Se la versione del motore della cache è precedente alla 1.4.14, utilizza il comando get AmazonElastiCache:cluster.

I risultati di questi due comandi sono identici e vengono descritti nella sezione Formato di output sottostante.

Versione del motore della cache 1.4.14 o successiva

Per versioni del motore della cache 1.4.14 o successive, utilizza il comando config. Questo comando è stato aggiunto ai protocolli ASCII e binario Memcached da ElastiCache e viene implementato nel Client del cluster ElastiCache . Se desideri utilizzare Individuazione automatica con un'altra libreria client, allora sarà necessario espandere tale libreria per supportare il comando config.

Nota

La documentazione seguente è relativa al protocollo ASCII; tuttavia, il comando config supporta ASCII e binario. Se desideri aggiungere il support per Identificazione automatica utilizzando il protocollo binario, fai riferimento al codice fonte per il Client del cluster ElastiCache.

Sintassi

config [sub-command] [key]

Opzioni

Nome Descrizione Obbligatorio
sub-command

Il sottocomando utilizzando per interagire con un nodo di cache. Per Individuazione automatica, questo sottocomando è get.

key

La chiave sotto cui viene archiviata la configurazione cluster. Per Individuazione automatica, questa chiave è denominata cluster.

Per ottenere le informazioni di configurazione del cluster, utilizza il seguente comando:

config get cluster

Versione del motore della cache precedente a 1.4.14

Per ottenere le informazioni di configurazione del cluster, utilizza il seguente comando:

get AmazonElastiCache:cluster
Nota

Non manomettere la chiave "AmazonElastiCache:cluster", poiché essa contiene le informazioni di configurazione del cluster. Se questa chiave viene sovrascritta, è possibile che il client sia erroneamente configurato per un breve periodo di tempo (non più di 15 secondi) prima che ElastiCache aggiorni automaticamente e correttamente le informazioni di configurazione.

Formato di output

A prescindere che utilizzi config get cluster o get AmazonElastiCache:cluster, la risposta è costituita sempre da due righe:

  • Il numero di versione delle informazioni di configurazione. Ogni volta che si aggiunge o rimuove un nodo dal cluster di cache, il numero di versione viene incrementato di uno.

  • Un elenco di nodi di cache. Ogni nodo nell'elenco è rappresentato da un gruppo hostname|ip-address|port e ogni nodo è delimitato da uno spazio.

Alla fine di ciascuna riga vengono visualizzati un carattere di ritorno a capo e un carattere di avanzamento riga (CR + LF). La riga di dati contiene un carattere di avanzamento riga (LF) alla fine, cui viene aggiunto CR + LF. La riga di versione config è terminata da LF senza CR.

Un cluster di cache contenente tre nodi viene rappresentato come riportato di seguito:

configversion\n hostname|ip-address|port hostname|ip-address|port hostname|ip-address|port\n\r\n

Ogni nodo viene mostrato con il CNAME e l'indirizzo IP privato. Il CNAME è sempre presente; se l'indirizzo IP privato non è disponibile, non verrà visualizzato; tuttavia, i caratteri pipe "|" verranno ancora stampati.

Esempio

Di seguito è riportato un esempio del payload restituito quando si esegue la query delle informazioni di configurazione:

CONFIG cluster 0 136\r\n 12\n myCluster.pc4ldq.0001.use1.cache.amazonaws.com|10.82.235.120|11211 myCluster.pc4ldq.0002.use1.cache.amazonaws.com|10.80.249.27|11211\n\r\n END\r\n
Nota
  • La seconda riga indica che le informazioni di configurazione sono state modificate dodici volte finora.

  • Nella terza riga, l'elenco dei nodi è in ordine alfabetico per nome host. Questo ordinamento deve essere in una sequenza diversa da quella attualmente in uso nell'applicazione client.