Vercel KV

Vercel KV首页

Vercel KV文档

创建Vercel KV（redis）

点击getstart开始

点击 create database

选择KV

接受协议

起个名字

创建成功后，可以看到使用方法

开始使用

新建redis数据

点击cli，这里可以输入redis命令

尝试创建一个数据

// 创建
hset user:me email email@me.com id 123
// 查看
hgetall user:me

创建一个next应用

https://www.nextjs.cn/docs/getting-started

npx create-next-app@latest --typescript

安装@vercel/kv pnpm i @vercel/kv

全局安装vercel pnpm i -g vercel@latest

执行vercel link

选择connect with github

KV连接项目

然后在连接项目

选择你刚刚link的项目名

这样执行命令 vercel env pull .env.development.local 后

会在项目根目录生成.env.development.local文件

文件内容就会包含value值

如果没connect执行命令，文件里面value都是空的

当接口使用

pages/api/user.ts

import { kv } from '@vercel/kv';
import { NextApiRequest, NextApiResponse } from 'next';
 
export default async function handler(
  request: NextApiRequest,
  response: NextApiResponse,
) {
  const user = await kv.hgetall('user:me');
  return response.status(200).json(user);
}

访问你的开发地址拼上/api/user即可看到效果

api

hgetall

获取指定键的所有字段和对应值的方法

kv.hgetall('user:me')

incr

kv.incr 方法只能用于存储整数值，

并且在递增之前必须确保键的值为整数。

如果键不存在，则会将其初始值设置为 0。如果键的值不是整数，则会引发错误。

kv.incr() // increment a key value

set

https://vercel.com/docs/storage/vercel-kv/kv-reference#set

import { kv } from '@vercel/kv';
 
async function exampleCommands() {
  try {
    await kv.set('setExample', '123abc', { ex: 100, nx: true });
  } catch (error) {
    // Handle errors
  }
}

get

import { kv } from '@vercel/kv';
 
async function exampleCommands() {
  try {
    const getExample = await kv.get('getExample');
    console.log(getExample);
  } catch (error) {
    // Handle errors
  }
}

createClient

连接新的KV stores

import { createClient } from '@vercel/kv';
const users = createClient({
    url: process.env.USERS_REST_API_URL,
    token: process.env.USERS_REST_API_TOKEN,
});
const user = await users.hgetall('user:me');

补充

绑定github

vercel项目连接GitHub项目地址

由于之前vercel link之后，vercel项目里会出现个新的项目

但这个项目并没有github绑定

点击connect git respository

选择github

选择你github上对应的地址（之前新建的next项目需要放到github上）

提示成功即可

设置响应头

export default async function handler(
  req: NextApiRequest,
  res: NextApiResponse
) {
  res.setHeader(
    "cache-control",
    "max-age=0, no-cache, no-store, must-revalidate"
  );
  res.setHeader("content-type", "text/plain;charset=utf-8");
  const { name = "test", count = "1234567" } = req.query;
  try {
    res.send(`name: ${name} count: ${count} Date :${new Date()}`);
  } catch (error: any) {
    res.send(error.message);
  }
}