コンテンツにスキップ

Upstash

Upstash は、Redis* と Kafka API を備えたサーバーレスデータベースです。Upstash は、サーバーレス向けに設計されたタスクキュー/スケジューラーである QStash も提供しています。

Database Integrations allow you to connect to a database from your Worker by getting the right configuration from your database provider and adding it as secrets to your Worker.

Upstash for Redis

Upstash との統合を設定するには:

  1. 接続する既存の Upstash データベースが必要です。Upstash データベースを作成するか、既存のデータベースから Upstash にデータをロードするを行ってください。

  2. Upstash データベースにデータを挿入します。次の2つの方法で Upstash データベースにデータを追加できます:

    • Upstash コンソールから CLI を直接使用します。
    • あるいは、redis-cli をローカルにインストールし、次のコマンドを実行します。
    Terminal window
    set GB "Ey up?"
    OK
    Terminal window
    set US "Yo, what’s up?"
    OK
    Terminal window
    set NL "Hoi, hoe gaat het?"
    OK
  3. Worker に Upstash Redis 統合を追加します:

    1. Cloudflare ダッシュボード にログインし、アカウントを選択します。
    2. アカウントホームで、Workers & Pages を選択します。
    3. 概要で、Worker を選択します。
    4. 設定 > 統合 > Upstash Redis を選択します。
    5. ステップ1で作成したデータベースを選択し、セットアップフローに従います。
  4. Worker で、データベースに接続しデータを操作するための HTTP クライアント @upstash/redis をインストールします:

    Terminal window
    npm install @upstash/redis
  5. 次の例は、Worker で Upstash データベースにクエリを行う方法を示しています。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!");
},
};

Upstash について詳しく知るには、Upstash ドキュメントを参照してください。

Upstash Kafka

Upstash Kafka との統合を設定するには:

  1. Kafka クラスターとトピックを作成する

  2. Worker に Upstash Kafka 統合を追加します:

    1. Cloudflare ダッシュボード にログインし、アカウントを選択します。
    2. アカウントホームで、Workers & Pages を選択します。
    3. 概要で、Worker を選択します。
    4. 設定 > 統合 > Upstash Kafka を選択します。
    5. クラスターとトピックを選択し、セットアップフローに従います。
  3. Worker で、HTTP/REST ベースの Kafka クライアント @upstash/kafka をインストールします:

    Terminal window
    npm install @upstash/kafka
  4. upstash-kafka JavaScript SDK を使用して、Kafka にデータを送信します。

Worker での Kafka セットアップに関する詳細は、Upstash ドキュメントを参照してください。urlusernamepassword は統合によって設定された変数に置き換えてください。

Upstash QStash

Upstash QStash との統合を設定するには:

  1. メッセージを送信したい公開可能な HTTP エンドポイントを構成します。

  2. Worker に Upstash QStash 統合を追加します:

    1. Cloudflare ダッシュボード にログインし、アカウントを選択します。
    2. アカウントホームで、Workers & Pages を選択します。
    3. 概要で、Worker を選択します。
    4. 統合 > Upstash QStash を選択します。
    5. セットアップフローに従います。
  3. Worker で、データベース QStash エンドポイントに接続するための HTTP クライアント @upstash/qstash をインストールします:

    Terminal window
    npm install @upstash/qstash
  4. Cloudflare Worker で QStash からの Webhook を受信する方法に関する Upstash ドキュメントを参照してください。

* Redis は Redis Ltd. の商標です。その権利は Redis Ltd. に帰属します。Upstash による使用は参照目的のみであり、Redis と Upstash の間のスポンサーシップ、承認、または提携を示すものではありません。