커스텀 DB 시작하기
커스텀 DB란?
커스텀 DB(Custom Database)는 자신의 비즈니스 모델에 맞춰 직접 데이터베이스를 설계하고 데이터를 수집·관리할 수 있는 맞춤형 데이터베이스 기능입니다. 정해진 틀에 구애받지 않고 필요한 데이터 형태를 자유롭게 정의하며 유연하게 확장할 수 있습니다.
엑셀로 쉽게 이해하는 커스텀 DB
커스텀 DB | 엑셀 | 설명 |
컬렉션 | 테이블 (시트) | 연관된 데이터들의 집합체 (예: 매장/지점 목록 — 지점명, 주소, 연락처, 영업시간 등) |
필드 | 열 (Column) | 데이터의 항목 및 속성 (예: 이름, 이메일, 전화번호 등) |
리소스 | 행 (Row) | 실제로 저장된 개별 데이터 1건 (예: ‘강남점’의 상세 데이터) |
커스텀 DB(데이터베이스) 만들기
컬렉션 추가하기
컬렉션 설정
•
컬렉션 ID
◦
API에서 컬렉션을 구분하는 고윳값으로, 저장 후 수정할 수 없습니다.
◦
영문 소문자와 하이픈(-)만 입력해야 합니다.
◦
예시: 매장/지점 목록 → stores 또는 storelist
•
컬렉션 이름
◦
컬렉션 목록에서 해당 컬렉션을 확인할 수 있는 이름입니다.
◦
예시: 매장/지점 목록
컬렉션 설명
•
해당 컬렉션이 어떤 데이터를 다루는지에 대한 간단한 메모입니다.
•
예시: 전국 오프라인 매장 위치 및 영업시간 관리용 DB
알림 설정
•
방문자가 웹사이트에서 리소스를 생성하거나 수정하면 알림을 받을 수 있으며, 컬렉션마다 수신 여부를 각각 설정할 수 있습니다.
필드 구성하기
데이터 타입 살펴보기
수집하고자 하는 데이터의 성격에 맞춰 적절한 데이터 타입을 선택해 주세요.
•
단문형 텍스트
◦
한 줄 정도의 짧은 문자열을 입력합니다.
•
장문형 텍스트
◦
단순 줄글 형태로 긴 본문 텍스트를 입력합니다.
•
텍스트 에디터
◦
굵게, 글자 색상, 서식 등 스타일을 적용할 수 있는 에디터를 제공합니다.
•
숫자
◦
정수 형태의 숫자 데이터를 입력합니다.
◦
소수점은 입력할 수 없습니다.
•
날짜·시간
◦
날짜와 시간을 선택·입력합니다.
•
스위치
◦
ON/OFF 형태의 스위치 버튼으로 값을 선택합니다.
•
선택 박스
◦
드롭다운 메뉴 형태로 미리 지정한 옵션 중 하나를 선택합니다.
•
리스트
◦
여러 개의 하위 필드를 한 세트로 묶어 반복해서 수집·관리합니다.
◦
리스트 안에 들어갈 하위 필드의 데이터 타입(단문형 텍스트, 장문형 텍스트, 숫자, 날짜·시간, 스위치, 선택 박스)을 선택해 추가할 수 있습니다.
◦
하위 필드는 최대 20개까지 추가할 수 있습니다.
◦
예시: 매장 영업시간을 요일·오픈 시간·마감 시간 세트로 여러 개 등록할 때 사용
•
파일 첨부
◦
이미지, 문서 등의 파일을 등록 및 업로드합니다.
◦
필드를 만들 때 공개 또는 비공개를 선택하며, 생성 후에는 변경할 수 없습니다.
▪
공개는 파일 주소로 누구나 접근할 수 있고, 비공개는 일회용 주소로만 열람할 수 있습니다.
◦
비회원이 첨부한 파일은 공개·비공개 여부와 관계없이 14일간만 유효하며, 기간이 지나면 다운로드할 수 없습니다. 회원이 첨부한 파일에는 이 제한이 없습니다.
◦
장기 보관이 필요한 파일은 회원 권한으로 받는 것을 권장합니다.
•
휴대폰 번호
◦
준비 중입니다.
필드 설정하기
•
필드 ID
◦
API에서 필드를 구분하는 고윳값으로, 저장 후 수정할 수 없습니다.
◦
필드 ID는 영문 대소문자, 숫자, 밑줄(_)만 입력할 수 있으며 숫자로 시작할 수 없습니다.
◦
id, createdAt, updatedAt, customer는 필드 ID로 사용할 수 없습니다.
•
필드 이름
◦
해당 필드를 알아보기 쉽게 표시하는 이름입니다.
•
필수 여부
◦
선택: 리소스를 추가할 때 해당 필드를 입력하지 않아도 됩니다.
◦
필수: 리소스를 추가할 때 해당 필드를 반드시 입력해야 합니다.
•
기본 값 설정
◦
리소스를 추가할 때 값을 입력하지 않으면 설정한 기본 값이 등록됩니다.
권한 설정하기
[식스샵 프로 > 커스텀 DB]에서 컬렉션을 선택한 뒤 권한 항목에서 설정합니다. 회원과 비회원 각각의 스위치를 켜고 허용할 동작을 선택한 다음, 오른쪽 상단의 저장을 클릭합니다.
스위치를 끄면 체크해 둔 권한도 적용되지 않으며, 해당 방문자 유형은 이 컬렉션의 데이터에 접근할 수 없습니다.
컬렉션에 필드를 추가하면 비회원 권한이 켜진 상태로 단건 조회·목록 조회·개수 조회가 허용되어 있습니다. 개인정보를 수집하는 컬렉션은 저장하기 전에 비회원 권한을 반드시 확인하세요. 조회를 허용한 필드의 값은 모든 방문자에게 공개됩니다.회원이 본인이 등록한 리소스만 보도록 하려면 비회원의 조회 권한(단건 조회·목록 조회·개수 조회)을 해제하세요. 비회원 조회를 허용하면 회원도 모든 리소스를 볼 수 있습니다.
회원
회원 권한은 로그인한 회원이 본인이 등록한 리소스에만 적용되며, 다른 회원이 등록한 리소스는 조회·수정·삭제할 수 없습니다. 이 범위는 변경할 수 없습니다.
다른 회원의 글까지 보여주려면 회원 권한이 아니라 비회원 권한의 조회를 허용하세요.
•
단건 조회
◦
본인이 등록한 리소스의 상세 정보를 조회할 수 있습니다.
◦
예시: 회원이 본인이 접수한 신청 내역 상세 정보를 확인할 때 설정
•
목록 조회
◦
본인이 등록한 리소스의 목록을 볼 수 있습니다.
◦
예시: 마이페이지에서 내가 접수한 신청 내역을 나열해서 보여줘야 할 때 설정
•
개수 조회
◦
본인이 등록한 리소스의 개수를 확인할 수 있습니다.
◦
예시: "내가 접수한 신청 3건"과 같이 숫자로 표현해 보여줘야 할 때 설정
◦
페이지 번호, 글 번호 매기기, '총 N건' 표시처럼 전체 개수가 필요한 기능에 사용합니다. 목록만 보여준다면 허용하지 않아도 됩니다.
•
생성
◦
방문자(회원)가 웹사이트에서 새 리소스를 직접 등록할 수 있습니다.
◦
회원 권한으로 등록한 리소스는 작성자가 회원으로 기록되어, 이후 본인이 조회·수정·삭제할 수 있습니다.
◦
예시: 문의 접수, 이벤트 응모, 신청서 작성처럼 방문자가 직접 입력하는 기능을 만들 때 설정
•
수정
◦
회원이 직접 등록한 리소스의 내용을 수정할 수 있습니다.
•
삭제
◦
회원이 직접 등록한 리소스를 삭제할 수 있습니다.
로그인한 회원이 본인이 등록한 글을 다시 조회·수정·삭제하게 하려면, 회원 권한의 생성을 허용하고 글 등록 폼이 회원 권한으로 등록하도록 블록을 만들어야 합니다.
비회원
비회원 권한은 로그인하지 않은 방문자뿐 아니라 로그인한 회원을 포함한 모든 방문자에게 적용됩니다. 회원 권한을 모두 해제해도 비회원 권한이 켜져 있으면 회원도 조회와 등록을 할 수 있습니다.
•
단건 조회
◦
로그인 여부와 관계없이 모든 방문자가 리소스의 상세 정보를 조회할 수 있습니다.
◦
예시: 매장 상세 정보나 공지사항 상세 내용을 모든 방문자에게 보여줘야 할 때 설정
•
목록 조회
◦
로그인 여부와 관계없이 모든 방문자가 리소스 목록을 볼 수 있습니다.
◦
예시: 웹사이트에 후기나 공지사항을 나열해서 보여줘야 할 때 설정
•
개수 조회
◦
로그인 여부와 관계없이 모든 방문자가 리소스의 개수를 확인할 수 있습니다.
◦
예시: "지금까지 접수된 신청 128건"과 같이 전체 개수를 보여줘야 할 때 설정
◦
페이지 번호, 글 번호 매기기, '총 N건' 표시처럼 전체 개수가 필요한 기능에 사용합니다. 목록만 보여준다면 허용하지 않아도 됩니다.
•
생성
◦
로그인 여부와 관계없이 모든 방문자가 웹사이트에서 새 리소스를 직접 등록할 수 있습니다.
◦
비회원 권한으로 등록한 글은 로그인한 회원이 작성하더라도 작성자가 '비회원'으로 기록되어, 회원 권한의 조회·수정·삭제 대상이 되지 않습니다.
◦
파일 첨부 필드가 있는 경우, 비회원이 첨부한 파일은 14일간만 유효합니다.
◦
예시: 로그인 없이 문의나 이벤트 응모를 받을 때 설정
필드별 권한 설정
리소스 권한에서 허용한 동작에 한해, 필드마다 아래 권한을 따로 설정할 수 있습니다. 허용하지 않은 동작의 필드 권한은 회색으로 표시되어 설정할 수 없습니다.
•
조회: 방문자에게 해당 필드의 값을 보여줄지 설정합니다. 단건 조회 또는 목록 조회를 허용한 경우에 설정할 수 있습니다.
•
입력: 방문자가 리소스를 등록할 때 해당 필드를 입력할 수 있는지 설정합니다. 생성을 허용한 경우에 설정할 수 있습니다.
•
수정: 회원이 본인이 등록한 리소스의 해당 필드를 수정할 수 있는지 설정합니다. 수정을 허용한 경우에 설정할 수 있으며, 회원 권한에만 있습니다.
•
삭제는 필드별 설정이 없습니다.
•
예시: 문의·신청 접수 폼에서 이름·연락처·이메일은 입력만 허용하고 조회는 허용하지 않아, 다른 방문자가 개인정보를 볼 수 없게 할 때 설정
권한 선택 가이드
만들려는 기능 | 필요한 권한 |
모든 방문자에게 보여주는 게시판 (다른 회원의 글 포함) | 비회원: 목록 조회, 단건 조회 |
페이지 번호나 '총 N건'을 표시 | 위 권한에 개수 조회 추가 |
로그인 없이 쓰는 문의·방명록·신청서 폼 | 비회원: 생성 |
로그인한 회원이 쓰는 폼 (작성자가 회원으로 기록) | 회원: 생성 |
내가 쓴 글 목록 | 회원: 목록 조회 |
내 글 수정·삭제 | 회원: 단건 조회, 수정, 삭제 |
생년월일 등 입력만 받고 노출은 막기 | 필드별 권한: 입력 허용, 조회 해제 |
API 정보 활용하기
컬렉션 구성과 권한 설정을 마쳤다면, 웹사이트에 데이터를 수집하거나 보여주는 블록을 추가합니다.
API 정보 복사하기
1.
[식스샵 프로 > 커스텀 DB]에서 컬렉션을 선택한 뒤, 오른쪽 상단의 API 정보를 클릭합니다.
2.
복사 버튼을 클릭합니다.
3.
상단의 에디터 바로가기를 클릭하면 디자인 에디터로 이동합니다.
API 정보에는 현재 허용된 동작만 포함됩니다. 권한을 변경한 뒤에는 API 정보를 다시 복사해 블록을 새로 만들어 주세요. 허용되지 않은 동작을 사용하는 블록은 정상적으로 동작하지 않습니다.
데이터 수집용 블록 만들기
1.
디자인 에디터로 이동합니다. API 정보 화면에서 에디터 바로가기를 클릭하거나, [식스샵 프로 > 웹사이트 - 디자인]에서 템플릿 우측 디자인 편집하기를 클릭합니다.
2.
블록을 추가할 페이지로 이동합니다.
3.
섹션 메뉴로 이동하고, 섹션 추가 아이콘(+)을 클릭한 뒤 AI 블록 생성에 복사한 API를 붙여넣습니다.
4.
프롬프트를 추가로 입력하고 블록을 생성합니다.
•
예시: "문의 접수 폼 블록을 만들어줘"
데이터 관리하기
데이터(리소스) 등록하기
컬렉션과 필드 구성을 마쳤다면, 이제 컬렉션에 실제 데이터(리소스)를 등록할 수 있습니다. 등록할 데이터의 수량에 따라 단건 등록 또는 엑셀 일괄 등록 방식을 선택해 진행합니다.
[식스샵 프로 > 커스텀 DB]에서 데이터를 추가할 컬렉션을 선택한 뒤, 우측 상단의 버튼을 통해 등록을 진행합니다.
•
엑셀로 리소스 추가 (다건 일괄 등록)
◦
등록할 데이터가 여러 건인 경우 엑셀로 리소스 추가를 클릭하여 엑셀 템플릿 양식을 다운로드하고, 데이터를 일괄 작성한 뒤 업로드합니다.
•
리소스 추가하기 (단건 등록)
◦
등록할 데이터가 1건인 경우 리소스 추가하기를 클릭하여 데이터를 등록합니다.
데이터 필터링 및 정렬
•
[식스샵 프로 > 커스텀 DB]에서 컬렉션 상세의 필터, 정렬 설정을 통해 선택한 필드를 오름차순·내림차순으로 정렬하거나 필터링할 수 있습니다.
•
필터와 정렬에 사용할 수 있는 필드는 각각 최대 3개이며, 장문형 텍스트·텍스트 에디터·파일 첨부·리스트는 사용할 수 없습니다.
앱(기능)으로 돌아가기
식스샵 프로 가이드로 돌아가기