Come utilizzare Redis Scan
Cos'è Redis Scan?
Come accennato, la scansione in Redis è un iteratore basato sul cursore che consente di iterare sul set di chiavi in un database Redis specifico. Il comando accetta la posizione del cursore come argomento.
Il server restituisce un cursore di aggiornamento ogni volta che viene chiamato il comando. È possibile utilizzare il cursore aggiornato come argomento nella seguente chiamata di comando.
L'iterazione inizia quando il cursore è in posizione 0 e si ferma quando il cursore proveniente dal server è a 0.
Usando la scansione - esempi
Facciamo alcuni esempi per illustrare come funziona il comando di scansione. Inizia creando una raccolta di chiavi e valori come mostrato nel comando seguente:
127.0.0.1: 6379> Key MSET1 Valore1 Key2 Valore2 TEY3 VALUE3 TEY4 VALUE4 CHIAVE5 VALORE5 CHIAVE6 VALORE6
OK
L'esempio sopra inserire un set di tasto fittizio e coppie di valori per scopi di illustrazione.
Ora che abbiamo un database con chiavi e valori, possiamo usare il comando di scansione per iterare sulle chiavi.
Il comando può essere eseguito come:
127.0.0.1: 6379> Scansione 0
1) "0"
2) 1) "Key4"
2) "RQ: finito: predefinito"
3) "Key5"
4) "Key6"
5) "Key2"
6) "Key3"
7) "RQ: code"
8) "Key1"
9) "Capitani"
Una volta eseguito il comando, iterirà sulle chiavi nel database e restituirà tutte le chiavi disponibili.
Nota: il comando di scansione restituirà solo le prime dieci chiavi nel database. Poiché il comando di scansione può recuperare i primi dieci elementi nel nostro esempio, restituisce un valore intero di 0, come mostrato sopra.
Facciamo un esempio in cui il cursore è tornato dal server non è 0. Se aggiungiamo i tasti come mostrato nel comando seguente:
Key MSET7 Valore7 Key8 Valore8 Key9 Valore9 Key10 Valore10 Key11 Valore11 Key12 Valore12
Se rientramo il comando di scansione, restituirà l'ultima posizione in cui il cursore si è fermato.
127.0.0.1: 6379> Scansione 0
1) "13"
2) 1) "Key4"
2) "Key9"
3) "RQ: finito: predefinito"
4) "Key5"
5) "Key6"
6) "Key8"
7) "Key2"
8) "Key3"
9) "Key10"
10) "Key7"
11) "RQ: code"
In questo esempio, la posizione del cursore è a 13. Possiamo usare questa posizione per scansionare i tasti rimanenti.
127.0.0.1: 6379> Scansione 13
1) "0"
2) 1) "Key11"
2) "Key1"
3) "Key12"
4) "Capitani"
Poiché il comando recupera tutte le chiavi, in questo caso, restituisce il cursore in posizione 0.
Opzioni di scansione
Il comando di scansione accetta due opzioni principali:
- CONTARE
- INCONTRO
Conteggio di scansione
Il comando COUNT consente di modificare quante chiavi il comando di scansione prenderà per chiamata. Per impostazione predefinita, il comando di scansione recupera dieci chiavi.
Tuttavia, possiamo modificarlo impostando il comando di conteggio.
127.0.0.1: 6379> Scansione 0 Conteggio 15
L'output di esempio dal comando sopra è come mostrato:
1) "0"
2) 1) "Key4"
2) "Key9"
... troncato ..
14) "Key12"
15) "Capitani"
In questo esempio, impostiamo il cursore per restituire 15 elementi anziché il valore predefinito 10. Poiché non ci sono più di 15 chiavi nel database, il server restituisce la posizione della chiave a 0.
Cancamera
L'opzione Match consente di scansionare i tasti che corrispondono a uno schema specifico. Ad esempio, per restituire tutte le chiavi abbinando K*, possiamo fare.
127.0.0.1: 6379> Scansione 0 Match K*
1) "13"
2) 1) "Key4"
2) "Key9"
3) "Key5"
4) "Key6"
5) "Key8"
6) "Key2"
7) "Key3"
8) "Key10"
9) "Key7"
Il comando sopra restituisce solo i tasti corrispondenti al modello specificato.
È possibile utilizzare le opzioni Match and Count nello stesso comando.
127.0.0.1: 6379> Scansione 0 Match K* Conteggio 15
1) "0"
2) 1) "Key4"
2) "Key9"
---Troncato---
11) "Key1"
12) "Key12"
Conclusione
Questa guida ti dà l'utilizzo delle basi e gli esempi dell'utilizzo del comando Redis Scan. La scansione consente di iterare attraverso le chiavi del database utilizzando una posizione del cursore. È possibile controllare la documentazione per ulteriori varianti di scansione.