Tair (Redis® OSS-Compatible):exHash

Présentation

TairHash étend le hash Redis standard avec deux fonctionnalités absentes du hash Redis natif : l'expiration par champ et le versioning par champ. Vous pouvez définir un TTL sur des champs individuels sans affecter le reste de la clé, et utiliser des numéros de version pour prévenir les écritures concurrentes conflictuelles.

TairHash utilise un algorithme d'expiration active qui vérifie et supprime proactivement les champs expirés sans affecter sensiblement le temps de réponse. Il prend également en charge l'expiration passive, qui supprime les champs expirés lors de leur accès.

Principales fonctionnalités

• Définissez une date d'expiration et un numéro de version pour chaque champ.

• Utilisez des politiques d'expiration active et passive pour les champs.

• Bénéficiez d'une syntaxe similaire au type de données hash Redis natif.

Ce module est open source. Pour plus d'informations, consultez TairHash.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Une instance Tair de l'un des types suivants :

  • Optimisée pour la mémoire

  • Optimisée pour la mémoire persistante (version mineure 1.2.6 ou ultérieure)

Maintenez votre instance à jour avec la dernière version mineure pour bénéficier de fonctionnalités supplémentaires et d'une stabilité améliorée. Consultez la rubrique Mise à jour de la version mineure. Pour les instances utilisant une architecture de cluster ou une architecture de lecture/écriture séparée, mettez également à jour les nœuds proxy, sinon certaines commandes risquent de ne pas être reconnues.

Précautions

Les commandes s'exécutent sur les données TairHash dans une instance Tair.

Commandes

Les tableaux suivants répertorient toutes les commandes TairHash, regroupées par type d'opération.

EXHSET

Options

Après avoir défini un délai d'expiration pour un champ, l'exécution d'EXHSET à nouveau sans option de délai d'expiration efface l'expiration (sauf si vous utilisez KEEPTTL). Pour définir une expiration sur la clé elle-même, utilisez la commande native EXPIRE ou EXPIREAT.

Valeurs de retour

Exemple

EXHSET myhash field1 val EX 10

(integer) 1

EXHGET

Valeurs de retour

Exemple

EXHSET myhash field1 val
EXHGET myhash field1

"val"

EXHMSET

Pour définir une expiration sur des champs individuels après leur création, utilisez EXHEXPIRE, EXHPEXPIRE, EXHEXPIREAT ou EXHPEXPIREAT. Pour définir une expiration sur la clé elle-même, utilisez la commande native EXPIRE ou EXPIREAT.

Valeurs de retour

Exemple

EXHMSET myhash field1 val1 field2 val2

OK

EXHEXPIRE

Options

Valeurs de retour

Exemple

EXHSET myhash field1 val
EXHEXPIRE myhash field1 100

(integer) 1

EXHPEXPIRE

Options

Valeurs de retour

Exemple

EXHSET myhash field1 val
EXHPEXPIRE myhash field1 1000

(integer) 1

EXHEXPIREAT

Options

Valeurs de retour

Exemple

EXHEXPIREAT myhash field1 1293840000

(integer) 1

EXHPEXPIREAT

Options

Valeurs de retour

Exemple

EXHPEXPIREAT myhash field1 1293840000000

(integer) 1

EXHTTL

Valeurs de retour

Exemple

L'exemple suivant illustre tous les états de retour possibles au sein d'une même séquence : un champ avec un TTL défini (85), et un champ sans expiration (-1).

EXHSET myhash field1 val1 EX 100
EXHSET myhash field2 val2
EXHTTL myhash field1
EXHTTL myhash field2
EXHTTL myhash field3

(integer) 85
(integer) -1
(integer) -3

EXHPTTL

Valeurs de retour

Exemple

EXHSET myhash field1 val1 EX 100
EXHPTTL myhash field1

(integer) 97213

EXHVER

Valeurs de retour

Exemple

EXHVER myhash field1

(integer) 1

EXHSETVER

Valeurs de retour

Exemple

EXHSETVER myhash field1 3

(integer) 1

EXHINCRBY

Options

Après avoir défini un délai d'expiration pour un champ, l'exécution d'EXHINCRBY sans option de délai d'expiration efface l'expiration (sauf si vous utilisez KEEPTTL ).

Valeurs de retour

Exemple

EXHMSET myhash field1 10
EXHINCRBY myhash field1 100

(integer) 110

EXHINCRBYFLOAT

Options

Après avoir défini un délai d'expiration pour un champ, l'exécution d'EXHINCRBYFLOAT sans option de délai d'expiration efface l'expiration (sauf si vous utilisez KEEPTTL ).

Valeurs de retour

Exemple

EXHMSET myhash field1 10
EXHINCRBYFLOAT myhash field1 9.235

"19.235"

EXHGETWITHVER

Valeurs de retour

Exemple

EXHGETWITHVER myhash field1

1) "19.235"
2) (integer) 5

EXHMGET

Valeurs de retour

Exemple

EXHMSET myhash field1 10 field2 var1
EXHMGET myhash field1 field2

1) "10"
2) "var1"

EXHMGETWITHVER

Valeurs de retour

Exemple

EXHMSET myhash field1 10 field2 var1
EXHMGETWITHVER myhash field1 field2

1) 1) "10"
   2) (integer) 1
2) 1) "var1"
   2) (integer) 1

EXHLEN

Options

Valeurs de retour

Exemple

EXHLEN myhash

(integer) 2

EXHEXISTS

Valeurs de retour

Exemple

EXHEXISTS myhash field1

(integer) 1

EXHSTRLEN

Valeurs de retour

Exemple

EXHSTRLEN myhash field1

(integer) 2

EXHKEYS

Valeurs de retour

Exemple

EXHMSET myhash field1 10 field2 var1
EXHKEYS myhash

1) "field1"
2) "field2"

EXHVALS

Valeurs de retour

Exemple

EXHMSET myhash field1 10 field2 var1
EXHVALS myhash

1) "10"
2) "var1"

EXHGETALL

Valeurs de retour

Exemple

EXHMSET myhash field1 10 field2 var1
EXHGETALL myhash

1) "field1"
2) "10"
3) "field2"
4) "var1"

EXHSCAN

Options

Valeurs valides pour op

Valeurs de retour

La réponse est un tableau de deux éléments :

1. Le champ de départ pour le prochain appel de parcours. Vide lorsque le parcours est terminé.

2. Les champs parcourus et leurs valeurs, entrelacés sous la forme [field, value, field, value, ...].

Renvoie un tableau vide si la clé n'existe pas.

Exemple

EXHMSET myhashkey field1 val1 field2 val2 field3 val3 field4 val4 field5 val5
EXHSCAN myhashkey ^ xx COUNT 3

1) "field4"
2) 1) "field1"
   2) "val1"
   3) "field2"
   4) "val2"
   5) "field3"
   6) "val3"

Le prochain parcours commence à partir de field4. Transmettez field4 en tant que subkey avec op >= pour continuer.

EXHDEL

Valeurs de retour

Exemple

EXHDEL myhash field1

(integer) 1

FAQ

Pourquoi exHash utilise-t-il plus de mémoire qu'un hachage Redis standard pour les mêmes données ?

Chaque champ dans TairHash stocke des métadonnées supplémentaires — l'horodatage d'expiration et le numéro de version — qu'un hachage Redis standard ne possède pas. Ces métadonnées supplémentaires par champ sont à l'origine de la consommation mémoire plus élevée.