Upstash è un database Redis completamente gestito come servizio. Upstash funziona con l'API Redis®, il che significa che puoi usare il client Redis nativo di Bun per connetterti al tuo database Upstash.

NOTE

TLS è abilitato per impostazione predefinita per tutti i database Redis Upstash.

---

Creare un nuovo progetto

Crea un nuovo progetto eseguendo bun init:

bun init bun-upstash-redis
cd bun-upstash-redis

Creare un database Redis Upstash

Vai al dashboard Upstash e crea un nuovo database Redis. Dopo aver completato la guida introduttiva, vedrai la pagina del tuo database con le informazioni di connessione.

La pagina del database mostra due metodi di connessione: HTTP e TLS. Per il client Redis di Bun, hai bisogno dei dettagli di connessione TLS. Questo URL inizia con rediss://.

Connettersi usando il client Redis di Bun

Puoi connetterti a Upstash impostando le variabili d'ambiente con il client redis predefinito di Bun.

Imposta la variabile d'ambiente REDIS_URL nel tuo file .env usando l'endpoint Redis (non l'URL REST):

REDIS_URL=rediss://********@********.upstash.io:6379

Il client Redis di Bun legge le informazioni di connessione da REDIS_URL per impostazione predefinita:

import { redis } from "bun";

// Legge da process.env.REDIS_URL automaticamente
await redis.set("counter", "0"); 

In alternativa, puoi creare un client personalizzato usando RedisClient:

import { RedisClient } from "bun";

const redis = new RedisClient(process.env.REDIS_URL); 

Usare il client Redis

Ora puoi usare il client Redis per interagire con il tuo database Redis Upstash:

import { redis } from "bun";

// Ottieni un valore
let counter = await redis.get("counter");

// Imposta un valore se non esiste
if (!counter) {
	await redis.set("counter", "0");
}

// Incrementa il contatore
await redis.incr("counter");

// Ottieni il valore aggiornato
counter = await redis.get("counter");
console.log(counter);

1

Il client Redis gestisce automaticamente le connessioni in background. Non è necessario connettersi o disconnettersi manualmente per le operazioni di base.