← Cloudflare Workers / workers / databases / third-party-integrations

Upstash

Upstash ↗ je bezserverová databáze s API pro Redis* a Kafka. Upstash také nabízí QStash, frontu úloh/plánovač určený pro bezserverové prostředí.

Chcete-li nastavit integraci se službou Upstash:

1. Potřebujete existující databázi Upstash, ke které se připojíte. Vytvořte databázi Upstash ↗ nebo načíst data z existující databáze do Upstash ↗.

2. Vložte nějaká data do databáze Upstash. Data do databáze Upstash můžete přidat dvěma způsoby:

   • CLI můžete použít přímo z konzole Upstash.
   • Alternativně nainstalujte redis-cli ↗ lokálně a spusťte následující příkazy.

   set GB "Ey up?"

   OK

   set US "Yo, what’s up?"

   OK

   set NL "Hoi, hoe gaat het?"

   OK

3. Nakonfigurujte přihlašovací údaje Upstash Redis ve svém Workeru:

   Do Workeru musíte jako secrets přidat URL adresu databáze Upstash Redis a token. Získáte je ve svém Upstash Console ↗ pod údaji o databázi a poté je přidejte jako secrets pomocí Wrangler:

   # Add the Upstash Redis URL as a secret
   npx wrangler secret put UPSTASH_REDIS_REST_URL
   # When prompted, paste your Upstash Redis REST URL
   
   # Add the Upstash Redis token as a secret
   npx wrangler secret put UPSTASH_REDIS_REST_TOKEN
   # When prompted, paste your Upstash Redis REST token

4. Ve svém Workeru nainstalujte @upstash/redis, klienta HTTP pro připojení k databázi a začátek práce s daty:

   npmyarnpnpmbun

   npm i @upstash/redis

5. Následující příklad ukazuje, jak ve Workeru odeslat dotaz do databáze Upstash. Přihlašovací údaje potřebné pro připojení k Upstash byly do Workeru přidány jako secrets.

   import { Redis } from "@upstash/redis/cloudflare";
   
   export default {
   	async fetch(request, env) {
   		const redis = Redis.fromEnv(env);
   
   		const country = request.headers.get("cf-ipcountry");
   		if (country) {
   			const greeting = await redis.get(country);
   			if (greeting) {
   				return new Response(greeting);
   			}
   		}
   
   		return new Response("Hello What's up!");
   	},
   };

Další informace o Upstash naleznete v Dokumentace Upstash ↗.

Chcete-li nastavit integraci se službou Upstash QStash:

1. Nakonfigurujte veřejně dostupný HTTP endpoint ↗ kam chcete odesílat zprávy.

2. Nakonfigurujte přihlašovací údaje Upstash QStash ve svém Workeru:

   Do Workeru musíte jako secret přidat token Upstash QStash. Token získáte ve svém Upstash Console ↗ v nastavení QStash, poté ji přidejte jako secret pomocí Wrangler:

   # Add the QStash token as a secret
   npx wrangler secret put QSTASH_TOKEN
   # When prompted, paste your QStash token

3. Ve svém Workeru nainstalujte @upstash/qstash, klienta HTTP pro připojení ke koncovému bodu databáze QStash:

   npmyarnpnpmbun

   npm i @upstash/qstash

4. Viz Dokumentace Upstash o tom, jak přijímat webhooky z QStash ve vašem Cloudflare Workeru ↗.

* Redis je ochranná známka společnosti Redis Ltd. Veškerá práva s ní související jsou vyhrazena společnosti Redis Ltd. Použití ze strany Upstash slouží pouze pro referenční účely a neznamená žádné sponzorství, podporu ani propojení mezi společnostmi Redis a Upstash.