在AnalyticDB Supabase中使用边缘函数

使用Dashboard部署

1. 登录Supabase Dashboard。

2. 在Dashboard侧边栏单击Edge Function>Functions。

3. 单击页面右上角的Deploy a new function，在下拉选项中选择Via Editor。

4. 在代码编辑器中编写代码。

   重要

   如需在Function中导入第三方依赖或调用公网API，需要为云原生数据仓库AnalyticDB PostgreSQL版Supabase项目开通公网访问。

   本文示例如下，包含 index.ts（入口文件）和 foo.ts。

   • index.ts文件如下：

     import { foo } from './foo.ts';
     console.info('server started');
     Deno.serve(async (req)=>{
       const { name } = await req.json();
       const data = {
         message: `Hello ${foo()} ${name}!`
       };
       return new Response(JSON.stringify(data), {
         headers: {
           'Content-Type': 'application/json',
           'Connection': 'keep-alive'
         }
       });
     });

   • foo.ts文件如下：

     export function foo() {
       return 'bar';
     }

5. 在右下角编辑Edge Function的名称，然后单击Deploy部署。

使用functions-cli工具部署

1. 获取并配置目标项目的SUPABASE_API_URL与SUPABASE_API_KEY。

   SUPABASE_API_KEY为service role key，配置信息获取请参见获取API Keys。可通过以下方式完成配置。

   • 环境变量：export SUPABASE_API_KEY=xxx

   • .env文件：SUPABASE_API_KEY=xxx

   • 命令行参数：-key xxx

   通过环境变量配置示例如下：

   export SUPABASE_API_URL=https://sbp-xxx.supabase.opentrust.net
   export SUPABASE_API_KEY=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJyb2xlIjoic2Vxxxx

2. 准备函数文件。

   本文函数目录结构如下，包含 index.ts（入口文件）和 foo.ts。

   supabase
   └── functions
       └── hello
           ├── foo.ts
           └── index.ts

   • index.ts文件如下：

     import { foo } from './foo.ts';
     console.info('server started');
     Deno.serve(async (req)=>{
       const { name } = await req.json();
       const data = {
         message: `Hello ${foo()} ${name}!`
       };
       return new Response(JSON.stringify(data), {
         headers: {
           'Content-Type': 'application/json',
           'Connection': 'keep-alive'
         }
       });
     });

   • foo.ts文件如下：

     export function foo() {
       return 'bar';
     }

3. 下载functions-cli工具。后续执行相关命令时，请将functions-cli替换为下载的cli工具名称。

   • functions-cli-darwin-arm64-2026-03-17

   • functions-cli-darwin-amd64-2026-03-17

   • functions-cli-windows-386-2026-03-17.exe

   • functions-cli-windows-amd64-2026-03-17.exe

   • functions-cli-linux-386-2026-03-17

   • functions-cli-linux-amd64-2026-03-17

   • functions-cli-linux-arm-2026-03-17

   • functions-cli-linux-arm64-2026-03-17

4. 执行部署。

   说明

   • 部署命令会在当前执行命令的目录下查找supabase/functions/路径，并寻找名为hello的函数目录。

   • 如果执行报错“At least one file is required”，请登录控制台，在目标Supabase项目所在行的操作列，选择更多 > 升级版本后重试。如果您的项目当前版本为v1.0.0，升级后会更新数据库连接串。

   ./functions-cli deploy hello

   如需要在部署 Edge Function 时关闭 JWT 校验，可添加--no-verify-jwt参数，示例：

   ./functions-cli deploy hello --no-verify-jwt

通过Dashboard测试

1. 单击Functions页面右上角的Test按钮。

2. 在面板中单击右下角的Send Request。

   请求发送成功后，响应状态码为 200，响应 Body 返回 {"message": "Hello bar Functions!"}。

使用curl命令测试

复制Details页签下的curl命令，并将其中的[YOUR ANON KEY]替换为anon key或service role key。

页面 Invoke function 区域提供 cURL、JavaScript、Swift、Flutter、Python 多语言调用示例，选择 cURL 选项卡即可查看待复制的命令。

返回示例如下：

curl -L -X POST 'https://sbp-5xxx.supabase.opentrust.net/functions/v1/bright-service' \
  -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJyb2xlIjoiYW5xxxxxxljA' \
  -H 'Content-Type: application/json' \
  --data '{"name":"Functions"}'
{"message":"Hello bar Functions!"}

从Supabase Cloud迁移至AnalyticDB Supabase

AnalyticDB Supabase项目间同步

通过Dashboard创建

1. 在Dashboard侧边栏单击Edge Function>Secrets。

2. 输入Key和Value。

   单击 Save 保存密钥配置。

3. 单击save完成添加。

通过functions-cli工具创建

1. 下载functions-cli工具。后续执行相关命令时，请将functions-cli替换为下载的cli工具名称。

   • functions-cli-darwin-arm64-2026-03-17

   • functions-cli-darwin-amd64-2026-03-17

   • functions-cli-windows-386-2026-03-17.exe

   • functions-cli-windows-amd64-2026-03-17.exe

   • functions-cli-linux-386-2026-03-17

   • functions-cli-linux-amd64-2026-03-17

   • functions-cli-linux-arm-2026-03-17

   • functions-cli-linux-arm64-2026-03-17

2. 执行创建命令。

   # 添加1个
   functions-cli secrets set DASHSCOPE_API_KEY=sk_test123456
   # 添加多个
   functions-cli secrets set DASHSCOPE_API_KEY=sk_test123456 OPENAI_API_KEY=test123456 
   # 从 .env 文件添加
   functions-cli secrets set --env-file supabase/functions/.env