바이브 코딩 →

엣지 함수(Edge Function)Supabase Edge Function

엣지 함수(Edge Function)는 창고 안에 상주하는 작업자 같은 것 — Supabase 같은 서비스 안에서 내가 짠 코드를 대신 실행해 주는 작은 서버 프로그램으로, 별도 서버 없이 필요한 기능을 돌릴 수 있어요.

엣지 함수는 물건이 쌓인 창고 안에 상주하는 작업자와 비슷해요. 내가 직접 창고에 가지 않아도 "이 상자를 열어서 분류해 줘"라고 요청하면 그 자리에서 처리해 줘요. Supabase의 엣지 함수도 데이터베이스가 있는 쪽에서 내가 작성한 코드를 실행해 주기 때문에, 따로 서버를 빌리고 관리하지 않아도 API 호출이나 데이터 가공 같은 일을 맡길 수 있어요.

강의에서는 "나를 복제하는" AI 챗봇을 완성하는 단계에서 엣지 함수를 써요. 내 글과 자료를 AI가 검색할 수 있도록 숫자 벡터로 바꾸는 임베딩 작업을 Supabase 엣지 함수에서 돌리게 하고, 그때 필요한 외부 API 키는 Supabase 안의 비밀 값 저장소에 넣어 두게 해요. 이렇게 하면 API 키가 브라우저나 코드 저장소에 노출되지 않고, 새 자료가 들어올 때마다 서버 쪽에서 임베딩을 갱신할 수 있어요. 작성과 배포는 클로드 코드에게 "이 작업을 Supabase 엣지 함수로 만들어 배포해 줘"라고 요청하는 방식으로 진행해요.

"엣지 함수는 언제 쓰나요?"에 대한 답은 비밀 키가 필요한 외부 API 호출, 웹훅 받기, 데이터 가공처럼 브라우저에서 하면 안 되는 일을 서버에서 해야 할 때예요. 헷갈리기 쉬운 RPC 함수는 데이터베이스 안에서 SQL로 데이터를 처리하는 함수이고, 엣지 함수는 그 바깥에서 일반 코드를 실행한다는 차이가 있어요. 실행 시간과 사용량에는 제한이 있을 수 있으니 무거운 작업은 나눠서 처리하세요.

💡 대표 예시

  • 임베딩 처리 — 새 글이 들어오면 엣지 함수에서 임베딩을 만들어 저장한다
  • 키 보관 — 외부 API 키를 Supabase 비밀 값에 넣고 엣지 함수에서만 읽는다
  • 배포 요청 — 클로드 코드에게 작업을 엣지 함수로 만들어 배포해 달라고 한다
  • 웹훅 수신 — 결제 완료 알림을 엣지 함수로 받아 주문 상태를 바꾼다

🔗 관련 용어

임베딩

임베딩 (Embedding)은 글의 뜻을 지도 위 좌표로 찍어 주는 것 같은 것 — 문장이나 이미지의 의미를 숫자 목록(벡터)으로 바꿔, 뜻이 비슷한 것끼리 가깝게 놓이게 하는 기술이에요.

RPC 함수

RPC 함수(RPC Function)는 엑셀의 SUM처럼 미리 만들어 둔 계산 버튼 같은 것 — 데이터베이스 안에 저장해 두고 이름만 불러 실행하는 함수로, Supabase에서 복잡한 검색·계산을 한 번에 처리할 때 써요.

시크릿(비밀키)

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

서버

서버 (Server)는 24시간 문을 여는 가게 주방 같은 것 — 다른 컴퓨터의 요청을 받아 화면·데이터·작업 결과를 돌려주는, 꺼지지 않고 일하는 컴퓨터나 프로그램이에요.

수파베이스

수파베이스(Supabase)는 엑셀 표와 출입 명부를 한데 묶은 창고 같은 것 — 사이트의 회원·주문·상품 데이터를 저장하는 데이터베이스와 로그인 기능을 함께 제공하는 클라우드 백엔드 서비스예요.

웹훅

웹훅 (Webhook)은 초인종 같은 것 — 누군가 누를 때만 울리듯, 특정 사건이 일어났을 때 서비스가 자동으로 내 사이트에 신호를 보내 다음 동작을 실행시키는 방식.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.