바이브코딩 기초지식 정리
서비스 개발에 자주 나오는 용어를 캠핑 용품 검색 흐름으로 설명합니다. 데이터베이스와 테이블에 상품을 저장하고 SQL·색인·임베딩으로 검색하는 과정까지 연결해 정리했어요.
데이터베이스
서비스 데이터를 저장하고 조회·수정·삭제하는 프로그램
캠핑 검색 데이터 상품 ID, 상품명, 설명을 저장합니다
데이터 작업 상품 추가, 설명 수정, 판매가 끝난 상품 삭제를 처리해요
테이블과 SQL 테이블은 저장 형태를 정하고 SQL은 저장·조회 작업을 전달합니다
테이블
행과 열로 같은 형식의 데이터를 정리하는 단위
행
camping_products테이블의 행 하나가 상품 하나를 나타냅니다열
id,name,description이 모든 상품에 공통으로 저장할 항목을 정해요데이터 규칙
id로 상품을 구분하고 열마다 데이터 형식과 필수 여부를 지정합니다
SQL
데이터베이스에 필요한 작업을 요청하는 언어
조회 예시
SELECT name, description FROM camping_products LIMIT 5는 상품 다섯 개의 이름과 설명을 조회합니다조건과 순서
WHERE는 조회 조건,ORDER BY는 표시 순서,LIMIT은 반환할 상품 수를 정해요실행 전 확인 클로드나 코덱스가 SQL을 작성해도 수정·삭제 대상과 조건을 먼저 확인합니다
색인
검색할 내용과 데이터 위치를 연결하는 자료
검색 범위 색인에서 검색어와 관련된 후보를 먼저 찾아 모든 상품을 차례로 검사하는 작업을 줄여요
색인 종류 단어 검색은
search_text의 GIN 색인을, 의미 검색은embedding의 HNSW 색인을 사용합니다데이터 변경 상품을 추가하거나 수정하면 색인도 갱신되며 저장 공간과 적재 시간을 사용해요
임베딩
텍스트의 의미를 표현한 같은 길이의 숫자 배열
텍스트 변환 임베딩 모델이 문장과 상품 설명을 벡터로 변환합니다
의미 비교
겨울 야영용 따뜻한 이불과동계용 침낭처럼 용도가 가까운 표현은 벡터 거리도 가까워져요비교 조건 검색어와 상품 설명에 같은 모델·차원 수·변환 설정을 적용하고, 설명을 수정하면 임베딩도 다시 생성합니다
단어 검색과 의미 검색
검색어의 글자와 의미를 비교하는 방법
단어 검색 상품명과 설명에서
침낭처럼 검색어와 일치하는 표현을 찾습니다의미 검색
추운 밤에 잘 때 필요한 장비처럼 용도를 설명해도 임베딩이 가까운 상품을 찾아요하이브리드 검색 단어 검색 점수와 의미 검색 점수를 같은 기준의 최종 점수로 변환한 뒤 관련성 높은 결과부터 정렬합니다
로컬 프로젝트
현재 컴퓨터에서 개발하고 실행하는 작업 공간
프로젝트 파일 소스 코드, 설정 파일, 이미지를 현재 컴퓨터에서 관리합니다
데이터베이스 선택 정적 소개 페이지는 데이터베이스 없이 실행할 수 있고, 데이터 저장이 필요하면 파일·SQLite·PostgreSQL 등을 선택해요
배포 환경 배포한 웹 앱은 개발자 컴퓨터에 직접 연결할 수 없어 필요한 파일과 서비스를 별도로 준비합니다
클라우드 프로젝트
인터넷에 연결된 원격 환경에서 실행하는 프로젝트
실행 위치 코드와 설정을 원격 실행 환경에 배포해 사용자가 인터넷으로 접근할 수 있게 합니다
프로젝트 형태 웹 앱, API, 자동화 작업으로 운영하며 데이터 저장 기능이 없는 프로젝트도 있어요
데이터 저장 필요하면 원격 데이터베이스·파일 저장소·외부 API를 선택하고 실행 시간과 접근 범위는 호스팅에서 관리합니다
백업
특정 시점의 데이터를 보관하는 복원용 사본
백업 대상 소스 코드, 설정 파일, 업로드 파일, 데이터베이스 데이터 등 복원에 필요한 자료를 보관합니다
생성 시점 많은 데이터를 수정하거나 삭제하기 전에 백업해 작업 전 상태로 복원할 수 있게 해요
보관과 복원 원본과 다른 저장 위치에 백업하고 실제 복원 절차로 필요한 자료가 정상적으로 복구되는지 확인합니다