2.3.1 - Strings
És el tipus de dades més senzill, més bàsic. Serà una cadena de caràcters de tipus binary safe en la qual normalment guardarem les habituals cadenes de caràcters, però que també podríem guardar imatges o objectes serialitzats de Java. La grandària màxima és de 512Mb.
Ara veurem els comandos més habituals que afecten a aquest tipus. Com a norma general, hem de ser conscients que els comandos no són sensibles a majúscules o minúscules, però les claus i els valors sí que ho són. És a dir, el comando get també es pot escriure GET o Get. Però la clau Hola és diferent de la clau hola.
Concretament, els comandos que veurem seran:
get , set , setex , psetex , mget , mset , append , strlen , getrange , setrange , incr , decr , incrby , decrby
Sintaxi
get clau
Torna el valor de la clau especificada, sempre que siga de tipus String. Si la clau és d'un altre tipus, donarà error. I si la clau no existeix, tornarà el valor especial nil .
Exemples
127.0.0.1:6379> get clau_1
"primera"
127.0.0.1:6379> get clau_2
(nil)
Sintaxi
set clau valor
Assigna a la clau especificada com a primer paràmetre el valor especificat com a segon paràmetre. Si el valor consta de més d'una paraula, haurà d'anar entre cometes dobles.
Redis sempre guardarà el valor com a string, encara que nosaltres pensem que li passem un valor enter o real.
I una altra característica és que si la clau existeix ja, matxacarà el seu contingut, com era de esperar.
Exemples
127.0.0.1:6379> set clau_2 segona
OK
127.0.0.1:6379> set text "Un text amb més d'una paraula"
OK
127.0.0.1:6379> set quatre 4
OK
127.0.0.1:6379> get quatre
"4"
127.0.0.1:6379> set pi 3.14159265359
OK
127.0.0.1:6379> get pi
"3.14159265359"
Nota
Si poseu algun accent, en tornar el valor (fent get) us semblarà que no s'ha guardat bé. Sí que s'haurà guardat bé, el que passa és que posteriorment no es visualitza bé en fer el get. Es pot comprovar entrant en el client amb l'opció raw , és a dir redis-cli --raw
El comando SET té una opció molt interessant, que servirà per a donar un temps de vida a la clau, transcorregut el qual desapareix la clau (amb el seu valor, clar). Açò s'anomena temps d'expiració i s'aconsegueix amb el paràmetre EX del comando SET seguit del número de segons que volem que dure la clau.
Exemple
127.0.0.1:6379> set clau_3 tercera ex 10
OK
127.0.0.1:6379> get clau_3
"tercera"
127.0.0.1:6379> get clau_3
(nil)
Primer sí que existeix, però al cap de 10 segons ha deixat d'existir.
De forma equivalent es pot expressar el temps en milisegons, amb el paràmetre PX en compte de EX.
Havíem comentat al principi, que si en el moment de fer el SET la clau ja existia, es reemplaçarà el seu contingut. Podem modificar aquest comportament amb el paràmetre NX (Not eXists): si no existia la clau, la crearà amb el valor, però si ja existia, la deixarà com estava. Ens ho indicarà dient OK en cas de crear-la i NIL en cas de no crear-la perquà ja existia.
127.0.0.1:6379> set clau_4 quarta nx
OK
127.0.0.1:6379> set clau_1 quarta nx
(nil)
127.0.0.1:6379> get clau_4
"quarta"
127.0.0.1:6379> get clau_1
"primera"
I de forma inversa, si posem el paràmetre XX, si ja existeix la clau, reemplaçarà el valor, però si no existia, no farà res.
Sintaxi
mget clau1 clau2 clauN
Torna una llista de valors, els de les claus indicades.
Exemple
127.0.0.1:6379> set mes1 gener
OK
127.0.0.1:6379> set mes2 febrer
OK
127.0.0.1:6379> set mes3 març
OK
127.0.0.1:6379> mget mes1 mes2 mes3
1) "gener"
2) "febrer"
3) "mar\xc3\xa7"
Nota
Recordeu que els caràcters com vocals accentuades, ç, ñ, ... s'han introduït bé, però potser no es visualiten bé. Es pot evitar entrant en el client d'aquesta manera redis-cli --raw
Si alguna de les claus no exiteix, tornarà nil en el seu lloc
Sintaxi
mset clau1 valor1 clau2 valor2 clauN valorN
Assigna els valors corresponents a les claus. És una operació atòmica: es posen (o canvien) tots els valors a l'hora.
127.0.0.1:6379> mset mes4 abril mes5 maig mes6 juny mes7 juliol
OK
127.0.0.1:6379> mget mes1 mes2 mes3 mes4 mes5 mes6 mes7
1) "gener"
2) "febrer"
3) "mar\xc3\xa7"
4) "abril"
5) "maig"
6) "juny"
7) "juliol"
Si no vulguérem reemplaçar valors, podríem utilitzar el comando MSETNX, totalment equivalent, però hauríem de tenir en compte que si alguna ja existeix i per tant no pot canviar el valor, no faria l'operació, és a dir, tampoc crearia les altres.
Sintaxi
append clau1 valor1
Si la clau no existeix la crea assignant-li el valor (com el SET), però si ja existeix, concatena el valor al final de la cadena que ja hi havia.
127.0.0.1:6379> append salutacio Hola
(integer) 4
127.0.0.1:6379> get salutacio
"Hola"
127.0.0.1:6379> append salutacio ", com va?"
(integer) 13
127.0.0.1:6379> get salutacio
"Hola, com va?"
Sintaxi
getrange clau1 inici final
Extrau una subcadena del valor de la clau (ha de ser de tipus String) des del número de caràcter d'inici fins al número del final (ambdós inclosos). El primer caràcter és el 0. Si posem de final un número major que l'últim, igual ho traurà fins el final.
Es poden posar també valor negatius que ens ajuden a agafar la cadena des del final. El -1 és l'últim caràcter, el -2 el penúltim, ... I es poden barrejar números positius i negatius. Així, rang 0 -1 és tota la cadena.
127.0.0.1:6379> getrange salutacio 1 3
"ola"
127.0.0.1:6379> getrange salutacio 6 50
"com va?"
127.0.0.1:6379> getrange salutacio 6 -1
"com va?"
127.0.0.1:6379> getrange salutacio -7 -5
"com"
127.0.0.1:6379> getrange salutacio 0 -1
"Hola, com va?"
Sintaxi
setrange clau1 desplaçament valor
Substitueix part del valor de la cadena, a partir del desplaçament, amb el vaolr proporcionat. No s'admenten en desplaçament valors negatius.
127.0.0.1:6379> get salutacio
"Hola, com va?"
127.0.0.1:6379> setrange salutacio 4 ". C"
(integer) 13
127.0.0.1:6379> get salutacio
"Hola. Com va?"
Sintaxi
incr clau1
A pesar de que Redis guarda els strings com a tals, com a cadenes de caràcters, en algunes ocasions és capaç de transformar la cadena a un número. És el cas del comando INCR, que converteix la cadena en un enter (si pot) i incrementa aquest valor en una unitat.
Si la clau no existeix la crea assumint que valia 0, i per tant després valdrà 1.
Si el valor de la clau no era un número enter, donarà un error.
127.0.0.1:6379> set compt1 20
OK
127.0.0.1:6379> get compt1
"20"
127.0.0.1:6379> incr compt1
(integer) 21
127.0.0.1:6379> get compt1
"21"
127.0.0.1:6379> incr compt2
(integer) 1
127.0.0.1:6379> get compt2
"1"
127.0.0.1:6379> incr clau_1
(error) ERR value is not an integer or out of range
127.0.0.1:6379> set compt3 4.25
OK
127.0.0.1:6379> incr compt3
(error) ERR value is not an integer or out of range
Sintaxi
decr clau1
Decrementa en una unitat el valor de la clau (senpre que siga un enter).
Pot agafar valors negatius.
Si la clau no existeix la crea assumint que valia 0, i per tant després valdrà -1.
127.0.0.1:6379> decr compt2
(integer) 0
127.0.0.1:6379> decr compt2
(integer) -1
127.0.0.1:6379> get compt2
"-1"
Llicenciat sota la Llicència Creative Commons Reconeixement SenseObraDerivada 4.0