엣지 함수(Edge Function)는 창고 안에 상주하는 작업자 같은 것 — Supabase 같은 서비스 안에서 내가 짠 코드를 대신 실행해 주는 작은 서버 프로그램으로, 별도 서버 없이 필요한 기능을 돌릴 수 있어요.
엣지 함수는 물건이 쌓인 창고 안에 상주하는 작업자와 비슷해요. 내가 직접 창고에 가지 않아도 "이 상자를 열어서 분류해 줘"라고 요청하면 그 자리에서 처리해 줘요. Supabase의 엣지 함수도 데이터베이스가 있는 쪽에서 내가 작성한 코드를 실행해 주기 때문에, 따로 서버를 빌리고 관리하지 않아도 API 호출이나 데이터 가공 같은 일을 맡길 수 있어요.
강의에서는 "나를 복제하는" AI 챗봇을 완성하는 단계에서 엣지 함수를 써요. 내 글과 자료를 AI가 검색할 수 있도록 숫자 벡터로 바꾸는 임베딩 작업을 Supabase 엣지 함수에서 돌리게 하고, 그때 필요한 외부 API 키는 Supabase 안의 비밀 값 저장소에 넣어 두게 해요. 이렇게 하면 API 키가 브라우저나 코드 저장소에 노출되지 않고, 새 자료가 들어올 때마다 서버 쪽에서 임베딩을 갱신할 수 있어요. 작성과 배포는 클로드 코드에게 "이 작업을 Supabase 엣지 함수로 만들어 배포해 줘"라고 요청하는 방식으로 진행해요.
"엣지 함수는 언제 쓰나요?"에 대한 답은 비밀 키가 필요한 외부 API 호출, 웹훅 받기, 데이터 가공처럼 브라우저에서 하면 안 되는 일을 서버에서 해야 할 때예요. 헷갈리기 쉬운 RPC 함수는 데이터베이스 안에서 SQL로 데이터를 처리하는 함수이고, 엣지 함수는 그 바깥에서 일반 코드를 실행한다는 차이가 있어요. 실행 시간과 사용량에는 제한이 있을 수 있으니 무거운 작업은 나눠서 처리하세요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.