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

Upstash

Upstash ↗ представляет собой serverless-базу данных с API, совместимым с Redis* и Kafka. Upstash также предлагает QStash, очередь задач и планировщик для serverless-приложений.

Upstash for Redis

Чтобы настроить интеграцию с Upstash:

Для подключения понадобится уже существующая база данных Upstash. Создайте базу данных Upstash ↗ или загрузить данные из существующей базы данных в Upstash ↗.
Добавьте немного данных в базу данных Upstash. Сделать это можно двумя способами:
- Используйте CLI непосредственно из консоли Upstash.
- Также можно установить redis-cli ↗ локально и выполните следующие команды.
```
set GB "Ey up?"
```
```
OK
```
```
set US "Yo, what’s up?"
```
```
OK
```
```
set NL "Hoi, hoe gaat het?"
```
```
OK
```
Настройте учётные данные Upstash Redis в вашем Worker:

Добавьте URL базы данных Upstash Redis и токен в качестве секретов вашего Worker. Получить их можно в Upstash Console ↗ в реквизитах вашей базы данных, а затем добавьте их как секреты с помощью 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
```
В Worker установите @upstash/redis, HTTP клиент для подключения к базе данных и начала работы с данными:
npm i @upstash/redis
Следующий пример показывает, как выполнить запрос к базе данных Upstash из Worker. Учётные данные для подключения к Upstash добавлены в Worker в качестве секретов.
```
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!");
	},
};
```
Примечание
Примечание
Redis.fromEnv(env) автоматически подхватывает значение по умолчанию url и token имена, созданные в интеграции.
Если вы переименовали секреты, их нужно объявить явно, как показано в Базовый пример Upstash ↗.

Подробнее об Upstash см. в Документация Upstash ↗.

Upstash QStash

Чтобы настроить интеграцию с Upstash QStash:

Настройте общедоступный HTTP-эндпоинт ↗ на который вы хотите отправлять сообщения.
Настройте учётные данные Upstash QStash в вашем Worker:

Добавьте токен Upstash QStash в качестве секрета вашего Worker. Получить токен можно в Upstash Console ↗ в настройках QStash, затем добавьте его как секрет с помощью Wrangler:
```
# Add the QStash token as a secret
npx wrangler secret put QSTASH_TOKEN
# When prompted, paste your QStash token
```
В Worker установите @upstash/qstash, HTTP клиент для подключения к конечной точке QStash вашей базы данных:
npm i @upstash/qstash
См. Документация Upstash о том, как получать вебхуки от QStash в вашем Cloudflare Worker ↗.

* Redis является товарным знаком компании Redis Ltd. Все права на него сохраняются за Redis Ltd. Использование этого знака компанией Upstash приведено исключительно в справочных целях и не означает какого-либо спонсорства, одобрения или аффилированности между Redis и Upstash.